Google Search MCP інтеграційний посібник

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
Багатомовність та багаторегіональність — підтримка параметрів країни та мови
Фільтрація за часовими рамками — фільтрація результатів за днями, тижнями, місяцями, роками

Попередня підготовка

Перед використанням вам потрібно отримати XHuoAPI API Token:

Зареєструйтесь або увійдіть на платформу XHuoAPI
Перейдіть на сторінку Google SERP API
Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

Встановлення та налаштування

Спосіб перший: установка через pip (рекомендується)

pip install mcp-serp

Спосіб другий: установка з вихідного коду

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 Token"
      }
    }
  }
}

Якщо ви використовуєте uvx (не потрібно попередньо встановлювати пакет):

{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Збережіть конфігурацію та перезапустіть Claude Desktop, щоб мати можливість використовувати інструменти пошуку Google в діалозі.

Використання в VS Code / Cursor

У кореневій директорії проекту створіть файл .vscode/mcp.json:

{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Або використовуйте uvx:

{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}

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

Назва інструменту	Опис
`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»
«Пошук технологічних новин за сьогодні»
«Знайти найближчі кафе на карті»

Додаткова інформація

Репозиторій GitHub: XHuoAPI/SerpMCP
Пакет PyPI: mcp-serp
Документація API: API пошукових систем

Documentation Index

​Огляд функцій

​Попередня підготовка

​Встановлення та налаштування

​Спосіб перший: установка через pip (рекомендується)

​Спосіб другий: установка з вихідного коду

​Використання в Claude Desktop

​Використання в VS Code / Cursor

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

​Приклади використання

​Додаткова інформація