[{"data":1,"prerenderedAt":925},["ShallowReactive",2],{"navigation_docs":3,"-guide-cli":104,"-guide-cli-surround":920},[4,44],{"title":5,"path":6,"stem":7,"children":8,"icon":43},"Guide","\u002Fguide","1.guide\u002F1.index",[9,11,15,19,23,27,31,35,39],{"title":10,"path":6,"stem":7},"Getting Started",{"title":12,"path":13,"stem":14},"Searching","\u002Fguide\u002Fsearch","1.guide\u002F2.search",{"title":16,"path":17,"stem":18},"Fan-out","\u002Fguide\u002Ffanout","1.guide\u002F3.fanout",{"title":20,"path":21,"stem":22},"Reading","\u002Fguide\u002Fread","1.guide\u002F4.read",{"title":24,"path":25,"stem":26},"Reverse Image Search","\u002Fguide\u002Fimage","1.guide\u002F5.image",{"title":28,"path":29,"stem":30},"CLI","\u002Fguide\u002Fcli","1.guide\u002F6.cli",{"title":32,"path":33,"stem":34},"Agents","\u002Fguide\u002Fagents","1.guide\u002F7.agents",{"title":36,"path":37,"stem":38},"Custom Providers","\u002Fguide\u002Fcustom","1.guide\u002F8.custom",{"title":40,"path":41,"stem":42},"Explorer","\u002Fguide\u002Fexplorer","1.guide\u002F9.explorer","i-lucide-book-open",{"title":45,"path":46,"stem":47,"children":48,"icon":103},"Providers","\u002Fproviders","2.providers\u002F0.index",[49,51,55,59,63,67,71,75,79,83,87,91,95,99],{"title":50,"path":46,"stem":47},"Overview",{"title":52,"path":53,"stem":54},"Brave","\u002Fproviders\u002Fbrave","2.providers\u002F01.brave",{"title":56,"path":57,"stem":58},"Context.dev","\u002Fproviders\u002Fcontext","2.providers\u002F02.context",{"title":60,"path":61,"stem":62},"Exa","\u002Fproviders\u002Fexa","2.providers\u002F03.exa",{"title":64,"path":65,"stem":66},"Firecrawl","\u002Fproviders\u002Ffirecrawl","2.providers\u002F04.firecrawl",{"title":68,"path":69,"stem":70},"Jina","\u002Fproviders\u002Fjina","2.providers\u002F05.jina",{"title":72,"path":73,"stem":74},"Mojeek","\u002Fproviders\u002Fmojeek","2.providers\u002F06.mojeek",{"title":76,"path":77,"stem":78},"SearXNG","\u002Fproviders\u002Fsearxng","2.providers\u002F07.searxng",{"title":80,"path":81,"stem":82},"SerpAPI","\u002Fproviders\u002Fserpapi","2.providers\u002F08.serpapi",{"title":84,"path":85,"stem":86},"SerpBase","\u002Fproviders\u002Fserpbase","2.providers\u002F09.serpbase",{"title":88,"path":89,"stem":90},"Tavily","\u002Fproviders\u002Ftavily","2.providers\u002F10.tavily",{"title":92,"path":93,"stem":94},"TinyFish","\u002Fproviders\u002Ftinyfish","2.providers\u002F11.tinyfish",{"title":96,"path":97,"stem":98},"OpenAI Codex","\u002Fproviders\u002Fopenai-codex","2.providers\u002F12.openai-codex",{"title":100,"path":101,"stem":102},"Marginalia","\u002Fproviders\u002Fmarginalia","2.providers\u002F13.marginalia","i-lucide-library",{"id":105,"title":28,"body":106,"description":912,"extension":913,"links":914,"meta":915,"navigation":917,"path":29,"seo":918,"stem":30,"__hash__":919},"docs\u002F1.guide\u002F6.cli.md",{"type":107,"value":108,"toc":905},"minimark",[109,114,161,168,247,251,532,536,752,759,763,768,818,824,828,840,865,896,901],[110,111,113],"h2",{"id":112},"run-it","Run it",[115,116,121],"pre",{"className":117,"code":118,"language":119,"meta":120,"style":120},"language-bash shiki shiki-themes github-light github-light poimandres","pnpm add -g @agntn\u002Fweb\nweb \"your query\"\n","bash","",[122,123,124,144],"code",{"__ignoreMap":120},[125,126,129,133,137,141],"span",{"class":127,"line":128},"line",1,[125,130,132],{"class":131},"sseY5","pnpm",[125,134,136],{"class":135},"sX7Zv"," add",[125,138,140],{"class":139},"sqT1Y"," -g",[125,142,143],{"class":135}," @agntn\u002Fweb\n",[125,145,147,150,154,158],{"class":127,"line":146},2,[125,148,149],{"class":131},"web",[125,151,153],{"class":152},"scVjq"," \"",[125,155,157],{"class":156},"sQ7BG","your query",[125,159,160],{"class":152},"\"\n",[162,163,164,167],"p",{},[122,165,166],{},"web \u003Cquery>"," searches with the first configured provider. The subcommands do the rest:",[169,170,171,184],"table",{},[172,173,174],"thead",{},[175,176,177,181],"tr",{},[178,179,180],"th",{},"Command",[178,182,183],{},"Description",[185,186,187,197,207,217,227,237],"tbody",{},[175,188,189,194],{},[190,191,192],"td",{},[122,193,166],{},[190,195,196],{},"Search the web using the default provider",[175,198,199,204],{},[190,200,201],{},[122,202,203],{},"web search \u003Cquery...>",[190,205,206],{},"Search one or more queries",[175,208,209,214],{},[190,210,211],{},[122,212,213],{},"web search-image \u003Curl>",[190,215,216],{},"Find matching pages from a public image URL",[175,218,219,224],{},[190,220,221],{},[122,222,223],{},"web read \u003Curl...>",[190,225,226],{},"Read one or more URLs into normalized content",[175,228,229,234],{},[190,230,231],{},[122,232,233],{},"web providers",[190,235,236],{},"List registered providers and their capabilities",[175,238,239,244],{},[190,240,241],{},[122,242,243],{},"web mcp",[190,245,246],{},"Run the MCP server over stdio",[110,248,250],{"id":249},"examples","Examples",[115,252,254],{"className":117,"code":253,"language":119,"meta":120,"style":120},"web --provider brave \"your query\" --max-results 5\nweb search \"your query\" --json\nweb search \"first query\" \"second query\" --provider all --json\nweb search \"your query\" --provider firecrawl --sources web,news --categories research\nweb search \"your query\" --provider exa --summary --full-text\nweb search \"your query\" --provider brave --continuation \u003Copaque-token> --json\nweb search \"your query\" --include-domains github.com,stackoverflow.com --start-published-date 2026-01-01\nweb search-image https:\u002F\u002Fexample.com\u002Fimage.jpg --max-results 5 --json\nweb read https:\u002F\u002Fexample.com --format markdown --max-chars 20000 --json\nweb read https:\u002F\u002Fexample.com --max-chars 20000 --continuation \u003Copaque-token> --json\nweb read https:\u002F\u002Fexample.com\u002Fone https:\u002F\u002Fexample.com\u002Ftwo --json\nweb providers --json\n",[122,255,256,280,296,324,354,378,414,439,457,482,507,522],{"__ignoreMap":120},[125,257,258,260,263,266,268,270,273,276],{"class":127,"line":128},[125,259,149],{"class":131},[125,261,262],{"class":139}," --provider",[125,264,265],{"class":135}," brave",[125,267,153],{"class":152},[125,269,157],{"class":156},[125,271,272],{"class":152},"\"",[125,274,275],{"class":139}," --max-results",[125,277,279],{"class":278},"siHFe"," 5\n",[125,281,282,284,287,289,291,293],{"class":127,"line":146},[125,283,149],{"class":131},[125,285,286],{"class":135}," search",[125,288,153],{"class":152},[125,290,157],{"class":156},[125,292,272],{"class":152},[125,294,295],{"class":139}," --json\n",[125,297,299,301,303,305,308,310,312,315,317,319,322],{"class":127,"line":298},3,[125,300,149],{"class":131},[125,302,286],{"class":135},[125,304,153],{"class":152},[125,306,307],{"class":156},"first query",[125,309,272],{"class":152},[125,311,153],{"class":152},[125,313,314],{"class":156},"second query",[125,316,272],{"class":152},[125,318,262],{"class":139},[125,320,321],{"class":135}," all",[125,323,295],{"class":139},[125,325,327,329,331,333,335,337,339,342,345,348,351],{"class":127,"line":326},4,[125,328,149],{"class":131},[125,330,286],{"class":135},[125,332,153],{"class":152},[125,334,157],{"class":156},[125,336,272],{"class":152},[125,338,262],{"class":139},[125,340,341],{"class":135}," firecrawl",[125,343,344],{"class":139}," --sources",[125,346,347],{"class":135}," web,news",[125,349,350],{"class":139}," --categories",[125,352,353],{"class":135}," research\n",[125,355,357,359,361,363,365,367,369,372,375],{"class":127,"line":356},5,[125,358,149],{"class":131},[125,360,286],{"class":135},[125,362,153],{"class":152},[125,364,157],{"class":156},[125,366,272],{"class":152},[125,368,262],{"class":139},[125,370,371],{"class":135}," exa",[125,373,374],{"class":139}," --summary",[125,376,377],{"class":139}," --full-text\n",[125,379,381,383,385,387,389,391,393,395,398,402,405,409,412],{"class":127,"line":380},6,[125,382,149],{"class":131},[125,384,286],{"class":135},[125,386,153],{"class":152},[125,388,157],{"class":156},[125,390,272],{"class":152},[125,392,262],{"class":139},[125,394,265],{"class":135},[125,396,397],{"class":139}," --continuation",[125,399,401],{"class":400},"s1TYA"," \u003C",[125,403,404],{"class":135},"opaque-toke",[125,406,408],{"class":407},"sKlNE","n",[125,410,411],{"class":400},">",[125,413,295],{"class":139},[125,415,417,419,421,423,425,427,430,433,436],{"class":127,"line":416},7,[125,418,149],{"class":131},[125,420,286],{"class":135},[125,422,153],{"class":152},[125,424,157],{"class":156},[125,426,272],{"class":152},[125,428,429],{"class":139}," --include-domains",[125,431,432],{"class":135}," github.com,stackoverflow.com",[125,434,435],{"class":139}," --start-published-date",[125,437,438],{"class":135}," 2026-01-01\n",[125,440,442,444,447,450,452,455],{"class":127,"line":441},8,[125,443,149],{"class":131},[125,445,446],{"class":135}," search-image",[125,448,449],{"class":135}," https:\u002F\u002Fexample.com\u002Fimage.jpg",[125,451,275],{"class":139},[125,453,454],{"class":278}," 5",[125,456,295],{"class":139},[125,458,460,462,465,468,471,474,477,480],{"class":127,"line":459},9,[125,461,149],{"class":131},[125,463,464],{"class":135}," read",[125,466,467],{"class":135}," https:\u002F\u002Fexample.com",[125,469,470],{"class":139}," --format",[125,472,473],{"class":135}," markdown",[125,475,476],{"class":139}," --max-chars",[125,478,479],{"class":278}," 20000",[125,481,295],{"class":139},[125,483,485,487,489,491,493,495,497,499,501,503,505],{"class":127,"line":484},10,[125,486,149],{"class":131},[125,488,464],{"class":135},[125,490,467],{"class":135},[125,492,476],{"class":139},[125,494,479],{"class":278},[125,496,397],{"class":139},[125,498,401],{"class":400},[125,500,404],{"class":135},[125,502,408],{"class":407},[125,504,411],{"class":400},[125,506,295],{"class":139},[125,508,510,512,514,517,520],{"class":127,"line":509},11,[125,511,149],{"class":131},[125,513,464],{"class":135},[125,515,516],{"class":135}," https:\u002F\u002Fexample.com\u002Fone",[125,518,519],{"class":135}," https:\u002F\u002Fexample.com\u002Ftwo",[125,521,295],{"class":139},[125,523,525,527,530],{"class":127,"line":524},12,[125,526,149],{"class":131},[125,528,529],{"class":135}," providers",[125,531,295],{"class":139},[110,533,535],{"id":534},"flags","Flags",[169,537,538,547],{},[172,539,540],{},[175,541,542,545],{},[178,543,544],{},"Flag",[178,546,183],{},[185,548,549,563,577,587,597,607,617,627,637,647,657,667,677,687,697,707,717,730,742],{},[175,550,551,556],{},[190,552,553],{},[122,554,555],{},"--provider \u003Cname>",[190,557,558,559,562],{},"Provider to use (text: first configured or ",[122,560,561],{},"all","; image: SerpAPI; read: auto starting with Jina)",[175,564,565,570],{},[190,566,567],{},[122,568,569],{},"--max-results \u003Cn>",[190,571,572,573,576],{},"Maximum text or image results (default: ",[122,574,575],{},"10",")",[175,578,579,584],{},[190,580,581],{},[122,582,583],{},"--no-highlights",[190,585,586],{},"Disable the passages picked for the query when supported",[175,588,589,594],{},[190,590,591],{},[122,592,593],{},"--summary",[190,595,596],{},"Request generated summaries from Exa or an answer from Tavily",[175,598,599,604],{},[190,600,601],{},[122,602,603],{},"--full-text",[190,605,606],{},"Request full page text from Exa or Tavily",[175,608,609,614],{},[190,610,611],{},[122,612,613],{},"--include-domains \u003Ca,b>",[190,615,616],{},"Include only these domains in text search",[175,618,619,624],{},[190,620,621],{},[122,622,623],{},"--exclude-domains \u003Ca,b>",[190,625,626],{},"Exclude these domains from text search",[175,628,629,634],{},[190,630,631],{},[122,632,633],{},"--sources \u003Ca,b>",[190,635,636],{},"Source types for providers that support them",[175,638,639,644],{},[190,640,641],{},[122,642,643],{},"--categories \u003Ca,b>",[190,645,646],{},"Categories for providers that support them",[175,648,649,654],{},[190,650,651],{},[122,652,653],{},"--category \u003Cname>",[190,655,656],{},"One provider category",[175,658,659,664],{},[190,660,661],{},[122,662,663],{},"--start-published-date \u003CISO date>",[190,665,666],{},"Earliest publication date",[175,668,669,674],{},[190,670,671],{},[122,672,673],{},"--end-published-date \u003CISO date>",[190,675,676],{},"Latest publication date",[175,678,679,684],{},[190,680,681],{},[122,682,683],{},"--format \u003Cmarkdown|text|html>",[190,685,686],{},"Preferred read format",[175,688,689,694],{},[190,690,691],{},[122,692,693],{},"--max-tokens \u003Cn>",[190,695,696],{},"Jina's token budget, a longer page fails instead of being cut",[175,698,699,704],{},[190,700,701],{},[122,702,703],{},"--max-chars \u003Cn>",[190,705,706],{},"Portable maximum of page content characters",[175,708,709,714],{},[190,710,711],{},[122,712,713],{},"--continuation \u003Ctoken>",[190,715,716],{},"Continue a search page or a truncated read of one URL",[175,718,719,724],{},[190,720,721],{},[122,722,723],{},"--links",[190,725,726,727],{},"Keep the page's links in a read bounded by ",[122,728,729],{},"--max-chars",[175,731,732,737],{},[190,733,734],{},[122,735,736],{},"--images",[190,738,739,740],{},"Keep the page's image URLs in a read bounded by ",[122,741,729],{},[175,743,744,749],{},[190,745,746],{},[122,747,748],{},"--json",[190,750,751],{},"Output as JSON",[162,753,754,755,758],{},"Lists are comma separated. Read commands pick the reader automatically unless ",[122,756,757],{},"--provider"," is set.",[110,760,762],{"id":761},"json-envelopes","JSON envelopes",[162,764,765,767],{},[122,766,748],{}," prints the same shapes the library and the agent tools return. One parser for all three, that was the point.",[769,770,771,787,804,807],"ul",{},[772,773,774,775,778,779,782,783,786],"li",{},"A single search prints ",[122,776,777],{},"{ provider, results, ignoredFilters, undeclaredFilters, pagination, metadata? }",", plus ",[122,780,781],{},"attempts"," and ",[122,784,785],{},"failures"," when the provider was picked automatically.",[772,788,789,792,793,796,797,782,800,803],{},[122,790,791],{},"--provider all"," prints ",[122,794,795],{},"{ results, successfulProviders, errors, filterReports, providerPagination, providerMetadata? }",", with ",[122,798,799],{},"providers",[122,801,802],{},"evidence"," on every result. Provider errors are part of the output, not a reason to exit.",[772,805,806],{},"A batch of queries prints one item per query, each with its own result or error.",[772,808,809,810,813,814,817],{},"A single read prints ",[122,811,812],{},"{ result, requestedProvider, provider, attempts, failures }",". A batch adds ",[122,815,816],{},"url"," to each success and keeps the same diagnostics on each exhausted failure. Any failed read item makes the command exit 1, but the successes are still printed.",[162,819,820,821,823],{},"A failure that ends the command prints one line on stderr and exits 1, whether it is a spent key, a bad token or a date that is not ISO 8601. Nothing lands on stdout, ",[122,822,748],{}," included.",[110,825,827],{"id":826},"mcp","MCP",[115,829,831],{"className":117,"code":830,"language":119,"meta":120,"style":120},"web mcp\n",[122,832,833],{"__ignoreMap":120},[125,834,835,837],{"class":127,"line":128},[125,836,149],{"class":131},[125,838,839],{"class":135}," mcp\n",[162,841,842,843,850,851,854,855,854,858,782,861,864],{},"starts a ",[844,845,849],"a",{"href":846,"rel":847},"https:\u002F\u002Fmodelcontextprotocol.io",[848],"nofollow","Model Context Protocol"," server over stdio with ",[122,852,853],{},"web_search",", ",[122,856,857],{},"web_search_image",[122,859,860],{},"web_read",[122,862,863],{},"web_providers",". Register it with any client:",[115,866,868],{"className":117,"code":867,"language":119,"meta":120,"style":120},"claude mcp add web --scope user -- web mcp\n",[122,869,870],{"__ignoreMap":120},[125,871,872,875,878,880,883,886,889,892,894],{"class":127,"line":128},[125,873,874],{"class":131},"claude",[125,876,877],{"class":135}," mcp",[125,879,136],{"class":135},[125,881,882],{"class":135}," web",[125,884,885],{"class":139}," --scope",[125,887,888],{"class":135}," user",[125,890,891],{"class":139}," --",[125,893,882],{"class":135},[125,895,839],{"class":135},[162,897,898,900],{},[844,899,32],{"href":33}," covers what the tools accept and return.",[902,903,904],"style",{},"html pre.shiki code .sseY5, html code.shiki .sseY5{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#91B4D5}html pre.shiki code .sX7Zv, html code.shiki .sX7Zv{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#ADD7FF}html pre.shiki code .sqT1Y, html code.shiki .sqT1Y{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#ADD7FF}html pre.shiki code .scVjq, html code.shiki .scVjq{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#A6ACCD}html pre.shiki code .sQ7BG, html code.shiki .sQ7BG{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#5DE4C7}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .siHFe, html code.shiki .siHFe{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#5DE4C7}html pre.shiki code .s1TYA, html code.shiki .s1TYA{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#91B4D5}html pre.shiki code .sKlNE, html code.shiki .sKlNE{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#A6ACCD}",{"title":120,"searchDepth":146,"depth":146,"links":906},[907,908,909,910,911],{"id":112,"depth":146,"text":113},{"id":249,"depth":146,"text":250},{"id":534,"depth":146,"text":535},{"id":761,"depth":146,"text":762},{"id":826,"depth":146,"text":827},"The web command, its five subcommands, the flags, and the JSON envelopes that match the library.","md",null,{"icon":916},"i-lucide-terminal",true,{"title":28,"description":912},"UTsjelEyqUv7KuAL5rY4gr1kFRMU181eovgXoY6JtPI",[921,923],{"title":24,"path":25,"stem":26,"description":922,"children":-1},"A public image URL in, the pages that contain or resemble it out, through SerpAPI Google Lens.",{"title":32,"path":33,"stem":34,"description":924,"children":-1},"The same four tools for the Vercel AI SDK, the MCP server, Pi and OMP, and what an agent should and should not do with the answer.",1790380571663]