{"uid":"cap_QYKSOqryPdHfL5vaerD9_","slug":"whale-momentum-agentdiet-dev-article-extractor-with-bm25-budget-control-d22b28ee","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://whale-momentum.agentdiet.dev/v1/article-extractor)","url":"https://whale-momentum.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_EWpYvR98jzw_5jdPy7HG3","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"whale-momentum.agentdiet.dev","brandSlug":"whale-momentum-agentdiet-dev-mpp","brandBaseUrl":"https://whale-momentum.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into clean Markdown, structured JSON, skeleton outline, or a BM25-ranked token-budgeted excerpt","exampleAgentPrompt":"Distill the article at https://example.com/news/article-123 into clean markdown and keep it under 800 tokens, focusing on anything related to 'interest rate hikes'.","exampleUseCases":[{"title":"LLM-safe webpage summarization","prompt":"Grab the content from https://techcrunch.com/2024/05/01/openai-funding-round and distill it into markdown, but cap it at 500 tokens and focus on anything about 'valuation' so it fits in my prompt context."},{"title":"Structured data extraction from product page","prompt":"Pull this URL https://stripe.com/pricing and extract it in structured mode so I get the pricing tiers and plan details as organized JSON tables."},{"title":"Article skeleton for research outline","prompt":"Distill https://en.wikipedia.org/wiki/Quantum_computing into skeleton mode so I get just the section headings and outline structure without all the body text."}],"resultDescription":"Returns a 'data' object containing the distilled content (Markdown, structured JSON tables/metadata, skeleton outline, or BM25-ranked excerpt), plus an 'roi_proof' object showing raw token count, distilled token count, tokens saved, compression ratio, and estimated LLM cost saved in USD. Also includes cache hit/miss status and billing details.","failureModes":["URL unreachable or returns non-200 response — extraction fails with error status","Raw HTML payload too large — may exceed processing limits","mode=budget used without a query parameter — BM25 ranking has no focus signal","max_tokens set below minimum (20) — validation error","Paywalled or JavaScript-rendered pages may return incomplete or empty content","Payment not provided or insufficient — HTTP 402 returned blocking execution"],"whenToPreferThis":"Choose this endpoint when you need to feed web content to an LLM but want to minimize token usage and cost. The BM25 budget mode is uniquely useful when you have a specific question and want only the most relevant passages from a page. Prefer this over generic scrapers when token budget and cost-efficiency matter, or when you need structured JSON or skeleton outlines rather than raw HTML dumps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:31:43.709Z","isFirstParty":false,"canonicalSlug":"whale-momentum-agentdiet-dev-article-extractor-with-bm25-budget-control-d22b28ee"}