{"uid":"cap_5g_bkDsyrd0ca4z5imGVA","slug":"shopify-spy-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-b9420bed","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://shopify-spy.agentdiet.dev/v1/docs-to-markdown)","url":"https://shopify-spy.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_l9qJA2LhK3DPbrOHJYhdm","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"shopify-spy.agentdiet.dev","brandSlug":"shopify-spy-agentdiet-dev-mpp","brandBaseUrl":"https://shopify-spy.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage or raw HTML and converts it into compact, token-efficient Markdown (or structured/skeleton/budget excerpts) with BM25-ranked content filtering and token ceiling enforcement.","exampleAgentPrompt":"Fetch https://docs.stripe.com/api and distill it into compact markdown using budget mode focused on 'payment intents', keeping it under 800 tokens.","exampleUseCases":[{"title":"Documentation summarization for agent context","prompt":"Grab the Stripe docs page at https://docs.stripe.com/api/charges and distill it into markdown so I can feed it to my agent without blowing my token budget — keep it under 600 tokens focused on 'charge object fields'."},{"title":"Competitive product page extraction","prompt":"Fetch https://www.shopify.com/pricing and convert it into structured markdown tables so I can compare the pricing tiers without sending thousands of tokens to my LLM."},{"title":"LLM-ready skeleton of a long article","prompt":"Distill https://en.wikipedia.org/wiki/Large_language_model into a skeleton outline so my agent gets the high-level structure without reading the entire page."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown text, structured JSON tables, skeleton outline, or BM25-ranked excerpt depending on mode), an ROI proof block showing raw vs. distilled token counts, compression ratio, and estimated LLM cost saved, plus optional cache hit/miss status and billing metadata.","failureModes":["Invalid or unreachable URL returns an error status","HTML too large or malformed may produce poor distillation quality","BM25 budget mode with a very low max_tokens ceiling may truncate critical content","Rate limiting or payment failure (x402) blocks the request","mode=budget without a query parameter may fall back to simple truncation"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ingest a live webpage or raw HTML but must stay within a strict token budget or minimize LLM inference costs. It is especially valuable for processing long documentation pages, product pages, or articles where only the most relevant sections (controlled via BM25 query) are needed. Prefer this over generic web scrapers when token efficiency and compression ROI metrics are important to the agent's operation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:25:57.907Z","isFirstParty":false,"canonicalSlug":"shopify-spy-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-651d151f"}