{"uid":"cap_WBqgNIC_riYWGrCPXJc7w","slug":"x402-audit-agentdiet-dev-article-extractor-with-bm25-budget-control-111e51d5","name":"Article Extractor with BM25 Budget Control","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://x402-audit.agentdiet.dev/v1/article-extractor)","url":"https://x402-audit.agentdiet.dev/v1/article-extractor?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","minLength":1,"description":"Target webpage URL to fetch and distill (or builtin://stripe-docs)"},"html":{"type":"string","description":"Optional raw HTML string to distill directly without fetching"},"mode":{"enum":["markdown","structured","skeleton","budget"],"type":"string","default":"markdown","description":"Distillation mode"},"query":{"type":"string","description":"BM25 focus query when mode=budget"},"max_tokens":{"type":"integer","minimum":20,"description":"Strict token budget ceiling when mode=budget"}}},"responseSchema":{"type":"object","required":["status","roi_proof","data"],"properties":{"data":{"type":"object","description":"Distilled Markdown, structured JSON tables/metadata, skeleton outline, or BM25 budget excerpt."},"cache":{"type":"object","properties":{"status":{"enum":["HIT","MISS"],"type":"string"},"cache_key":{"type":"string"},"latency_ms":{"type":"number"}}},"status":{"type":"string","description":"Execution status ('ok')"},"billing":{"type":"object","properties":{"agent_id":{"type":"string"},"payment_method":{"type":"string"},"fee_charged_usd":{"type":"number"}}},"roi_proof":{"type":"object","properties":{"raw_tokens":{"type":"integer"},"tokens_saved":{"type":"integer"},"roi_multiplier":{"type":"number"},"distilled_tokens":{"type":"integer"},"llm_cost_saved_usd":{"type":"number"},"compression_ratio_pct":{"type":"number"}}}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.001","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pWe22UXkDuXqhZZZO8zYf","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"x402-audit.agentdiet.dev","brandSlug":"x402-audit-agentdiet-dev-mpp","brandBaseUrl":"https://x402-audit.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into compact, agent-ready content using configurable modes including BM25-ranked token-budgeted excerpts","exampleAgentPrompt":"Fetch the article at https://example.com/blog/ai-trends and distill it into markdown, keeping it under 500 tokens and focusing on the topic of 'large language model efficiency'.","exampleUseCases":[{"title":"Token-budgeted research page summarization","prompt":"Pull the content from https://arxiv.org/abs/2401.12345 and give me only the parts most relevant to 'retrieval augmented generation', keeping it under 300 tokens."},{"title":"Structured data extraction from a product page","prompt":"Extract the structured tables and metadata from https://stripe.com/pricing into clean JSON so I can compare the plan tiers without reading the whole page."},{"title":"Skeleton outline of a long article","prompt":"Grab https://www.wired.com/story/ai-regulation-2024 and return just a skeleton outline of the article's sections so I can decide which parts are worth reading in full."}],"resultDescription":"Returns a JSON object with distilled content (markdown text, structured JSON tables/metadata, a section skeleton, or a BM25-ranked token-capped excerpt depending on mode), plus an ROI proof block showing raw vs distilled token counts, compression ratio, tokens saved, and estimated LLM cost saved in USD. Also includes cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns a non-200 status — fetch error returned","HTML payload is malformed or empty — distillation yields empty result","mode=budget used without a query field — BM25 ranking cannot proceed","max_tokens set below 20 — rejected by schema validation","Payment not included or insufficient — HTTP 402 response blocking execution","Target URL is paywalled or requires authentication — content unavailable"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read web content but must stay within a token budget or minimize LLM inference costs. It is especially valuable when the full page HTML is noisy with boilerplate and ads, when only the most query-relevant passage is needed (mode=budget with BM25), or when structured tables and metadata need to be extracted from a page. Prefer over raw HTTP fetching or generic scrapers when token efficiency and cost tracking matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:37:32.742Z","isFirstParty":false,"canonicalSlug":"x402-audit-agentdiet-dev-article-extractor-with-bm25-budget-control-111e51d5"}