{"uid":"cap_RfOMnwaIvrgLdkTsQdmRh","slug":"serp-extract-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-dbf75806","name":"Web URL to Markdown Distiller with BM25 Budget Control","description":"Distill a web URL into compact agent-ready tokens (Live x402 v2, IETF MPP & MCP endpoint at https://serp-extract.agentdiet.dev/v1/docs-to-markdown)","url":"https://serp-extract.agentdiet.dev/v1/docs-to-markdown?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","minLength":1,"description":"Target webpage URL to distill (or builtin://stripe-docs)"},"mode":{"enum":["markdown","structured","skeleton","budget"],"type":"string","default":"markdown","description":"Extraction mode: markdown, structured, skeleton, or budget"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Maximum number of items to return per page (1-100)"},"query":{"type":"string","description":"BM25 focus query when mode=budget"},"cursor":{"type":"string","description":"Opaque pagination cursor for fetching the next page"},"max_tokens":{"type":"integer","minimum":20,"description":"Strict token 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_1uks_5DYb4TK_ztpRJ8w6","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"serp-extract.agentdiet.dev","brandSlug":"serp-extract-agentdiet-dev-mpp","brandBaseUrl":"https://serp-extract.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a web URL (or raw HTML) and distills it into compact, agent-ready markdown, structured JSON, skeleton outline, or BM25-focused token-budgeted excerpts","exampleAgentPrompt":"Fetch the page at https://docs.stripe.com/api/charges and distill it into compact markdown, keeping it under 2000 tokens using budget mode focused on the query 'charge creation parameters'.","exampleUseCases":[{"title":"Compress API docs for agent context","prompt":"Take the OpenAI API reference page at https://platform.openai.com/docs/api-reference and distill it into a skeleton outline so I can see the structure without burning my entire context window."},{"title":"Token-budgeted research grounding","prompt":"Fetch https://en.wikipedia.org/wiki/Retrieval-augmented_generation and give me a BM25-focused excerpt about 'vector database integration' in no more than 500 tokens."},{"title":"Convert raw HTML to structured tables","prompt":"I have a raw HTML snippet from a financial report — can you distill it into structured JSON tables so my agent can parse the numbers cleanly?"}],"resultDescription":"Returns a JSON object containing distilled content (markdown text, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), plus an roi_proof object showing raw vs distilled token counts, tokens saved, compression ratio percentage, estimated LLM cost saved in USD, and optionally cache hit/miss status and billing details.","failureModes":["URL unreachable or returns non-200 status — endpoint may return error status","Malformed or empty HTML produces empty or minimal distilled output","max_tokens set below 20 triggers validation error","BM25 query provided without mode=budget may be ignored","Payment/402 authentication failure if agent_id or payment not configured","Very large pages may exceed processing limits or increase latency significantly"],"whenToPreferThis":"Choose this endpoint when you need to feed web page content to an LLM but want to minimize token usage and cost — especially when operating under strict context window budgets. The BM25 budget mode makes it uniquely suited for focused extraction around a specific query topic. Prefer it over generic web scrapers when token efficiency and compression metrics matter, or when you need structured JSON tables 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-21T07:22:46.794Z","isFirstParty":false,"canonicalSlug":"serp-extract-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-16204784"}