wigolo search的8个隐藏参数详解：search_depth、stealth模式与category分类

wigolo search的8个隐藏参数详解：search_depth、stealth模式与category分类

【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo

wigolo是一个为 AI 编程代理打造的本地优先 Web 搜索工具，通过 MCP 提供 search（搜索）、fetch（抓取）、crawl（爬取）与 research（调研）四大核心能力——无需 API Key、不依赖云端、每次查询 $0 成本。而search工具藏着 8 个不常用的"隐藏参数"，search_depth四档速度、mode: stealth隐身模式、category六大垂直分类就是其中最被低估的三个。本文带你把它们全部用起来。

为什么你只用了 wigolo search 10% 的参数？

大多数人调用 search 时只传一个query。但 docs/tools.md 里列出的完整参数表，加上类型定义 SearchInput，其实有十几个"旋钮"。下面挑出最实用的 8 个，全部在 skills/wigolo-search/SKILL.md 中有官方用法示例。

参数一：search_depth — 四档速度，按需换速度换深度

这是最像"变速箱"的参数（定义见 src/types.ts），四个档位：

两个容易踩的坑（实现见 src/search/core/core-provider.ts）：

• ultra-fast未命中缓存不是报错，而是提示：响应会带一条notice: "cache miss, retry with search_depth=fast or higher"，提醒你升档重试，而不是默默返回空结果。
• 搜索缓存的 key 会包含search_depth，同一 query 用不同档位各存一份缓存，互不干扰。

💡 经验法则：会话里重复问的问题先用ultra-fast摸缓存，再逐步升档；赶时间出结果用fast，写调研报告用deep。

参数二：mode — stealth 模式如何绕过反爬

mode有三个取值：cache/default/stealth（默认default）。

• cache：只走 HTTP 缓存，允许返回过期内容，最快最省；
• stealth：为 JS 重度页面启动独立的隐身浏览器——独立指纹强化 User-Agent、stealth 启动参数与初始化脚本（见 src/fetch/stealth.ts），而且走一次性浏览器、用完即弃，并受专用并发槽位限制，不会拖垮普通抓取池。

什么时候用 stealth？搜索结果页本身是 SPA 壳子、或搜索引擎返回了反爬质询页时。注意它比default慢（要拉起浏览器），所以别当默认值，只在被拦时升档。

参数三：category — 六大垂直频道，一个参数切换引擎池

category可取general、news、code、docs、papers、images。每个类目背后是一整套独立的垂直引擎池（源码在 src/search/core/verticals/），而不是简单加个过滤条件：

• code/docs：针对技术内容调权，查框架文档、API 参考时命中率明显更高；
• news：配合country+time_range查时效新闻；
• papers：学术论文频道；
• images：一等公民类目，走 DDG Image（零 Key）+ Brave Image 双适配器，且自动跳过页面正文抓取（url指向来源页而非图片资源，省预算）；
• general：通用兜底，垂直频道结果不足 3 条时会自动从 general 池回补，避免"饿死"。

⚠️ 官方 Skill 文档特别提醒：category: "docs"务必搭配include_domains，否则容易返回泛泛的门户页。

{ "query": "rust async traits", "category": "docs", "include_domains": ["doc.rust-lang.org", "blog.rust-lang.org"], "max_results": 5 }

还有 5 个提升命中率的隐藏参数

④ exact_match — 短语级精确匹配

设为true后，query 按引号短语语义处理：支持该语法的引擎会过滤到包含完整短语的结果，编排器还会后置再过滤一遍——title+snippet 里不含该短语（忽略大小写）的结果直接丢弃。查报错信息的神器：

{ "query": "Cannot read properties of undefined", "exact_match": true }

⑤ time_range — 时间窗 + 精确日期边界

time_range支持day/week/month/year，是精度过滤器：没有日期的页面会被保留但降权（而非直接丢弃）。更严格的场景用 ISO 格式的from_date/to_date卡死区间，搭配日期敏感的类目（如news）效果最好。

⑥ include_domains / exclude_domains — 域名白名单与黑名单

前者锁定权威来源（框架官网、文档站），后者屏蔽噪音（教程农场、问答站）。这两个参数会进入搜索缓存 key，且对缓存命中结果也会重新过滤——白名单不会因为命中缓存而被"悄悄忽略"。

⑦ country / language — 地理与语言提示

country接受 ISO 3166-1 两位码（us、gb、de），是建议性提示而非硬性过滤，支持地域加权的引擎会据此调权；language同理传给引擎做语言偏好。

⑧ agent_context — 让排序懂你的任务

传一个{ text, recent_urls, intent }对象：text是任务上下文，recent_urls是代理近期看过的 URL（会被去重排除，避免重复返回你刚看过的页面），intent是一句话任务意图。排名会向你的任务倾斜，是"AI 代理专用"的隐藏杀手锏。

8 个参数组合速查表

快速上手

完整参数表参考 docs/tools.md，CLI 用法见 docs/cli.md，stealth 相关的引擎配置见 docs/configuration.md。search 工具入口在 src/tools/search.ts，核心编排逻辑在 src/search/core/orchestrator.ts。

把search_depth当变速箱、stealth当应急车道、category当频道开关——三个参数用熟，wigolo search 的输出质量会有肉眼可见的提升。🚀

【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo