Search Toolkit

面向 AI 智能体的官方优先 Web 工具，具有持久化多密钥轮换和三个入口点：MCP、CLI 和 Agent Skills。

简体中文

设计

Search Toolkit 保留各提供商特有的能力，而不是将每个后端扁平化为一个通用搜索端点。

• 官方远程 MCP 代理：Exa、Tavily 和 LinkUp。

• 官方 STDIO MCP 代理：Firecrawl。

• 轻量官方 API 适配器：Querit、Serper、Brave、Jina Search、TinyFish Search、Doubao Search 和 xAI Responses Web/X Search。

• 基于 SQLite 的持久化按提供商密钥池。

• 启动时从官方 MCP 服务器发现带提供商前缀的上游工具名称和模式，然后通过可选的提供商工具策略进行过滤。

• 原始密钥保存在仓库之外的本地 JSON 文件中。

实现所引用的官方参考资料包括 Codex MCP 配置指南、MCP TypeScript SDK、Exa MCP、Tavily MCP、LinkUp MCP 和 Firecrawl MCP。

提供商能力

安装

git clone https://github.com/TheWiseWolfHolo/search-toolkit E:/Script/Services/search-toolkit
cd E:/Script/Services/search-toolkit
npm install
npm run build

需要 Node.js 22 或更高版本。建议使用 Node.js 24，因为持久化轮换存储使用内置的 node:sqlite 模块。

配置

将 config.example.json 复制到仓库之外的私有路径，并替换占位密钥：

$env:SEARCH_TOOLKIT_CONFIG = "$HOME/.config/search-toolkit/providers.json"

本地一次性导入器可以将已配置的 Kelivo 搜索密钥迁移到独立文本配置中：

npm run import:kelivo

导入器在 Windows 上从 Kelivo 读取一次，并写入 %USERPROFILE%/.config/search-toolkit/providers.json。这避免了 MSIX AppData/Local 虚拟化，因此 Codex、Claude Code 和普通 CLI 进程读取的是同一个物理文件。运行时 MCP 和 CLI 进程永远不会访问 Kelivo。

CLI

node dist/src/cli.js tools
node dist/src/cli.js status
node dist/src/cli.js call querit_search '{"query":"latest AI agent news","limit":5}'
node dist/src/cli.js probe querit "Search Toolkit rotation probe"

MCP

先构建，然后将本地 STDIO 服务器添加到 Codex：

[mcp_servers.searchToolkit]
command = "C:/path/to/node.exe"
args = ["E:/Script/Services/search-toolkit/dist/src/mcp-server.js", "--config", "C:/Users/you/.config/search-toolkit/providers.json"]
startup_timeout_sec = 30
tool_timeout_sec = 120
enabled = true
default_tools_approval_mode = "writes"

MCP 服务器提供：

• 由提供商工具策略选定的带提供商前缀的官方上游工具。Firecrawl 默认提供七个聚焦的检索/获取工具，而不是其完整的管理目录。

• 所有已配置的 REST 适配器工具。

• search_auto 用于感知能力的默认路由，带有可审计的 {provider, tool, upstreamTool} 元数据。

• search_pool_status 用于掩码密钥池诊断。

• search_rotation_probe 用于实时的、消耗配额的轮换验证。

仅当有意暴露某个提供商的完整上游目录时，才将其 toolPolicy.allow 设置为 ["*"]。写入和破坏性工具保留修正后的注解，以便客户端可以请求批准。

密钥轮换

每个请求从相关提供商池中选择一个密钥。游标在进程重启后仍然保留，并通过 SQLite 在并发智能体进程之间进行协调。

• 200：正常推进。

• 429 或 402：冷却当前密钥。

• 401 或 403：禁用当前密钥。

• 5xx 或网络故障：使用下一个密钥重试一次。

• 400、404 或 422：保留请求错误，不归咎于其他密钥。

providers.json、原始密钥和轮换状态会被 Git 忽略。命令输出和 MCP 元数据仅显示掩码密钥槽位。

技能

可复用技能位于 skills/search-toolkit/ 下。将其复制或链接到你的智能体技能目录中。它会将常规研究直接路由到 Search Toolkit，并将深度研究编排保留给真正的多阶段工作。

开发

npm test
npm run smoke:mcp
npm pack --dry-run

许可证

MIT