agent-search-mcp — MCP-сервер поиска для Claude Code и Cursor
Веб-поиск на английском и китайском без API-ключа: сервер отдаёт агенту компактные результаты с источниками и видимыми сбоями провайдеров.
claude mcp add agent-search-mcp -e BRAVE_API_KEY=<BRAVE_API_KEY> -e TAVILY_API_KEY=<TAVILY_API_KEY> -e EXA_API_KEY=<EXA_API_KEY> -e YDC_API_KEY=<YDC_API_KEY> -e TENCENT_WSA_API_KEY=<TENCENT_WSA_API_KEY> -e BOCHA_API_KEY=<BOCHA_API_KEY> -e SERPER_API_KEY=<SERPER_API_KEY> -- npx -y agent-search-mcpЧто делает agent-search-mcp
Сервер работает на Node.js и запускается через npx -y agent-search-mcp. Аккаунт поисковой системы и ключ API для старта не нужны: базовые провайдеры отвечают без ключей. Нужен Node.js версии 18.17 или новее — это единственное, что придётся поставить заранее.
Ответ устроен так, чтобы агенту было видно, откуда взялись ссылки. В JSON отдельно лежат сами результаты, блок meta.execution с причиной остановки и partialFailures с таймаутами, лимитами и блокировками. Счётчик source_count считает семейства провайдеров, поэтому один и тот же поисковик через несколько адаптеров не раздувает число источников. Запросы на китайском идут в Sogou и Baidu без перевода.
Политика free_first по умолчанию не трогает настроенные ключи платных провайдеров. free_only их запрещает совсем, quality_escalation подключает один платный сервис, когда бесплатных доказательств не хватает. Бюджеты ограничивают число попыток и объём выдачи. Если ключи не заданы, платные маршруты просто не включатся — останется бесплатный поиск.
Какие задачи решает
- найти свежие источники без регистрации в поисковом API
- проверить утверждение по официальным страницам и увидеть, откуда взята ссылка
- искать по-китайски без отдельного переводчика запросов
- уложить ответ поиска в бюджет токенов агентской сессии
- разобраться, почему часть результатов пропала при сбое провайдера
Примеры запросов агенту
- Найди через agent-search официальную документацию по этой функции и покажи источники
- Используй $agent-search, чтобы проверить это утверждение по официальным источникам
- Поищи по-китайски информацию о библиотеке и оставь ссылки с провайдерами
Как установить agent-search-mcp
Командой платформы
claude mcp add agent-search-mcp -e BRAVE_API_KEY=<BRAVE_API_KEY> -e TAVILY_API_KEY=<TAVILY_API_KEY> -e EXA_API_KEY=<EXA_API_KEY> -e YDC_API_KEY=<YDC_API_KEY> -e TENCENT_WSA_API_KEY=<TENCENT_WSA_API_KEY> -e BOCHA_API_KEY=<BOCHA_API_KEY> -e SERPER_API_KEY=<SERPER_API_KEY> -- npx -y agent-search-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add agent-search-mcp --env BRAVE_API_KEY=<BRAVE_API_KEY> --env TAVILY_API_KEY=<TAVILY_API_KEY> --env EXA_API_KEY=<EXA_API_KEY> --env YDC_API_KEY=<YDC_API_KEY> --env TENCENT_WSA_API_KEY=<TENCENT_WSA_API_KEY> -- npx -y agent-search-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"agent-search-mcp": {
"command": "npx",
"args": [
"-y",
"agent-search-mcp"
],
"env": {
"BRAVE_API_KEY": "<BRAVE_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"YDC_API_KEY": "<YDC_API_KEY>",
"TENCENT_WSA_API_KEY": "<TENCENT_WSA_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"agent-search-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-search-mcp"
],
"env": {
"BRAVE_API_KEY": "<BRAVE_API_KEY>",
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"EXA_API_KEY": "<EXA_API_KEY>",
"YDC_API_KEY": "<YDC_API_KEY>",
"TENCENT_WSA_API_KEY": "<TENCENT_WSA_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e BRAVE_API_KEY=<BRAVE_API_KEY> -e TAVILY_API_KEY=<TAVILY_API_KEY> -e EXA_API_KEY=<EXA_API_KEY> -e YDC_API_KEY=<YDC_API_KEY> -e TENCENT_WSA_API_KEY=<TENCENT_WSA_API_KEY> agent-search-mcp npx -y agent-search-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о agent-search-mcp
Как установить agent-search-mcp в Claude Code?
Добавьте сервер командой `claude mcp add agent-search-mcp -e BRAVE_API_KEY=<BRAVE_API_KEY> -e TAVILY_API_KEY=<TAVILY_API_KEY> -e EXA_API_KEY=<EXA_API_KEY> -e YDC_API_KEY=<YDC_API_KEY> -e TENCENT_WSA_API_KEY=<TENCENT_WSA_API_KEY> -e BOCHA_API_KEY=<BOCHA_API_KEY> -e SERPER_API_KEY=<SERPER_API_KEY> -- npx -y agent-search-mcp`. Ключи можно не заполнять, если платные провайдеры не нужны.
Что делает agent-search-mcp?
Это MCP-сервер веб-поиска, который отдаёт агенту результаты вместе с числом независимых источников, причиной остановки роутера и списком сбоев. Бесплатные провайдеры работают без ключа.
Нужен ли API-ключ для работы?
Нет, стартовать можно без ключей: без них платные маршруты не включаются. Ключи вроде TAVILY_API_KEY или BRAVE_API_KEY нужны только для политик, которые допускают платные провайдеры.
