Skip to main content
Glama

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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.
      4
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 PyPI
      7
      MIT