one-search-mcp
one-search-mcp — MCP-сервер сообщества (автор — yokingma). Веб-поиск, поиск URL, скрапинг и извлечение данных. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- yokingma
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Открывает страницы в браузере и обращается к поисковикам; ALLOW_PRIVATE_NETWORK=true разрешает доступ к внутренним адресам — только в доверенной среде.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"one-search-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"one-search-mcp\"],\n \"env\": {\n \"SEARCH_PROVIDER\": \"local\"\n }\n }\n }\n}",
"file": "mcp.json",
"lang": "json",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
OneSearch MCP Server — MCP-сервер для веб-поиска, поиска ссылок на сайте, скрапинга и подготовки контента для модели. Он работает с несколькими поисковыми системами и умеет искать локально через браузер, без ключей API. Браузерная автоматизация выполняется через agent-browser на Chromium.
Четыре инструмента:
one_search— результаты поиска от выбранного провайдера.one_map— поиск ссылок: открывает стартовую страницу в браузере и извлекает ссылки из её HTML. Параметры:url,search,includeSubdomains,limit. Это не обход карты сайта.one_scrape— скрапинг одной страницы в форматах markdown, html, rawHtml, links, снимок экрана или снимок всей страницы. Перед сбором можно выполнить ограниченные действия: ожидание, клик, ввод текста, нажатие клавиши, прокрутку. Выполнение JavaScript на странице (executeJavascript) требует явного флагаallowExecuteJavascript: true.one_extract— принимает список URL и возвращает предобработанные текстовые блоки для дальнейшего анализа моделью или другими инструментами.
Провайдеры поиска (SEARCH_PROVIDER): local (по умолчанию, бесплатно, через браузер по Bing, Google, Baidu, Sogou), duckduckgo (бесплатно), searxng (собственный метапоисковик), а также bing, tavily, google, zhipu, exa, bocha и ydc (You.com) с ключами API.
С версии 1.1.0 интеграция с Firecrawl удалена: скрапинг и поиск ссылок выполняются локально в браузере, без внешних сервисов и затрат на API. Переменные FIRECRAWL_API_URL и FIRECRAWL_API_KEY больше не используются.
Кому подойдёт
- Пользователям, которым нужен бесплатный веб-поиск для ассистента без ключей.
- Исследователям и аналитикам, собирающим материалы с сайтов в markdown.
- Тем, кто держит свой SearXNG и хочет подключить его к агенту.
Похожие серверы — в категории браузер и парсинг.
Установка
Нужен браузер на Chromium: сервер сам найдёт установленные Google Chrome, Microsoft Edge, Chromium или Chrome Canary; иначе выполните npx agent-browser install. Запуск — npx -y one-search-mcp или глобальная установка npm install -g one-search-mcp. Docker-образ ghcr.io/yokingma/one-search-mcp:latest уже содержит Chromium. Для SearXNG задайте SEARCH_API_URL, для платных провайдеров — SEARCH_API_KEY (для You.com — YDC_API_KEY).
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
# Add to Claude Code with default settings (local search)
claude mcp add one-search-mcp -- npx -y one-search-mcp
# Add with custom search provider (e.g., SearXNG)
claude mcp add one-search-mcp -e SEARCH_PROVIDER=searxng -e SEARCH_API_URL=http://127.0.0.1:8080 -- npx -y one-search-mcp
# Add with Tavily API
claude mcp add one-search-mcp -e SEARCH_PROVIDER=tavily -e SEARCH_API_KEY=your_api_key -- npx -y one-search-mcpКонфиг Claude Desktop лежит в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS и %APPDATA%\Claude\claude_desktop_config.json в Windows. Тот же JSON README приводит для Cursor (mcp.json) и Windsurf.
Проверка
Попросите ассистента найти что-нибудь в интернете — должен сработать one_search. Ошибка «Browser not found» означает, что не найден браузер на Chromium.
Примеры задач
Найди последние новости о выпуске Node.js 24 и кратко перескажи три главных изменения.Собери все ссылки с раздела документации example.com и извлеки текст пяти первых страниц.Риски
- Сеть и внутренние адреса. По умолчанию браузерные инструменты не обращаются к частным, loopback и link-local адресам. Переменную
ALLOW_PRIVATE_NETWORK=trueвключайте только в доверенной среде: иначе внедрённая в страницу инструкция может заставить сервер запросить внутренние сервисы. - JavaScript на страницах. Выполнение скриптов на чужих страницах требует явного флага — не включайте его без необходимости.
- Ключи провайдеров храните в переменных окружения.
Частые вопросы
Нужны ли ключи API?
Нет: провайдеры local и duckduckgo бесплатны; ключи нужны только для платных поисковиков.
Почему сервер требует браузер?
Скрапинг, поиск ссылок и локальный поиск выполняются в Chromium через agent-browser.
Работает ли ещё Firecrawl?
Нет, интеграция удалена в версии 1.1.0.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
browser-use
Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.
Fetch
Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.
Chrome DevTools MCP
Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.
browser
Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.