Agent Web Search — MCP-сервер для Claude Code: поиск без ключей
Позволяет агенту искать в сети одним вызовом: на входе вопрос на естественном языке, на выходе цитаты и структурированные данные. Установка занимает минуту.
claude mcp add --env AGENT_WEB_SEARCH_PROVIDERS=<AGENT_WEB_SEARCH_PROVIDERS> --env ARK_API_KEY=<ARK_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env XAI_API_KEY=<XAI_API_KEY> --env DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> --transport stdio agent-web-search -- uvx agent-web-search-mcpЧто делает Agent Web Search
Agent Web Search — открытый MCP-сервер, CLI и Python-библиотека под MIT. Внутри один поисковый движок, к которому агент обращается тремя путями: через MCP-инструмент, через нативный плагин или через CLI с описанием в виде Agent Skill. Нужен Python 3.10+.
Провайдеры по умолчанию — DDGS, Exa и Parallel. Ключи API для них не нужны, поэтому проверить поиск можно сразу после установки. Остальные провайдеры подключаются через переменные окружения: AGENT_WEB_SEARCH_PROVIDERS, ARK_API_KEY, GEMINI_API_KEY, XAI_API_KEY, DEEPSEEK_API_KEY. Без нужного ключа соответствующий провайдер просто не поднимется.
Проверить до установки просто: uvx --from agent-web-search-mcp agent-web-search "<вопрос>" запускает поиск без изменения окружения. Основная установка — pipx install agent-web-search-mcp. Для терминальных агентов автор советует путь CLI + Skill: не нужно отлаживать конфигурационный JSON и следить за жизненным циклом транспорта.
Какие задачи решает
- найти свежую информацию по вопросу прямо из терминала
- подключить к агенту поиск в сеть без регистрации у провайдера
- получить цитаты и структурированные данные, а не просто ссылки
- проверить поиск через
uvx, ничего не устанавливая - отдать поиск скрипту на Python как библиотеку
Примеры запросов агенту
- Найди через agent-web-search, что изменилось в последнем релизе Anthropic Claude CLI
agent-web-search "как настроить MCP в Codex"- Установи agent-web-search-mcp и проверь, что инструмент отвечает на запрос
Как установить Agent Web Search
Командой платформы
claude mcp add --env AGENT_WEB_SEARCH_PROVIDERS=<AGENT_WEB_SEARCH_PROVIDERS> --env ARK_API_KEY=<ARK_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env XAI_API_KEY=<XAI_API_KEY> --env DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> --transport stdio agent-web-search -- uvx agent-web-search-mcpВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-web-search-mcp <команда>
Командой платформы
codex mcp add agent-web-search --env AGENT_WEB_SEARCH_PROVIDERS=<AGENT_WEB_SEARCH_PROVIDERS> --env ARK_API_KEY=<ARK_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env XAI_API_KEY=<XAI_API_KEY> --env DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> -- uvx agent-web-search-mcpВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-web-search-mcp <команда>
Файл настроек
{
"mcpServers": {
"agent-web-search": {
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"AGENT_WEB_SEARCH_PROVIDERS": "<AGENT_WEB_SEARCH_PROVIDERS>",
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-web-search-mcp <команда>
Файл настроек
{
"servers": {
"agent-web-search": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-web-search-mcp"
],
"env": {
"AGENT_WEB_SEARCH_PROVIDERS": "<AGENT_WEB_SEARCH_PROVIDERS>",
"ARK_API_KEY": "<ARK_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"XAI_API_KEY": "<XAI_API_KEY>",
"DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-web-search-mcp <команда>
Командой платформы
gemini mcp add -e AGENT_WEB_SEARCH_PROVIDERS=<AGENT_WEB_SEARCH_PROVIDERS> -e ARK_API_KEY=<ARK_API_KEY> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e XAI_API_KEY=<XAI_API_KEY> -e DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> agent-web-search uvx agent-web-search-mcpВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-web-search-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Agent Web Search
Как установить Agent Web Search в Claude Code?
Одной командой: `claude mcp add --env AGENT_WEB_SEARCH_PROVIDERS=<AGENT_WEB_SEARCH_PROVIDERS> --env ARK_API_KEY=<ARK_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env XAI_API_KEY=<XAI_API_KEY> --env DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> --transport stdio agent-web-search -- uvx agent-web-search-mcp`. Переменные окружения подставьте свои, если подключаете не только провайдеров по умолчанию.
Что делает Agent Web Search?
Принимает вопрос на естественном языке и возвращает ответ, цитаты или структурированные свидетельства в форме, удобной агенту. Работает как MCP-сервер, CLI и Python-библиотека.
Нужен ли ключ API?
Для провайдеров по умолчанию DDGS, Exa и Parallel ключ не требуется. Для остальных задайте ключи через переменные окружения.