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