MCP-сервер SerpApi

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

Возможности

• Поиск по нескольким системам: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay и другие

• Ресурсы движков: Схемы параметров для каждого движка доступны через ресурсы MCP (см. инструмент поиска)

• Данные о погоде в реальном времени: Погода с учетом местоположения и прогнозы через поисковые запросы

• Данные фондового рынка: Финансовые показатели компаний и рыночные данные через интеграцию с поиском

• Динамическая обработка результатов: Автоматическое обнаружение и форматирование различных типов результатов

• Гибкие режимы ответа: Полные или компактные JSON-ответы

• JSON-ответы: Структурированный вывод в формате JSON с полным или компактным режимом

Related MCP server: SearXNG MCP Server

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

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

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

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "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 и типы результатов. Вы можете найти все доступные параметры в справочнике API SerpApi. Схемы параметров движков также представлены как ресурсы MCP: serpapi://engines (индекс) и serpapi://engines/<engine>.

Параметры, которые вы можете предоставить, зависят от каждого API-движка. Некоторые примеры параметров приведены ниже:

• params.q (обязательно): Поисковый запрос

• params.engine: Поисковая система (по умолчанию: "google_light")

• params.location: Географический фильтр

• mode: Режим ответа - "complete" (по умолчанию) или "compact"

• ...см. другие параметры в справочнике API SerpApi

Примеры:

{"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).

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

Разработка

# 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"

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

• "Missing API key": Укажите ключ в пути URL /{YOUR_KEY}/mcp или в заголовке Bearer YOUR_KEY

• "Invalid key": Проверьте на serpapi.com/dashboard

• "Rate limit exceeded": Подождите или обновите свой тарифный план SerpApi

• "No results": Попробуйте другой запрос или поисковую систему

Вклад в проект

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.