{"uid":"cap_YHsne7TI5la0sgkWOXKYt","slug":"x402-audit-agentdiet-dev-rag-token-diet-bm25-budget-controlled-web-98249987","name":"RAG Token Diet — BM25 Budget-Controlled Web Distillation","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://x402-audit.agentdiet.dev/v1/rag-token-diet)","url":"https://x402-audit.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_kYfGfCka_mnRfec2CsvK5","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"x402-audit.agentdiet.dev","brandSlug":"x402-audit-agentdiet-dev-mpp","brandBaseUrl":"https://x402-audit.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into compact, agent-ready tokens using BM25-ranked budget control, with multiple output modes (markdown, structured, skeleton, budget).","exampleAgentPrompt":"Distill the page at https://docs.stripe.com/api/charges into budget mode, focused on the query 'charge creation parameters', and cap the output at 500 tokens.","exampleUseCases":[{"title":"RAG pipeline webpage compression","prompt":"Fetch https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) and distill it into clean markdown — I need a compact version I can drop into my RAG pipeline without blowing up my context window."},{"title":"On-topic budget excerpt for agent research","prompt":"Pull the page at https://openai.com/research/gpt-4 and use budget mode with the query 'training data and fine-tuning' to give me only the most relevant content, limited to 300 tokens."},{"title":"Structured data extraction from raw HTML","prompt":"I have a raw HTML dump of a pricing page — can you distill it in structured mode to extract the tables and metadata as clean JSON so my agent can parse the plan tiers?"}],"resultDescription":"Returns a JSON object containing the distilled content (markdown, structured tables/metadata, skeleton, or BM25 excerpt depending on mode), along with an roi_proof block showing raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD. Also includes cache hit/miss status and optional billing information.","failureModes":["URL is unreachable or returns non-200 — fetch error returned","URL missing or empty string — validation error","BM25 query not provided when mode=budget — may return unfiltered or error","max_tokens below minimum of 20 — rejected by schema validation","HTML payload too large — may time out or be truncated","Idempotency-Key reuse with different parameters — may return cached prior result"],"whenToPreferThis":"Choose this endpoint when you need to fit web content into a limited LLM context window, reduce token costs for RAG pipelines, or extract only query-relevant content from a noisy webpage using BM25 ranking. Prefer it over generic scrapers when token budget control or compression ROI metrics are needed. The budget mode with BM25 is especially useful when you have a specific research query and want to avoid processing irrelevant content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:31:24.257Z","isFirstParty":false,"canonicalSlug":"x402-audit-agentdiet-dev-rag-token-diet-bm25-budget-controlled-web-98249987"}