{"uid":"cap_o5Y7iJI0gb5gboetnRUgL","slug":"polymarket-odds-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-84278ed1","name":"Web URL to Markdown 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://polymarket-odds.agentdiet.dev/v1/docs-to-markdown)","url":"https://polymarket-odds.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 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_eie2yaeGhsF7ho6S4bleT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"polymarket-odds.agentdiet.dev","brandSlug":"polymarket-odds-agentdiet-dev-mpp","brandBaseUrl":"https://polymarket-odds.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":"Can you distill https://docs.stripe.com/api into compact markdown using budget mode, focusing on 'payment intents', and keep it under 2000 tokens?","exampleUseCases":[{"title":"Research page within token budget","prompt":"Grab https://en.wikipedia.org/wiki/Large_language_model and distill it into budget mode focused on 'training data', capping at 1500 tokens so I can fit it in my context window."},{"title":"Convert API docs to structured tables","prompt":"Fetch https://docs.openai.com/api-reference and distill it in structured mode so I get the endpoints and parameters as JSON tables I can parse."},{"title":"Quick skeleton outline of a long article","prompt":"Take this URL https://www.anthropic.com/research/constitutional-ai and give me a skeleton outline of the document so I can see the major sections without reading the whole thing."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), along with an roi_proof block showing raw vs. distilled token counts, compression ratio, tokens saved, and estimated LLM cost saved in USD. Also includes cache status (HIT/MISS) and billing details.","failureModes":["Invalid or unreachable URL returns an error status","HTML too large or malformed may degrade distillation quality","mode=budget without a query or max_tokens may produce unoptimized output","Rate limits or payment failures (HTTP 402) block the request","Sites with bot protection or paywalls may return incomplete content"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read a webpage but must stay within a token budget, or when raw HTML would be too verbose and costly to pass directly to an LLM. Especially useful for injecting live documentation, news pages, or research articles into agent context windows efficiently. Prefer the budget+BM25 mode when only a specific topic within a large page is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:24:19.642Z","isFirstParty":false,"canonicalSlug":"polymarket-odds-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-98c82cfa"}