web-retrieval-mcp — MCP-сервер для Claude Code: запуск
Сервер даёт агентам шесть инструментов для поиска в сети через Exa, Tavily и Firecrawl с защитой от SSRF. Он извлекает веб-страницы по цепочке провайдеров и сохраняет ссылки на источники.
claude mcp add web-retrieval-mcp -e EXA_API_KEY=<EXA_API_KEY> -e FIRECRAWL_API_KEY=<FIRECRAWL_API_KEY> -- uvx web-retrieval-mcpЧто делает web-retrieval-mcp
Сервер подключает к агенту шесть инструментов для поиска в интернете и научной литературы по машинному обучению. Поисковые запросы идут через Exa или Tavily с переходом на Firecrawl при сбоях. Получение страниц устроено по каскадной схеме: сначала проверяется исходный индекс, затем подключается локальный браузер Camoufox, а при необходимости запрос уходит в Tavily Extract или Firecrawl.
Каждый ответ сервера содержит разметку источников и указывает уровень извлечения контента. Безопасность обеспечивается фильтрацией запросов и редиректов от SSRF. Для работы обязателен Python версии 3.10 или выше, а также ключи EXA_API_KEY и FIRECRAWL_API_KEY. Без установленного браузера через команду camoufox fetch локальный рендеринг веб-страниц работать не будет.
Какие задачи решает
- Находить научные статьи по машинному обучению с выдержками из текста
- Искать решения в документации, пулл-реквестах и issues на GitHub
- Скачивать содержимое веб-страниц через резервные каналы при блокировках
- Защищать рабочее окружение агента от подделки запросов через SSRF
Примеры запросов агенту
- Найди свежие статьи по архитектуре MoE и покажи точные цитаты из источников
- Скачай документацию библиотеки по ссылке и выдели ключевые функции
- Поищи закрытые pull request в репозитории с похожей ошибкой
Как установить web-retrieval-mcp
Командой платформы
claude mcp add web-retrieval-mcp -e EXA_API_KEY=<EXA_API_KEY> -e FIRECRAWL_API_KEY=<FIRECRAWL_API_KEY> -- uvx web-retrieval-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from web-retrieval-mcp <команда>
Командой платформы
codex mcp add web-retrieval-mcp --env EXA_API_KEY=<EXA_API_KEY> --env FIRECRAWL_API_KEY=<FIRECRAWL_API_KEY> -- uvx web-retrieval-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from web-retrieval-mcp <команда>
Файл настроек
{
"mcpServers": {
"web-retrieval-mcp": {
"command": "uvx",
"args": [
"web-retrieval-mcp"
],
"env": {
"EXA_API_KEY": "<EXA_API_KEY>",
"FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from web-retrieval-mcp <команда>
Файл настроек
{
"servers": {
"web-retrieval-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"web-retrieval-mcp"
],
"env": {
"EXA_API_KEY": "<EXA_API_KEY>",
"FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from web-retrieval-mcp <команда>
Командой платформы
gemini mcp add -e EXA_API_KEY=<EXA_API_KEY> -e FIRECRAWL_API_KEY=<FIRECRAWL_API_KEY> web-retrieval-mcp uvx web-retrieval-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from web-retrieval-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о web-retrieval-mcp
Как установить web-retrieval-mcp в Claude Code?
Выполните команду claude mcp add web-retrieval-mcp -e EXA_API_KEY=<EXA_API_KEY> -e FIRECRAWL_API_KEY=<FIRECRAWL_API_KEY> -- uvx web-retrieval-mcp. Ключи сервисов передаются прямо в параметрах запуска.
Что делает web-retrieval-mcp?
Сервер добавляет инструменты для поиска в интернете, исследования публикаций по машинному обучению и надёжного извлечения текста страниц через несколько внешних провайдеров.
Что нужно подготовить перед запуском сервера?
Потребуется окружение с Python 3.10 или новее. Если вы планируете локально рендерить страницы через Camoufox, дополнительно выполните команду camoufox fetch для загрузки браузера.
