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 разрешает доступ к внутренним адресам — только в доверенной среде.

Настройка клиентов

cursor
{
    "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

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники