🚀 OneSearch MCP Server: Поиск в Интернете, обход, парсинг и подготовка контента

Реализация сервера протокола контекста модели (MCP), которая интегрируется с несколькими поисковыми провайдерами для поиска в Интернете, локального поиска в браузере и возможностей парсинга с помощью agent-browser.

Функции

• Поиск в Интернете, парсинг, обход и предварительная обработка контента с веб-сайтов.

• Поддержка нескольких поисковых систем и веб-парсеров: SearXNG, Tavily, DuckDuckGo, Bing, Google, Zhipu (智谱), Exa, Bocha (博查) и др.

• Локальный поиск в Интернете (поиск через браузер), поддержка нескольких поисковых систем: Bing, Google, Baidu, Sogou и др.

  • Использование agent-browser для автоматизации браузера.

  • Бесплатно, ключи API не требуются.

• Включенные инструменты: one_search, one_scrape, one_map, one_extract

Related MCP server: Firecrawl MCP Server

Миграция с версии 1.1.0 и более ранних

Критические изменения в версии 1.1.0:

• Firecrawl удален: Интеграция с Firecrawl была удалена в пользу agent-browser, который предоставляет аналогичную функциональность без необходимости использования внешних API-сервисов.

• Новое требование к браузеру: Вы должны установить браузер Chromium (см. раздел «Предварительные требования»).

• Переменные окружения: FIRECRAWL_API_URL и FIRECRAWL_API_KEY больше не используются.

Что изменилось:

• one_scrape и one_map теперь используют agent-browser вместо Firecrawl

• one_extract теперь выполняет предварительную обработку контента страниц с нескольких URL для последующего анализа, вместо выполнения встроенного извлечения через LLM

• Все операции на основе браузера теперь выполняются локально, что обеспечивает лучшую конфиденциальность и отсутствие затрат на API

Шаги миграции:

1. Установите браузер Chromium (см. «Предварительные требования»)

2. Удалите FIRECRAWL_API_URL и FIRECRAWL_API_KEY из ваших переменных окружения

3. Обновитесь до последней версии: npm install -g one-search-mcp@latest

Предварительные требования

Требование к браузеру: Этот сервер использует agent-browser для веб-парсинга и локального поиска, что требует браузер на базе Chromium.

Хорошие новости: Сервер автоматически обнаружит и будет использовать браузеры, уже установленные в вашей системе:

• ✅ Google Chrome

• ✅ Microsoft Edge

• ✅ Chromium

• ✅ Google Chrome Canary

Если у вас не установлен ни один из этих браузеров, вы можете:

# Option 1: Install Google Chrome (Recommended)
# Download from: https://www.google.com/chrome/

# Option 2: Install Microsoft Edge
# Download from: https://www.microsoft.com/edge

# Option 3: Install Chromium via agent-browser
npx agent-browser install

# Option 4: Install Chromium directly
# Download from: https://www.chromium.org/getting-involved/download-chromium/

Установка

Использование CLI Claude Code (рекомендуется)

# 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

Ручная установка

# Install globally (Optional)
npm install -g one-search-mcp

# Or run directly with npx
npx -y one-search-mcp

Использование Docker

Образ Docker включает все зависимости (браузер Chromium), предварительно установленные, дополнительная настройка не требуется.

Загрузите образ:

# From GitHub Container Registry
docker pull ghcr.io/yokingma/one-search-mcp:latest

# Or from Docker Hub
docker pull zacma/one-search-mcp:latest

Настройка в Claude Desktop:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/yokingma/one-search-mcp:latest"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

С пользовательским поисковым провайдером:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARCH_PROVIDER=tavily",
        "-e", "SEARCH_API_KEY=your_api_key",
        "ghcr.io/yokingma/one-search-mcp:latest"
      ]
    }
  }
}

Переменные окружения

Поисковая система:

• SEARCH_PROVIDER (опционально): Поисковый провайдер для использования, поддерживает searxng, duckduckgo, bing, tavily, google, zhipu, exa, bocha, local, по умолчанию local.

• SEARCH_API_URL (опционально): URL API SearxNG или идентификатор поисковой системы Google (Custom Search Engine ID) для google.

• SEARCH_API_KEY (опционально): Ключ API для поискового провайдера, требуется для tavily, bing, google, zhipu, exa, bocha.

// supported search providers
export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'google' | 'zhipu' | 'exa' | 'bocha' | 'local';

Конфигурация поискового провайдера

Конфигурация для других MCP-клиентов

Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Cursor

Добавьте в ваш файл mcp.json:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Windsurf

Добавьте в ваш файл ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Самохостинг SearXNG (опционально)

Если вы хотите использовать SearXNG в качестве поискового провайдера, вы можете развернуть его локально с помощью Docker:

Предварительные требования:

• Установленный и запущенный Docker (версия 20.10.0 или выше)

• Доступно не менее 4 ГБ оперативной памяти

Быстрый старт:

# Clone SearXNG Docker repository
git clone https://github.com/searxng/searxng-docker.git
cd searxng-docker

# Start SearXNG
docker compose up -d

После развертывания SearXNG будет доступен по адресу http://127.0.0.1:8080 по умолчанию.

Настройте OneSearch для использования SearXNG:

# Set environment variables
export SEARCH_PROVIDER=searxng
export SEARCH_API_URL=http://127.0.0.1:8080

Для получения дополнительной информации см. официальную документацию SearXNG Docker.

Устранение неполадок

Ошибка «Browser not found»

Если вы видите ошибку вроде «Browser not found», сервер не смог обнаружить ни одного установленного браузера на базе Chromium. Пожалуйста, установите один из следующих:

• Google Chrome: https://www.google.com/chrome/

• Microsoft Edge: https://www.microsoft.com/edge

• Chromium: https://www.chromium.org/getting-involved/download-chromium/

Или установите через agent-browser:

npx agent-browser install

Лицензия

Лицензия MIT — подробности см. в файле LICENSE.