serpapi-mcp

serpapi-mcp

serpapiMIT
141 звёзд34 форков
SerpApi MCP Server — официальный MCP-сервер, созданный командой SerpApi. Он даёт AI-ассистентам доступ к результатам поиска из десятков поисковых систем: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay и других. Вам не нужно писать отдельные API-клиенты для каждого поисковика — достаточно одного сервера. Сервер решает задачу интеграции веб-поиска в приложения на базе больших языковых моделей. Вы можете собирать актуальные данные, проверять факты, мониторить цены, получать погоду и информацию о фондовом рынке — всё в реальном времени и в структурированном JSON-формате.
Search
Открыть на GitHub

Характеристики

Общее

  • СтатусСообщество
  • Разработчикserpapi
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    sse

Описание

Возможности

  • Поиск по всем основным поисковым системам: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay и более десяти других специализированных движков (Google Scholar, Shopping, Images, News и т.д.).
  • Запрос погоды по местоположению: текущая температура, влажность, ветер, почасовой и дневной прогноз.
  • Получение данных о компаниях и фондовом рынке: котировки акций, финансовые отчёты, мультипликаторы.
  • Автоматическое определение типа результата — сервер сам распознаёт новости, изображения, видео, товары, локальные результаты и форматирует их соответствующим образом.
  • Гибкий формат ответа: полный JSON со всеми полями или компактный режим с ключевыми данными.
  • Доступ к схеме параметров каждого движка через MCP-ресурсы — вы можете узнать, какие параметры поддерживает конкретный поисковик.
  • Два способа аутентификации: через URL-путь (с API-ключом в адресе) или через HTTP-заголовок Authorization.
  • Работа в облачной версии (хостинг SerpApi) или локально на вашем сервере.

Как подключить

Зарегистрируйтесь на SerpApi и получите API-ключ (доступен бесплатный тариф).

Облачный способ: добавьте в конфигурацию вашего MCP-клиента (Claude Desktop, VS Code, Cursor) следующую запись:

{ "mcpServers": { "serpapi": { "type": "http", "url": "https://mcp.serpapi.com/ВАШ_КЛЮЧ_API/mcp" } } }

После добавления перезапустите клиент. Сервер готов к запросам.

Самостоятельный хостинг: склонируйте репозиторий и запустите сервер:

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

Затем укажите в конфигурации локальный URL:

{ "mcpServers": { "serpapi": { "type": "http", "url": "http://localhost:8000/ВАШ_КЛЮЧ_API/mcp" } } }

Альтернативно можно передать ключ в заголовке Authorization: Bearer YOUR_API_KEY.

Примеры запросов

«Найди последние новости об искусственном интеллекте на Google News и выведи заголовки за сегодня» — сервер вернёт структурированный список новостей с датами и ссылками.

«Какая погода в Лондоне на этой неделе? Дай почасовой прогноз на пятницу» — получите температуру, влажность, скорость ветра и вероятность осадков.

«Покажи цены на iPhone 16 на eBay, отсортируй по возрастанию цены и верни первые 5 результатов» — результаты с eBay с указанием цены, состояния товара и рейтинга продавца.

«Получи финансовые показатели Microsoft за последний квартал» — данные о выручке, чистой прибыли, EPS, P/E ratio и другие метрики.

Технические детали

  • Язык: Python 3.13+
  • Транспорт: SSE (Server-Sent Events) на базе HTTP
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, VS Code, Cursor и любые другие MCP-совместимые приложения, поддерживающие HTTP-серверы
  • Документация: SerpApi Search Engine APIs

Поделиться