Search Toolkit
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。
Related MCP server: qsearch
提供商能力
用途 | 提供商或工具系列 |
通用快速网页查找 | Querit |
精确字符串、语义发现、代码和页面内容 | Exa 官方 MCP |
实时搜索、提取和智能体研究 | Tavily 官方 MCP |
简洁的 Google 结果、新闻和图片 | Serper |
独立的网页/新闻索引 | Brave Search |
带来源的答案和研究任务 | LinkUp 官方 MCP |
搜索、抓取、爬取、映射和结构化提取 | Firecrawl 官方 MCP |
轻量搜索 | Jina Search |
轻量独立搜索 | TinyFish Search |
中国本地搜索,配额使用明确 | Doubao,默认仅手动 |
原生 Web + X 搜索与模型综合 | Grok / xAI Responses |
安装
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Scrape, crawl and search the web for AI agents via MCP.
Web scraping, extraction and search for AI agents. Hosted MCP with workspace API keys.
Free web search for AI agents. No API key required. Hosted MCP in active development.
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to perform multi-engine web search, fetch web pages, and extract clean Markdown content via MCP, with no API keys required.311MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.4Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform unified web research through a single MCP server, including search, page fetching, recursive crawling, document parsing, YouTube transcript extraction, and deep multi-query research.3-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform live web searches across 9 engines, scrape web pages into clean formats, and run agentic research with citations via MCP.60 PyPI7MIT