SerpApi MCP

SerpApi MCP Сервер

Реализация сервера Model Context Protocol (MCP), интегрирующаяся с SerpApi для получения комплексных результатов поисковых систем и извлечения данных.

Возможности

• Мультипоисковые системы: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay и другие
• Ресурсы поисковых систем: Схемы параметров для каждой системы доступны через ресурсы MCP (см. Search Tool)
• Погода в реальном времени: Погода по местоположению с прогнозами через поисковые запросы
• Данные фондового рынка: Финансовые показатели компаний и рыночные данные через поисковую интеграцию
• Динамическая обработка результатов: Автоматическое определение и форматирование различных типов результатов
• Гибкие режимы ответа: Полные или компактные JSON-ответы
• JSON-ответы: Структурированный вывод JSON в полном или компактном режиме
• Интерактивный UI (MCP Apps): Опциональные инструменты search_table и search_dashboard, отображающие результаты в виде интерактивного интерфейса в поддерживающих хостах

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

SerpApi MCP Сервер доступен как хостинговый сервис по адресу mcp.serpapi.com. Для подключения к нему необходимо предоставить API-ключ. Найти свой API-ключ можно в панели управления SerpApi.

Вы можете настроить Claude Desktop для использования хостингового сервера:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Также можно добавить хостинговый сервер в следующие MCP-клиенты:

OpenClaw

openclaw mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-http

Claude Code

claude mcp add --transport http serpapi https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Hermes

hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Codex

codex mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Самостоятельный хостинг

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

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

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Получите свой API-ключ: serpapi.com/manage-api-key

Аутентификация

Поддерживаются два метода:

• На основе пути: /YOUR_API_KEY/mcp (рекомендуется)
• На основе заголовка: Authorization: Bearer YOUR_API_KEY

Примеры:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

Инструмент поиска

MCP-сервер имеет один основной инструмент поиска, поддерживающий все поисковые системы SerpApi и типы результатов. Все доступные параметры можно найти в справочнике SerpApi API. Схемы параметров поисковых систем также доступны как ресурсы MCP: serpapi://engines (индекс) и serpapi://engines/<engine>.

Предоставляемые параметры специфичны для каждого API поисковой системы. Ниже приведены некоторые примеры параметров:

• params.q (обязательный): Поисковый запрос
• params.engine: Поисковая система (по умолчанию: "google_light")
• params.location: Географический фильтр
• mode: Режим ответа - "complete" (по умолчанию) или "compact"
• ...другие параметры см. в справочнике SerpApi API

Примеры:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

Поддерживаемые поисковые системы: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay и другие (см. serpapi://engines).

Типы результатов: Блоки ответов, органические результаты, новости, изображения, товары — автоматически определяются и форматируются.

Интерактивный UI (MCP Apps)

Инструмент по умолчанию search возвращает JSON и остается неизменным. Для хостов, поддерживающих расширение MCP Apps (SEP-1865), два опциональных инструмента отображают результаты в виде интерактивного интерфейса прямо в диалоге, так что объемный JSON выдачи не попадает в контекстное окно модели:

• search_table: органические результаты в виде сортируемой таблицы с поиском.
• search_dashboard: сводные метрики, диаграмма разбивки по источникам и таблица результатов с панелью детализации по клику.

Оба принимают те же params, что и search. Хосты, не поддерживающие MCP Apps, просто игнорируют эти инструменты.

Предварительный просмотр локально без MCP-хоста:

uv run fastmcp dev apps src/server.py

Разработка

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

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

• "Отсутствует API-ключ": Включите ключ в путь URL /{YOUR_KEY}/mcp или заголовок Bearer YOUR_KEY
• "Неверный ключ": Проверьте на serpapi.com/dashboard
• "Превышен лимит запросов": Подождите или обновите тарифный план SerpApi
• "Нет результатов": Попробуйте другой запрос или поисковую систему

Участие в разработке

1. Сделайте форк репозитория
2. Создайте ветку для своей функции: git checkout -b feature/amazing-feature
3. Установите зависимости: uv install
4. Внесите изменения
5. Зафиксируйте изменения: git commit -m 'Add amazing feature'
6. Отправьте ветку: git push origin feature/amazing-feature
7. Откройте Pull Request

Лицензия

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