{"uid":"cap_TER_pYAzkE_0U2Qk76-Ny","slug":"mesh-agentdiet-dev-web-url-to-agent-ready-token-distiller-rag-chunk-4a4b9fc4","name":"Web URL to Agent-Ready Token Distiller (RAG Chunk)","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://mesh.agentdiet.dev/v1/rag-chunk)","url":"https://mesh.agentdiet.dev/v1/rag-chunk?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_mCiYCAwmqPQrErKFiIith","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"mesh.agentdiet.dev","brandSlug":"mesh-agentdiet-dev-mpp","brandBaseUrl":"https://mesh.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and compresses a webpage URL (or raw HTML) into compact, token-efficient markdown, structured JSON, skeleton outline, or BM25-focused budget excerpt for AI agent consumption.","exampleAgentPrompt":"Distill the content at https://stripe.com/docs/api into compact markdown using budget mode, focused on 'authentication', and keep it under 500 tokens.","exampleUseCases":[{"title":"RAG pipeline web page compression","prompt":"Fetch https://platform.openai.com/docs/guides/function-calling and distill it into clean markdown so I can add it to my RAG pipeline without blowing my token budget."},{"title":"Topic-focused documentation excerpt","prompt":"I need only the section about 'webhook verification' from https://docs.github.com/en/developers/webhooks-and-events/webhooks — distill it in budget mode with that as the query, max 300 tokens."},{"title":"Structured data extraction from webpage","prompt":"Convert the HTML content of https://news.ycombinator.com into structured JSON tables so my agent can process the top stories without wading through raw markup."}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (markdown text, structured JSON, skeleton outline, or BM25-focused 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 optional cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns non-200 — endpoint may return an error status","Token budget too low (max_tokens < 20) — rejected by schema validation","Mode set to 'budget' without providing a query — BM25 focus undefined","Raw HTML provided is empty or malformed — distillation yields minimal output","Payment not satisfied via x402 — 402 Payment Required response blocking the call"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read web pages but must conserve context window tokens — especially in RAG pipelines, research agents, or any workflow where full page HTML would be too large. It is preferable over raw web fetching when token budget control matters, and over generic scrapers when you need structured JSON, skeleton outlines, or BM25-focused excerpts rather than raw text dumps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:21:34.337Z","isFirstParty":false,"canonicalSlug":"mesh-agentdiet-dev-web-url-to-agent-ready-token-distiller-rag-chunk-4a4b9fc4"}