{"uid":"cap_mM_7dTBoVfRL-fted_G5k","slug":"defi-yield-agentdiet-dev-web-url-token-optimizer-distiller-1ed73517","name":"Web URL Token Optimizer & Distiller","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://defi-yield.agentdiet.dev/v1/token-optimizer)","url":"https://defi-yield.agentdiet.dev/v1/token-optimizer?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_xCPppABPy8dXh-F8IHmjp","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"defi-yield.agentdiet.dev","brandSlug":"defi-yield-agentdiet-dev-mpp","brandBaseUrl":"https://defi-yield.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a webpage URL or raw HTML into compact, agent-ready tokens using BM25 budget control and multiple extraction modes","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 800 tokens focused on the query 'payment intents' using budget mode?","exampleUseCases":[{"title":"Compress documentation for agent context","prompt":"Grab the Stripe API docs at https://stripe.com/docs/api and distill them into structured mode so I can include them in my agent's context window without burning too many tokens."},{"title":"Budget-capped research on a news article","prompt":"Fetch https://techcrunch.com/2024/06/01/openai-announcement and give me only the most relevant 300 tokens focused on the query 'funding round' — use budget mode with max 300 tokens."},{"title":"Skeleton outline of a long report","prompt":"Take this URL https://example.com/annual-report-2024 and give me a skeleton outline of the page structure so I can understand what sections exist before I dive deeper."}],"resultDescription":"Returns a data object containing the distilled content (markdown, structured JSON tables/metadata, skeleton outline, or BM25-ranked budget excerpt), plus an roi_proof block showing raw token count, distilled token count, tokens saved, compression ratio percentage, estimated LLM cost saved in USD, and ROI multiplier. Also includes optional cache status (HIT/MISS) and billing details.","failureModes":["Invalid or unreachable URL returns an error status","HTML too large or malformed may yield poor distillation quality","mode=budget without a query or max_tokens may fall back to defaults","Payment failure (HTTP 402) if x402 micropayment not completed","Cache miss on first fetch may increase latency","Paywalled or JavaScript-rendered pages may return incomplete content"],"whenToPreferThis":"Choose this endpoint when your agent needs to read a webpage but must minimize token consumption before passing content to an LLM — especially when context windows are tight, LLM costs matter, or you need only a focused excerpt via BM25. It is preferable over raw web fetching because it handles fetching, cleaning, and compression in one step with quantified ROI proof. Use it over generic scrapers when you need structured output modes (markdown, JSON tables, skeleton, budget-capped excerpt) rather than raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:43:52.839Z","isFirstParty":false,"canonicalSlug":"defi-yield-agentdiet-dev-web-url-token-optimizer-distiller-1ed73517"}