{"uid":"cap_nXMhHO5ePWeZSWQY3HWDH","slug":"domain-osint-agentdiet-dev-rag-token-diet-url-html-distiller-with-429084cf","name":"RAG Token Diet — URL/HTML 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://domain-osint.agentdiet.dev/v1/rag-token-diet)","url":"https://domain-osint.agentdiet.dev/v1/rag-token-diet?utm_source=zero.xyz","method":"POST","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_fbSiXlt9pEd48tNnuvDxO","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"domain-osint.agentdiet.dev","brandSlug":"domain-osint-agentdiet-dev-mpp","brandBaseUrl":"https://domain-osint.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into compact Markdown, structured JSON, a skeleton outline, or a BM25-ranked token-budgeted excerpt to reduce LLM context costs.","exampleAgentPrompt":"Distill https://stripe.com/docs/payments into clean markdown using budget mode, focused on the query 'payment intents API', and cap the output at 500 tokens so I can fit it into my context window.","exampleUseCases":[{"title":"RAG pipeline context compression","prompt":"Fetch https://openai.com/research/gpt-4 and distill it into budget mode with the query 'multimodal capabilities', capping at 300 tokens — I need just the relevant bits for my RAG pipeline without blowing my token budget."},{"title":"Documentation page to structured JSON","prompt":"Take this URL https://docs.github.com/en/rest/repos and convert it into structured mode so I get the tables and metadata as clean JSON I can parse programmatically."},{"title":"Inline HTML snippet cleanup","prompt":"I've got this raw HTML blob from a web scrape — can you distill it into markdown mode to strip out all the nav, ads, and boilerplate and give me just the readable article content?"}],"resultDescription":"Returns a 'data' object containing the distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-ranked excerpt depending on mode), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, roi_multiplier, and llm_cost_saved_usd. Also includes cache status (HIT/MISS), billing info, and execution status.","failureModes":["URL is unreachable or returns a non-200 response — endpoint may error or return empty data","max_tokens set below 20 — validation error returned","mode=budget used without providing a query — BM25 ranking has no focus signal","Raw HTML is malformed or empty — distillation may produce minimal output","Payment failure via x402 — call blocked if USDC balance is insufficient","Rate limiting or timeout on slow target URLs"],"whenToPreferThis":"Choose this endpoint when you need to compress web content before feeding it into an LLM to reduce token costs and stay within context limits. It is especially valuable in RAG pipelines where only the most relevant sections of a page (identified via BM25) are needed. Prefer it over generic scraping tools when you need both content extraction AND token-budget enforcement in a single call. The ROI proof output makes it easy to track cost savings programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:30:11.449Z","isFirstParty":false,"canonicalSlug":"domain-osint-agentdiet-dev-rag-token-diet-url-html-distiller-with-429084cf"}