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