{"uid":"cap_UYXI-DDygZeoqBfgcA9pq","slug":"shopify-spy-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-651d151f","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/url-to-markdown)","url":"https://shopify-spy.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_1YLGWJ81RYlcie_ZsULN2","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 and distills any web URL or raw HTML into compact, agent-ready Markdown or structured output with optional BM25-ranked token budgeting","exampleAgentPrompt":"Fetch https://stripe.com/docs/payments and distill it into compact markdown using budget mode focused on the query 'payment intents', keeping it under 2000 tokens.","exampleUseCases":[{"title":"Compress docs page for agent context","prompt":"Grab https://docs.openai.com/api-reference and distill it into markdown so I can fit it into my agent's context window without blowing the token limit — use budget mode with a max of 3000 tokens."},{"title":"Extract structured data from product page","prompt":"Fetch https://www.apple.com/iphone and convert it to structured mode so I get clean JSON tables and metadata about the product instead of raw HTML."},{"title":"Focused research snippet from news article","prompt":"Distill https://techcrunch.com/2024/06/01/openai-raises-funding into budget mode with the query 'funding amount valuation' and cap it at 500 tokens so I only get the most relevant parts."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown, structured JSON, skeleton outline, or BM25-ranked excerpt depending on mode), a cache status object indicating HIT or MISS, billing details, and an ROI proof object showing raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD.","failureModes":["Invalid or unreachable URL returns an error status","HTML fetch timeout for slow or blocked websites","mode=budget without a query or max_tokens may return unfiltered output","Token budget set too low may result in empty or heavily truncated output","Paywalled or bot-protected pages may return incomplete content","Payment/x402 authorization failure if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need to fetch and compress web content specifically to fit within an LLM context window, especially when token budgeting is critical. It excels over generic scrapers when you want BM25-ranked, query-focused excerpts rather than full page dumps. Prefer it when you need ROI telemetry (tokens saved, cost saved) or when you need multiple output modes (markdown, structured tables, skeleton, budget excerpt) from a single endpoint with per-call micropayment pricing via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:21:02.048Z","isFirstParty":false,"canonicalSlug":"shopify-spy-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-651d151f"}