Serpex MCP

Сервер Model Context Protocol (MCP), который предоставляет возможность веб-поиска по нескольким поисковым системам через Serpex API. Выполняйте поиск в Google, Bing, DuckDuckGo, Brave, Yahoo и Yandex с автоматическим выбором поискового движка и структурированными JSON-результатами.

Возможности

✅ Поддержка нескольких поисковых систем: Доступ к 6 поисковым системам (Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex)
✅ Автоматическая маршрутизация: Автоматически выбирает лучшую доступную поисковую систему
✅ Фильтрация по времени: Фильтруйте результаты за день, неделю, месяц или год
✅ Структурированные результаты: Чёткие и согласованные JSON-ответы
✅ Быстро и надёжно: Встроенная обработка капчи и ротация прокси
✅ Простая интеграция: Работает с Claude Desktop, Jan AI и любым MCP-совместимым клиентом\

Related MCP server: Serper Search and Scrape MCP Server

Установка

Быстрый старт (npx - рекомендуется)

Установка не требуется! Используйте npx для запуска напрямую:

npx serpex-mcp

Глобальная установка

npm install -g serpex-mcp

Локальная установка

npm install serpex-mcp

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

С помощью Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "serpex": {
      "command": "npx",
      "args": ["-y", "serpex-mcp"],
      "env": {
        "SERPEX_API_KEY": "your-api-key-here"
      }
    }
  }
}

С другими MCP-клиентами

Любой MCP-совместимый клиент может использовать этот сервер. Настройте его следующим образом:

• Команда: npx

• Аргументы: -y serpex-mcp

• Переменная окружения: SERPEX_API_KEY=your-key

Автономное использование

export SERPEX_API_KEY="your-api-key-here"
serpex-mcp

Доступные инструменты

serpex_search

Осуществляет поиск в вебе с помощью многодвижкового API Serpex. При необходимости загружает полное содержимое страницы (markdown) для лучших результатов прямо в выводе поиска — без гарантий, поэтому проверяйте каждый результат на наличие content или content_error.

Параметры:

• q (обязательный): строка поискового запроса (максимум 500 символов)

• include_content (необязательный, логический): также загружать полное содержимое страницы (markdown) для лучших результатов. Без гарантий — примерно 79% URL результатов возвращают контент; заблокированные страницы или страницы, запрещённые для роботов, возвращают content_error. По умолчанию: false.

• content_results (необязательный, 5 | 10): количество лучших результатов, для которых загружать контент, когда include_content равен true. Должно быть ровно 5 или 10. По умолчанию: 5.

Пример:

{
  "q": "artificial intelligence trends 2025",
  "include_content": true,
  "content_results": 5
}

Ответ (JSON, в виде текстового вывода инструмента) содержит счётчики content_requested / content_delivered и для каждого результата — content при успехе или content_error при ошибке — оба ключа опускаются, если контент не запрашивался.

Получение API-ключа

1. Посетите serpex.dev

2. Зарегистрируйте бесплатную учётную запись

3. Получите свой API-ключ в панели управления

4. Используйте его в переменной окружения SERPEX_API_KEY

Информация об API

• Базовый URL: https://api.serpex.dev

• Документация: https://serpex.dev/docs

• Цены: Доступен бесплатный тариф и недорогие платные планы

Разработка

Сборка из исходного кода

git clone https://github.com/divyeshradadiya/serpex-mcp.git
cd serpex-mcp
pnpm install
pnpm build

Запуск тестов

export SERPEX_API_KEY="your-key-here"
pnpm test

Лицензия

MIT

Ссылки

• Сайт Serpex

• Документация Serpex

• Model Context Protocol

• Спецификация MCP