SearXNG Search — MCP-сервер для Claude Code: веб-поиск без API-ключа
Подключает ИИ-ассистента к вашему инстансу SearXNG: поиск с пагинацией, чтение страниц и PDF. Пригодится, когда нужен веб-поиск без платного ключа.
claude mcp add mcp-searxng -e SEARXNG_URL=<SEARXNG_URL> -e AUTH_USERNAME=<AUTH_USERNAME> -e AUTH_PASSWORD=<AUTH_PASSWORD> -- npx -y mcp-searxngЧто делает SearXNG Search
Сервер стоит между клиентом и SearXNG: клиент запускает процесс по STDIO или подключается к HTTP-сервису, а SEARXNG_URL указывает на сам поисковик, не на MCP-эндпоинт. Внутри четыре инструмента: searxng_web_search ищет и уточняет выдачу, searxng_search_suggestions дополняет запрос, searxng_instance_info показывает категории и движки, web_url_read вытаскивает текст или Markdown по известному адресу.
Перед установкой нужен работающий инстанс SearXNG с включённым JSON-поиском. Этот проект его не разворачивает. Если своего нет, придётся поднять self-hosted или взять публичный, но тогда запрос уходит оператору и может попасть в логи. Анонимность ни SearXNG, ни эта обвязка сами по себе не дают.
Для локального запуска хватит Node.js 22 или новее и npx. Есть Docker-вариант, HTTP-транспорт с bearer-токеном и опциональным OAuth, а также список реплик через точку с запятой для взаимозаменяемых инстансов. Платный ключ поискового вендора не нужен, но и без инстанса сервер бесполезен — это первое, что стоит проверить.
Какие задачи решает
- дать ассистенту веб-поиск без покупки API-ключа
- прочитать найденную страницу как текст или Markdown
- вытащить текст из PDF по ссылке
- уточнить запрос через подсказки инстанса
- посмотреть, какие категории и движки включены в SearXNG
Примеры запросов агенту
- Найди через searxng_web_search документацию SearXNG и покажи первые результаты
- Прочитай страницу по этой ссылке инструментом web_url_read
- Какие категории и движки доступны? Вызови searxng_instance_info
Как установить SearXNG Search
Командой платформы
claude mcp add mcp-searxng -e SEARXNG_URL=<SEARXNG_URL> -e AUTH_USERNAME=<AUTH_USERNAME> -e AUTH_PASSWORD=<AUTH_PASSWORD> -- npx -y mcp-searxngВместо <…> подставьте свои значения
Командой платформы
codex mcp add searxng-search --env SEARXNG_URL=<SEARXNG_URL> --env AUTH_USERNAME=<AUTH_USERNAME> --env AUTH_PASSWORD=<AUTH_PASSWORD> -- npx -y mcp-searxngВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"searxng-search": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"searxng-search": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"AUTH_USERNAME": "<AUTH_USERNAME>",
"AUTH_PASSWORD": "<AUTH_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SEARXNG_URL=<SEARXNG_URL> -e AUTH_USERNAME=<AUTH_USERNAME> -e AUTH_PASSWORD=<AUTH_PASSWORD> searxng-search npx -y mcp-searxngВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о SearXNG Search
Как установить SearXNG Search в Claude?
Выполните `claude mcp add mcp-searxng -e SEARXNG_URL=<SEARXNG_URL> -e AUTH_USERNAME=<AUTH_USERNAME> -e AUTH_PASSWORD=<AUTH_PASSWORD> -- npx -y mcp-searxng`, подставив адрес своего инстанса и данные авторизации. Затем перезагрузите клиент и проверьте список MCP-инструментов.
Что делает SearXNG Search?
Связывает MCP-клиент с SearXNG и даёт четыре инструмента: поиск с пагинацией и фильтрами, подсказки запросов, сведения об инстансе и чтение URL. Выдача приходит текстом или JSON, страницы читаются как HTML, структурированный текст или ограниченный текст PDF.
Нужен ли API-ключ для работы?
Платный ключ поискового вендора не требуется. Вместо него нужен работающий инстанс SearXNG с включённым JSON-поиском, которым вы управляете или которому доверяете.
