{"uid":"cap_SJaygzF2RwEEi3doEThvL","slug":"github-audit-agentdiet-dev-url-to-markdown-web-distiller-81b2446b","name":"URL to Markdown Web Distiller","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://github-audit.agentdiet.dev/v1/url-to-markdown)","url":"https://github-audit.agentdiet.dev/v1/url-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_8oIu-t1ct8eb25frgHNPb","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"github-audit.agentdiet.dev","brandSlug":"github-audit-agentdiet-dev-mpp","brandBaseUrl":"https://github-audit.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills any web URL or raw HTML into compact, token-efficient Markdown or structured output using BM25 budget control","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/api and distill it into compact markdown, keeping it under 2000 tokens focused on 'payment intents'?","exampleUseCases":[{"title":"Research doc ingestion for agent","prompt":"Grab the content at https://docs.openai.com/api-reference and distill it into structured markdown so I can feed it to my agent without blowing my context window."},{"title":"Budget-capped page excerpt for RAG","prompt":"Fetch https://en.wikipedia.org/wiki/Transformer_(deep_learning_architecture) and extract only the most relevant 500 tokens about 'attention mechanisms' using budget mode."},{"title":"Competitor pricing page extraction","prompt":"Distill https://www.anthropic.com/pricing into a structured format so I can compare their model tiers and costs easily."}],"resultDescription":"Returns a JSON object containing distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-ranked excerpt), an ROI proof object showing raw vs distilled token counts, compression ratio, tokens saved, and estimated LLM cost saved, plus optional cache status and billing details.","failureModes":["Invalid or unreachable URL returns an error status","Token budget too small (below minimum 20) causes rejection","Mode enum mismatch causes validation error","Private or bot-blocked pages may return empty or partial content","BM25 query provided without mode=budget may be ignored","Raw HTML too large may time out or be truncated"],"whenToPreferThis":"Choose this endpoint when you need to feed web page content to an LLM but want to minimize token usage and cost. It is especially useful for agents doing research, RAG pipelines ingesting live web data, or any workflow where a strict token budget must be respected. Prefer budget mode with a query when you only need topically relevant excerpts, and skeleton mode when you need a page outline without full content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:24:26.222Z","isFirstParty":false,"canonicalSlug":"github-audit-agentdiet-dev-url-to-markdown-web-distiller-81b2446b"}