Search Toolkit

Официальные веб-инструменты для ИИ-агентов, с постоянной ротацией нескольких ключей и тремя точками входа: 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

Импортёр однократно читает Kelivo и записывает %USERPROFILE%/.config/search-toolkit/providers.json в Windows. Это позволяет избежать виртуализации 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