{"uid":"cap_8keRvP8bJtTcSOblxiFlG","slug":"hn-pulse-agentdiet-dev-web-url-markdown-distiller-with-bm25-budget-8eadbb9f","name":"Web URL Markdown 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://hn-pulse.agentdiet.dev/v1/markdown-distill)","url":"https://hn-pulse.agentdiet.dev/v1/markdown-distill?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_KMUsSvit631yitcwl6r6B","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"hn-pulse.agentdiet.dev","brandSlug":"hn-pulse-agentdiet-dev-mpp","brandBaseUrl":"https://hn-pulse.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or raw HTML and distills it into compact, agent-ready markdown, structured JSON, skeleton outline, or BM25-focused excerpts with token budget control","exampleAgentPrompt":"Distill this URL into clean markdown under 800 tokens, focusing on the pricing section: https://stripe.com/pricing — use budget mode with the query 'pricing plans'.","exampleUseCases":[{"title":"Fit documentation into LLM context","prompt":"Grab the Stripe docs page at https://stripe.com/docs/api and distill it into structured markdown so I can paste it into my prompt without blowing my context window."},{"title":"Topic-focused excerpt from long article","prompt":"I need just the parts of https://example.com/long-research-paper that are about 'carbon capture efficiency' — give me a BM25 budget excerpt with a max of 600 tokens."},{"title":"Skeleton outline for agent navigation","prompt":"Can you fetch https://docs.openai.com/api-reference and give me a skeleton outline of the page structure so my agent knows what sections exist before diving in?"}],"resultDescription":"Returns a JSON object containing the distilled content (markdown text, structured tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), plus an roi_proof block showing raw vs distilled token counts, tokens saved, compression ratio percentage, estimated LLM cost saved in USD, and an ROI multiplier. Also includes cache status (HIT/MISS) and billing details.","failureModes":["Invalid or unreachable URL returns an error status","Paywalled or bot-blocked pages may return empty or partial content","Token budget too low (below 20) rejected at input validation","HTML payload too large may timeout or be truncated","BM25 query with no relevant matches returns minimal excerpt","Payment failure via x402 prevents request from completing"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ingest web content but must stay within a token budget — especially for long documentation pages, research articles, or any URL where raw content would overflow an LLM context window. It is uniquely suited for agentic workflows that need BM25-focused relevance filtering or structured/skeleton extraction rather than naive full-page scraping. Prefer it over generic scrapers when token cost reduction and ROI proof matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:23:13.747Z","isFirstParty":false,"canonicalSlug":"hn-pulse-agentdiet-dev-web-url-markdown-distiller-with-bm25-budget-8eadbb9f"}