{"uid":"cap_TMKoIVRcnaMokVxwXmRyH","slug":"agent-data-tools-revmesh2074-workers-dev-web-research-search-and-read-ba3f3dcb","name":"Web Research: Search and Read Top Pages","description":"One call to research a question on the web: a Brave web search, then the text of the top 1-5 result pages, read in parallel and clipped to your length, with titles and URLs. A page that cannot be read is listed with its reason. Results are for the caller's immediate use only: no storing, resale or model training (Brave API terms). Use when an agent needs current, sourced information in one step instead of a search plus several page reads.","url":"https://agent-data-tools.revmesh2074.workers.dev/pack/web-research?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"What to research, at most 400 characters"},"pages":{"type":"integer","description":"How many top results to read in full (1-5, default 3)"},"maxChars":{"type":"integer","description":"Characters of text per page (500-10000, default 3000)"}}},"responseSchema":{"type":"object","properties":{"pack":{"type":"string"},"pages":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"rank":{"type":"number"},"text":{"type":"string"},"error":{},"title":{"type":"string"},"snippet":{"type":"string"},"textLength":{"type":"number"}}}},"query":{"type":"string"},"terms":{"type":"string"},"failed":{"type":"object","properties":{}},"otherResults":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"}}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n4DN99O-klyZ-reZK7FjR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Performs a Brave web search and returns the full text of the top 1-5 result pages in a single API call","exampleAgentPrompt":"Can you research 'best practices for LLM prompt caching in 2025' on the web and bring back the text from the top 4 pages so I can read what they actually say?","exampleUseCases":[{"title":"Current events fact-checking","prompt":"Look up 'OpenAI GPT-5 release date announcement' on the web and show me what the top 3 pages say, with their titles and URLs so I can verify the sources."},{"title":"Competitive product research","prompt":"Research 'Notion vs Obsidian for knowledge management 2025' and read the top 5 pages — I want the actual page text, not just snippets, so I can compare what reviewers are saying."},{"title":"Technical how-to lookup","prompt":"Search for 'how to configure Cloudflare Workers KV storage' and pull the text from the top 2 results, keeping each page to about 5000 characters — I need enough detail to follow the steps."}],"resultDescription":"Returns a JSON object with: the resolved query string, an array of successfully-read pages (each with rank, URL, title, snippet, and clipped page text up to maxChars), a list of other search results (title + URL only), and a 'failed' map of pages that could not be fetched with the reason why.","failureModes":["Query exceeds 400 characters — rejected before search","pages parameter outside 1-5 range — validation error","Target pages return non-200 status or are JavaScript-rendered — listed in failed with reason","Brave API unavailable — upstream error propagated","Page is a PDF or binary file that cannot be read as text — listed in failed","maxChars outside 500-10000 range — validation error"],"whenToPreferThis":"Choose this endpoint when an agent needs both search results AND the actual page content in one round-trip, rather than calling a search API and then separately fetching each URL. It is especially valuable for question-answering, fact-checking, or summarization tasks where sourced, current text is needed. Prefer it over a plain search-only endpoint when snippets are insufficient and full page text is required. Note: results must not be stored, resold, or used for model training per Brave API terms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T04:21:31.263Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-web-research-search-and-read-ba3f3dcb"}