{"uid":"cap_xe8XcRu__HcTZTzT0rWZ0","slug":"shopify-spy-agentdiet-dev-web-url-distillation-bm25-budget-extraction-d9dd7e03","name":"Web URL Distillation & BM25 Budget Extraction","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/paywall-clean-extract)","url":"https://shopify-spy.agentdiet.dev/v1/paywall-clean-extract?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_XOrwQx0r_tcHdi63JRWSg","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 accepts raw HTML) and distills it into compact, agent-ready markdown, structured JSON, skeleton outline, or BM25-focused token-budgeted excerpts","exampleAgentPrompt":"Fetch https://stripe.com/docs/payments and distill it into compact markdown — I want to keep it under 800 tokens, so use budget mode with the query 'payment intents API'.","exampleUseCases":[{"title":"LLM-efficient documentation reader","prompt":"Grab the Stripe docs at builtin://stripe-docs and compress them into budget mode with the query 'webhooks' and a max of 500 tokens — I need just the relevant bits for my agent."},{"title":"Competitive product page analysis","prompt":"Distill https://www.shopify.com/pricing into structured mode so I can extract the pricing table and plan features as clean JSON for my analysis agent."},{"title":"Skeleton outline of a long article","prompt":"Fetch https://www.paulgraham.com/greatwork.html and give me a skeleton outline of the page structure so I can understand the main sections without consuming my full context window."}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (markdown text, structured JSON tables, skeleton outline, or BM25-focused excerpt depending on mode), an 'roi_proof' object showing raw vs distilled token counts, compression ratio, tokens saved, and estimated LLM cost saved in USD, plus optional cache hit/miss metadata and billing details.","failureModes":["URL is unreachable or returns non-200 HTTP status — endpoint may return an error status","HTML payload is malformed or too large — distillation may fail or truncate","max_tokens set too low (below 20) — validation error returned","BM25 query provided without mode=budget — query parameter ignored silently","Rate limiting or payment failure via x402 — 402 response requiring payment","JavaScript-heavy SPAs may not render dynamic content — static HTML only fetched"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read web content but must stay within token budget constraints, or when you want to strip boilerplate and extract clean, structured content from arbitrary URLs without building your own scraping pipeline. Particularly valuable when LLM context costs matter and you want quantified ROI proof of compression savings. Prefer over generic scrapers when BM25 query-focused relevance filtering or multiple distillation modes (markdown, structured, skeleton, budget) are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:23:15.715Z","isFirstParty":false,"canonicalSlug":"shopify-spy-agentdiet-dev-web-url-distillation-bm25-budget-extraction-d9dd7e03"}