Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) — это протокол контекста модели, разработанный компанией Anthropic, который позволяет AI моделям (таким как Claude, GPT и др.) вызывать внешние инструменты через стандартизированный интерфейс. С помощью SERP MCP Server, предоставляемого XHuoAPI, вы можете выполнять поиск в Google прямо в AI-клиентах, таких как Claude Desktop, VS Code, Cursor и получать результаты поиска веб-страниц, изображений, новостей, видео, мест и т.д.

​
Обзор функций

SERP MCP Server предоставляет следующие основные функции:
  • Поиск веб-страниц — поиск результатов веб-страниц Google
  • Поиск изображений — поиск изображений Google
  • Поиск новостей — поиск новостей Google
  • Поиск видео — поиск видео Google
  • Поиск мест — поиск информации о местах Google
  • Поиск на картах — поиск на картах Google
  • Многоязычность и много регионов — поддержка настраиваемых параметров страны и языка
  • Фильтрация по временным диапазонам — фильтрация результатов по дням, неделям, месяцам, годам

​
Предварительная подготовка

Перед использованием вам необходимо получить токен API XHuoAPI:
  1. Зарегистрируйтесь или войдите на платформу XHuoAPI
  2. Перейдите на страницу Google SERP API
  3. Нажмите «Acquire», чтобы получить токен API (при первом запросе предоставляется бесплатный лимит)

​
Установка и настройка

​
Способ 1: Установка через pip (рекомендуется)

pip install mcp-serp

​
Способ 2: Установка из исходного кода

git clone https://github.com/XHuoAPI/SerpMCP.git
cd SerpMCP
pip install -e .
После завершения установки вы можете использовать команду mcp-serp для запуска сервиса.

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

Отредактируйте файл конфигурации Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Добавьте следующую конфигурацию: 
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API токен"
      }
    }
  }
}
Если вы используете uvx (не требуется предварительная установка пакета): 
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API токен"
      }
    }
  }
}
Сохраните конфигурацию и перезапустите Claude Desktop, чтобы использовать инструменты поиска Google в диалоге.

​
Использование в VS Code / Cursor

Создайте файл .vscode/mcp.json в корневом каталоге проекта: 
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API токен"
      }
    }
  }
}
Или используйте uvx: 
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API токен"
      }
    }
  }
}

​
Список доступных инструментов

Название инструментаОписание
serp_google_searchПоиск веб-страниц Google
serp_google_imagesПоиск изображений Google
serp_google_newsПоиск новостей Google
serp_google_videosПоиск видео Google
serp_google_placesПоиск мест Google
serp_google_mapsПоиск на картах Google

​
Примеры использования

После завершения настройки вы можете напрямую использовать эти функции на естественном языке в AI-клиенте, например:
  • «Помоги мне найти последние статьи по AI»
  • «Найди хорошие рестораны с горячим горшком в Пекине»
  • «Найди изображения по теме асинхронного программирования на Python»
  • «Поиск технологий новостей за сегодня»
  • «Найди ближайшие кафе на карте»

​
Дополнительная информация