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