searxNcrawl — MCP-сервер для Claude Code: поиск и краулинг
Даёт агенту веб-поиск через SearXNG и You.com и превращает страницы в чистый Markdown. Пригодится, когда агенту нужны свежие данные из интернета.
claude mcp add --env SEARXNG_URL=<SEARXNG_URL> --env SEARXNG_USERNAME=<SEARXNG_USERNAME> --env SEARXNG_PASSWORD=<SEARXNG_PASSWORD> --env YDC_API_KEY=<YDC_API_KEY> --env SEARCH_RESULT_FIELDS=<SEARCH_RESULT_FIELDS> --transport stdio searxncrawl -- uvx searxncrawlЧто делает searxNcrawl
searxNcrawl — MCP-сервер и набор утилит командной строки для поиска в вебе и краулинга страниц. Поисковые запросы уходят к настроенным провайдерам параллельно, результаты объединяются и помечаются источником, есть фильтры по языку и времени. Краулинг построен на Crawl4AI: одна или много ссылок на входе, Markdown или JSON на выходе, повторяющиеся блоки вырезаются, ссылки можно убрать.
Кроме отдельных страниц сервер умеет обходить целые сайты с ограничением глубины и числа страниц — удобно для документации. Есть захват сессии входа через crawl-capture, после чего краулинг работает за логином. Запускается по STDIO для локальных клиентов или поднимает HTTP-эндпоинт с проверкой хоста и CORS. Те же search, crawl и crawl-capture доступны из терминала и как Python-библиотека.
Для работы нужен uv. Поиску требуется хотя бы один провайдер: свой SearXNG с включённым JSON-выводом или ключ You.com в YDC_API_KEY. Без SearXNG поиск не заработает, а краулинг — заработает. Первый обход скачивает Chromium для Playwright, около 550 MB, так что на медленном канале это заметная пауза. Команда uvx searxncrawl setup сама находит Claude, Codex, Gemini CLI, Cursor, VS Code и Claude Desktop, спрашивает адрес SearXNG и ключ You.com, показывает правки конфигов и применяет их после подтверждения; каждый файл перед этим копируется, а setup --remove откатывает изменения.
Какие задачи решает
- найти свежую документацию библиотеки и сразу получить её текстом
- собрать содержимое раздела документации в один Markdown-файл
- прочитать страницу за авторизацией, не копируя cookies вручную
- сравнить выдачу своего SearXNG и You.com по одному запросу
- отдать агенту текст статьи без навигации и рекламных блоков
Примеры запросов агенту
- Найди через поиск быстрый старт Crawl4AI, открой официальную страницу и перескажи, как запустить первый обход.
- Собери документацию по этому адресу в Markdown, глубина 2, не больше 30 страниц.
- Захвати сессию входа на этом сайте, а потом вытащи текст страницы с настройками.
Как установить searxNcrawl
Командой платформы
claude mcp add --env SEARXNG_URL=<SEARXNG_URL> --env SEARXNG_USERNAME=<SEARXNG_USERNAME> --env SEARXNG_PASSWORD=<SEARXNG_PASSWORD> --env YDC_API_KEY=<YDC_API_KEY> --env SEARCH_RESULT_FIELDS=<SEARCH_RESULT_FIELDS> --transport stdio searxncrawl -- uvx searxncrawlВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from searxncrawl <команда>
Командой платформы
codex mcp add searxncrawl --env SEARXNG_URL=<SEARXNG_URL> --env SEARXNG_USERNAME=<SEARXNG_USERNAME> --env SEARXNG_PASSWORD=<SEARXNG_PASSWORD> --env YDC_API_KEY=<YDC_API_KEY> --env SEARCH_RESULT_FIELDS=<SEARCH_RESULT_FIELDS> -- uvx searxncrawlВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from searxncrawl <команда>
Файл настроек
{
"mcpServers": {
"searxncrawl": {
"command": "uvx",
"args": [
"searxncrawl"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"SEARXNG_USERNAME": "<SEARXNG_USERNAME>",
"SEARXNG_PASSWORD": "<SEARXNG_PASSWORD>",
"YDC_API_KEY": "<YDC_API_KEY>",
"SEARCH_RESULT_FIELDS": "<SEARCH_RESULT_FIELDS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from searxncrawl <команда>
Файл настроек
{
"servers": {
"searxncrawl": {
"type": "stdio",
"command": "uvx",
"args": [
"searxncrawl"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>",
"SEARXNG_USERNAME": "<SEARXNG_USERNAME>",
"SEARXNG_PASSWORD": "<SEARXNG_PASSWORD>",
"YDC_API_KEY": "<YDC_API_KEY>",
"SEARCH_RESULT_FIELDS": "<SEARCH_RESULT_FIELDS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from searxncrawl <команда>
Командой платформы
gemini mcp add -e SEARXNG_URL=<SEARXNG_URL> -e SEARXNG_USERNAME=<SEARXNG_USERNAME> -e SEARXNG_PASSWORD=<SEARXNG_PASSWORD> -e YDC_API_KEY=<YDC_API_KEY> -e SEARCH_RESULT_FIELDS=<SEARCH_RESULT_FIELDS> searxncrawl uvx searxncrawlВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from searxncrawl <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о searxNcrawl
Как установить searxNcrawl в Claude Code?
Выполните claude mcp add searxncrawl -e SEARXNG_PASSWORD=<SEARXNG_PASSWORD> -e YDC_API_KEY=<YDC_API_KEY> -- uvx searxncrawl. Есть и вариант с большим числом переменных: `claude mcp add --env SEARXNG_URL=<SEARXNG_URL> --env SEARXNG_USERNAME=<SEARXNG_USERNAME> --env SEARXNG_PASSWORD=<SEARXNG_PASSWORD> --env YDC_API_KEY=<YDC_API_KEY> --env SEARCH_RESULT_FIELDS=<SEARCH_RESULT_FIELDS> --transport stdio searxncrawl -- uvx searxncrawl`.
Что делает searxNcrawl?
Ищет в вебе через SearXNG и You.com и обходит страницы или целые сайты, отдавая агенту чистый Markdown вместо HTML. Работает и как CLI, и как Python-библиотека.
Нужен ли ключ API для поиска?
Со своим SearXNG ключ не нужен, но у инстанса должен быть включён JSON-вывод. Для You.com понадобится YDC_API_KEY. Краулинг работает и без провайдеров поиска.
