{"uid":"cap_X-MrJSkv07VKJPXdZNtns","slug":"sec-intel-agentdiet-dev-web-article-distiller-with-bm25-budget-control-37dbb5e0","name":"Web Article Distiller 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://sec-intel.agentdiet.dev/v1/article-extractor)","url":"https://sec-intel.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_NvbJ9YwVgyXS20sIhUepv","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"sec-intel.agentdiet.dev","brandSlug":"sec-intel-agentdiet-dev-mpp","brandBaseUrl":"https://sec-intel.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or accepts raw HTML and distills it into Markdown, structured JSON, skeleton outline, or a BM25-ranked token-budget excerpt","exampleAgentPrompt":"Fetch the article at https://www.reuters.com/technology/ai-news-2025 and distill it into markdown, keeping it under 800 tokens focused on the topic 'AI regulation' using budget mode.","exampleUseCases":[{"title":"Token-budget research digest for LLM pipeline","prompt":"Take this URL https://arxiv.org/abs/2401.00001 and distill it in budget mode with a max of 500 tokens, focused on the query 'transformer architecture improvements' — I need just the most relevant bits."},{"title":"Clean article extraction for newsletter bot","prompt":"Fetch the article at https://www.theverge.com/2025/5/ai-story and convert it to clean markdown so I can pass it to my newsletter summarizer."},{"title":"Structured data extraction from product page","prompt":"Here's the raw HTML from a Shopify product page — can you distill it in structured mode to pull out the product name, price, variants, and description as JSON?"}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown string, structured JSON, skeleton outline, or BM25-ranked excerpt depending on mode), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd. Also includes optional cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns non-200 HTTP status — endpoint may return an error status","HTML payload is empty or malformed — distillation may return empty or degraded output","max_tokens set below meaningful threshold (minimum 20) — schema validation error","BM25 query missing when mode=budget — query field required for budget mode ranking","Payment fails via x402 micropayment protocol — request blocked before processing","Rate limit or timeout on remote URL fetch — latency-sensitive pages may fail"],"whenToPreferThis":"Choose this endpoint when you need to feed web content to an LLM but want to minimize token consumption and cost. It is especially valuable in agentic pipelines where many URLs must be processed cheaply, or when you need BM25-ranked relevance filtering to extract only the content most pertinent to a specific query within a strict token ceiling. Prefer it over raw fetch+parse when compression ratio and ROI tracking matter, or when you need structured JSON/skeleton modes rather than raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:30:12.402Z","isFirstParty":false,"canonicalSlug":"sec-intel-agentdiet-dev-web-article-distiller-with-bm25-budget-control-37dbb5e0"}