零密钥起步
DuckDuckGo、Sogou、Bing、Baidu、Wikipedia、Startpage、Yandex 与 Mojeek 无需搜索 API 账号。
OPEN SOURCE / MCP SEARCH ROUTER
让 Agent 搜索网络，也控制来源、成本与上下文。
Agent Search MCP 默认使用 8 个零密钥来源，直接检索中文与英文网页，并在有限的调用、时间和证据预算内返回可追溯结果。
当前本地能力基线
ROUTE / FREE_FIRSTREADY
- 01QUERY识别语言与请求约束
- 02FREE调用零密钥来源
- 03GATE检查结果、相关性与来源覆盖
- 04PACK去重并压入证据预算
EVIDENCE1200 CHAR BUDGET
8零密钥来源
无需账号或搜索 API Key 即可启动
12搜索适配器
免费来源加 4 个可选商业 Provider
28.4%Compact Token 降幅
来自仓库内锁定的双语格式 fixture
18.17+Node.js
默认运行不依赖浏览器、数据库或 Python
01 / ROUTING CONTRACT
先看证据，再决定是否继续搜索。
路由器把来源选择、付费权限和响应大小放进同一份请求策略。默认 free_first 不会消耗已经配置的商业 API 额度。
- 01QUERY
识别语言与请求约束
- 02FREE
调用零密钥来源
- 03GATE
检查结果、相关性与来源覆盖
- 04PACK
去重并压入证据预算
FREE默认路径：free_first → compact evidence
PAID可选路径：quality_escalation → 一个已配置 Provider
02 / PRODUCT BEHAVIOR
搜索结果带着边界一起返回。
付费调用需要策略授权
配置 API Key 不等于允许消费。free_only、free_first、quality_escalation 与 paid_first 明确区分支出路径。
Token 预算属于搜索协议
结果数、摘要长度、完整结果数量和证据字符预算共同限制响应体积，后续条目仍保留来源。
失败不会伪装成低置信度
相关性、置信度、独立 Provider 家族数量和 partial failures 分开记录，Agent 可以检查上游发生了什么。
中文查询不经过翻译层
Sogou 与 Baidu 直接承担中文检索，英文和其他语言来源由各自适配器处理。
一套核心，多种接入方式
MCP stdio、带认证的 Streamable HTTP 与 fasm CLI 共用同一套路由、缓存和证据契约。
03 / INSTALL
一条命令启动。
默认配置只走零密钥来源。你可以先接入 MCP 客户端，再按需要配置商业 Provider、HTTP 模式或持久缓存。
终端STDIO
npx -y agent-search-mcpMCP 客户端配置JSON
{
"mcpServers": {
"agent-search": {
"command": "npx",
"args": ["-y", "agent-search-mcp"]
}
}
}需要 Node.js 18.17 或更高版本。默认运行不需要 Python。
04 / REPRODUCIBLE EVIDENCE
Token 数据来自可重放 fixture。
仓库用锁定 tokenizer 重放同一组双语结果，只比较输出格式对上下文体积的影响。
| 输出 | 每次查询平均 Token | 相对 Normal |
|---|---|---|
| Normal | 2311.0 | 基线 |
| Compact | 1655.8 | 28.4% |
| Compact+ | 1607.5 | 30.4% |
05 / FIT
适合需要检查搜索过程的 Agent。
- 01希望先用免费来源，再按质量门槛升级到商业 Provider
- 02需要中文原生检索，而不是把英文搜索结果机器翻译成中文
- 03需要限制 Provider 调用次数、总耗时、结果数量和上下文体积
- 04希望自托管搜索入口，并保留来源、失败和路由决策
06 / FAQ
安装前最常见的几个问题。
01Agent Search MCP 需要 API Key 吗？
不需要。默认的 8 个来源可以零密钥启动。Brave、Tavily、Exa 与 You.com 只在你配置凭证并选择允许它们的路由策略后使用。
02它可以替代 Tavily 或 Exa 吗？
它适合免费优先、自托管和多源证据场景。商业搜索 API 在稳定性、专有索引或语义能力上仍有优势，因此项目把它们保留为可控升级路径。
03默认运行需要 Python 吗？
不需要。默认搜索运行在 Node.js 上。只有可选的语义去重和重排能力会使用 Python 与 Model2Vec。
04它怎样减少 Agent 的上下文消耗？
Compact 输出保留前部完整结果，把后续结果收敛为带来源的引用，并用统一证据预算限制查询相关片段的总长度。
05HTTP 模式默认安全吗？
HTTP 与 both 模式默认要求 Bearer Token；带 Origin 的浏览器请求还要命中 allowlist。stdio 仍是最简单的本地接入方式。
START LOCAL
先用零密钥路径跑起来。
安装后，Agent 可以通过 MCP 搜索、提取网页、读取中文技术内容，并按同一份证据契约处理结果。