Google Search MCP Server (SERP)

Размещённый сервер Model Context Protocol (MCP), который предоставляет Claude, Cursor, Windsurf и любому другому MCP-клиенту восемь инструментов Google Search для чтения без модификации. Получайте живую выдачу SERP с её AI Overview и People Also Ask, выполняйте запрос в Google AI Mode и читайте результаты новостей, покупок, карточек товаров и коротких видео — всё в виде структурированного JSON, без проекта Google Cloud и без настройки поисковой системы.

https://mcp.hasdata.com/api/mcp?apis=google_serp

«SERP» и «Google Search» здесь — одно и то же. Этот сервер возвращает страницы результатов поисковой системы Google, уже разобранные.

Содержание

• Что вам нужно

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

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

• Инструменты

• Ошибки и способы их обработки

• Цены, бесплатный тариф и лимиты

• Выбор инструмента

• Сравнение с другими

• FAQ

• Ссылки HasData

• Разработка

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

• Лицензия

Related MCP server: Serper Search MCP Server

Что вам нужно

MCP-клиент, который говорит по протоколу streamable HTTP с пользовательскими заголовками. Ключ API HasData из панели управления, бесплатный для создания без карты, а пробный период покрывает примерно 100–200 вызовов в зависимости от инструмента. Больше ничего. Это удалённый сервер, поэтому самый простой путь — URL и заголовок, без проекта Google Cloud и Programmable Search Engine, которые нужно настраивать. Клиент, работающий только со stdio, может вместо этого использовать лаунчер @hasdata/google-search-mcp (npm) или hasdata-google-search-mcp (PyPI).

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

URL сервера одинаков для всех клиентов. Мы запускаем его в Claude Code и Claude Desktop. Остальные блоки следуют задокументированному формату удалённого сервера для каждого клиента.

Клиенты с поддержкой OAuth могут добавить тот же URL как коннектор и войти, не помещая ключ в конфигурационный файл.

claude mcp add --transport http google-search "https://mcp.hasdata.com/api/mcp?apis=google_serp" \
  --header "x-api-key: HASDATA_API_KEY"

Claude Desktop загружает из своего конфигурационного файла только локальные (stdio) серверы, поэтому он подключается к удалённому серверу через stdio-лаунчер. Этот лаунчер — пакет @hasdata/google-search-mcp, который читает ключ из окружения.

claude_desktop_config.json:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-search-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Нужен Python вместо Node? Замените лаунчер на пакет PyPI, который uvx запускает без ручной установки:

{
  "mcpServers": {
    "google-search": {
      "command": "uvx",
      "args": ["hasdata-google-search-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Клиент с поддержкой OAuth вместо этого может добавить URL как пользовательский коннектор и пропустить лаунчер.

.cursor/mcp.json:

{
  "mcpServers": {
    "google-search": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "google-search": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

.vscode/mcp.json:

{
  "servers": {
    "google-search": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.gemini/settings.json:

{
  "mcpServers": {
    "google-search": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

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

Найди в Google best running shoes и выдай мне органическую десятку плюс AI Overview.

Один запрос, 10 кредитов. Ответ SERP содержит AI Overview встроенным плагином вместе с органическими результатами.

Для этого же запроса возьми каждый вопрос из People Also Ask и достань из его AI Overview ответ с источниками.

Один запрос на каждый вопрос, 5 кредитов за каждый. Каждая запись relatedQuestions содержит aiOverview.pageToken, и инструмент AI Overview превращает этот токен в блоки ответа и ссылки на источники.

Спроси Google AI Mode what is the Model Context Protocol и выдай ответ с его ссылками.

Один запрос, 10 кредитов. AI Mode возвращает сгенерированный ответ в виде текстовых блоков со списком ссылок.

Выполни Google Shopping с запросом nike air max, затем открой полную карточку товара верхнего результата: каждый магазин, где он продаётся, диапазон цен и разбивку отзывов.

Два запроса. Shopping стоит 10 кредитов и возвращает токен на каждый товар, а полный инструмент карточки тратит 5, чтобы развернуть этот токен в список магазинов, варианты и отзывы.

Получи последние новости Google для artificial intelligence, а отдельно — результаты коротких видео для cooking pasta.

Два запроса, по 10 кредитов каждый.

Рабочий процесс держится на двух цепочках. Ответ SERP содержит aiOverview встроен прямо в него, а pageToken — на каждом вопросе из People Also Ask, поэтому извлечение генеративных ответов Google либо бесплатно вместе с поиском, либо выполняется одним дополнительным запросом по 5 кредитов на каждый вопрос. Результат Shopping, в свою очередь, возвращает токен на каждый товар, так что переход от списка к полной карточке со всеми магазинами — один запрос.

Ещё цепочка — AI Overview. Один Ответ SERP отдаёт pageToken на каждом вопросе из People Also Ask, а следующий запрос AI Overview превращает его в ответ с источниками.

Инструменты

Восемь инструментов, все только для чтения. Примеры ниже сокращены из реальных запросов, и результаты в них меняются вместе с Google, так что рассматриваете их как структуру. Название каждого инструмента является ссылкой на справочник конечной точки.

Примеры показывают содержимое, а не весь ответ. Результат tools/call содержит едиственный текстовый блок, и этот текст сам является JSON, в котором есть url, status, text и json, а извлечённые данные лежат в json. В сыром ответе JSON-RPC путь result.content[0].text; его нужно распарсить, и затем взять .json. Чат-клиент делает это разворачивание сам, а код, взаимодействующий с точкой напрямую, — нет.

Google SERP

hasdata_google_serp_serp_getSearchResults

Полная страница результатов для запроса.

Возвращает searchInformation, organicResults, aiOverview, relatedQuestions, relatedSearches, perspectives, immersiveProducts и pagination — те блоки, которые Google показывает для данного запроса. Органические записи содержат position, title, link, displayedLink, source, snippet, snippetHighlitedWords, date и images.

AI Overview приходит двумя способами. Обычно aiOverview является встроенным, с textBlocks и references, которые можно читать сразу. Иногда Google прячет его за токеном, и тогда aiOverview содержит pageToken и hasdataLink вместо блоков. Каждая запись relatedQuestions относится ко второму случаю. Она содержит question и объект aiOverview с тот same pageToken и hasdataLink, которые разворачивает инструмент AI Overview ниже. Так что ответы из People Also Ask — это те же AI Overview, которые вы запрашиваете по одному токену за раз. Верхний aiOverview на большинстве запросов встроен, а на некоторых — это токен, так что читайте его двумя способами.

{
  "organicResults": [
    {
      "position": 1,
      "title": "The 15 Best Running Shoes of 2026",
      "link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
      "source": "Runner's World",
      "snippet": "The Brooks Ghost is our No. 1 shoe when we recommend new trainers…"
    }
  ],
  "aiOverview": {
    "textBlocks": [ { "type": "paragraph", "snippet": "The best running shoes depend on your goal…" } ],
    "references": [ { "index": 0, "title": "7 Best Running Shoes in 2026 - RunRepeat", "link": "https://runrepeat.com/guides/best-running-shoes" } ]
  },
  "relatedQuestions": [
    { "question": "What are the top 5 best running shoes?", "aiOverview": { "pageToken": "eyJpZCI6…", "hasdataLink": "https://api.hasdata.com/scrape/google/ai-overview?pageToken=eyJpZCI6…" } }
  ],
  "pagination": { "next": "…" }
}

AI Overview

hasdata_google_serp_ai_overview_getAiOverviewResponse

Разворачивает токен AI Overview в сам ответ.

Возвращает aiOverview с textBlocks и references. Так нужно читать AI Overview, когда SERP отдал вам не блоки, а токен, и так вы превращаете каждый вопрос People Также задайте вопрос в ответ с ссылками на источники.

Тoxin действует примерно 4 минуты. просрочивший токен не остается пустым — он приводит к ошибке инструмента: isError: true, с текстом HasData API error: 400 Bad Request. Обрабатывайте это так же, явкак при ошибке ключа, и перезапустите SERP / чтобы получить свежий токен.

{
  "aiOverview": {
    "textBlocks": [ { "type": "paragraph", "snippet": "The top five running shoes feature versatile options for daily training and racing…" } ],
    "references": [ { "index": 0, "title": "…", "link": "https://…" } ]
  }
}

Google AI Mode

hasdata_google_serp_ai_mode_getAiModeResponse

Ответ Google AI Mode на запрос — это разговорный поисковой результат.

Возвращает textBlocks и references — сгенерированный ответ и источники, на которые он ссылается.

Google SERP Search

hasdata_google_serp_serp_light_getSearchResults

Более дешёвый поиск, который возвращает ядро страницы.

Возвращает organicResults, aiOverview, relatedSearches, filters, appliedLocation, searchInformation и pagination. Это стоит половину кредитов полного SERP для тех случаев, когда нужны органические результаты и AI Overview без лишних блоков.

Google News

hasdata_google_serp_news_getGoogleNews

Результаты Google News по запросу или новостному разделу.

Возвращает newsResults, menuLinks, relatedTopics и relatedPublications. Каждая новостная запись содержит position, title, link, source с name и icon, а также thumbnail и date.

Google Shopping

hasdata_google_serp_shopping_getSearchResults](https://docs.hasdata.com/apis/google-serp/shopping?utm_source=github\\\\&utm_medium=syndication\\\\&utm_campaign=google-search-mcp)

Результаты покупок по запросу.

Возвращает shoppingResults, filters, refineSearchFilters, searchInformation и pagination. Каждая запись содержит position, title, productId, price, extractedPrice, rating, reviews, source, category, thumbnail и immersiveProductPageToken.

immersiveProductPageToken передаётся в инструмент иммерсивного продукта ниже. Это временный токен, поэтому разворачивайте его, пока он ещё свежий, если нужны данные товара. Если старый токен перестал работать, просто повторите запрос покупок и получите новый.

{
  "shoppingResults": [
    {
      "position": 1,
      "title": "Men's Nike Alphafly 3",
      "productId": "13366226642799457284",
      "price": "$285.00",
      "extractedPrice": 285,
      "rating": 4.5,
      "reviews": 120,
      "source": "Nike",
      "immersiveProductPageToken": "eyJyZHMiOiJQQ18…"
    }
  ]
}

Иммерсивный продукт

hasdata_google_serp_immersive_product_getImmersive_e29f691177

Полная карточка товара, скрытая за результатом покупок.

Возвращает объект productResults с title, brand, rating, reviews, priceRange, массивом stores по каждому продавцу с его ценой и ссылкой, а также variants, reviewsImages, userReviews, topInsights, aboutTheProduct и discussionsAndForums. Это единственный вызов, который превращает одно объявление в полную картину по всем магазинам.

{
  "productResults": {
    "title": "Men's Nike Alphafly 3",
    "brand": "Nike",
    "rating": 4.4,
    "reviews": 1077,
    "priceRange": "$221-$295",
    "stores": [ { "name": "eBay", "link": "https://www.ebay.com/itm/…", "price": "$221" } ],
    "storesNextPageToken": "Mw=="
  }
}

Передавайте storesNextPageToken обратно в параметр nextPageToken, чтобы пролистывать магазины.

Короткие видео Google

`hasdata_google_serp_short_videos_getShortVideosSearchResults

Результаты по коротким видео, которые Google показывает для запроса.

Возвращает shortVideos — каждый элемент содержит position, title, link, source, sourceLogo, profileName, duration, clip и thumbnail.

Ошибки и пути к их возникновению

Ваш клиент почти никогда не видит HTTP-код ошибки от вызова инструмента. Слой MCP отвечает 200, а сам сбой помещает внутрь результата: isError установлено в true, причина указана текстом. Агент читает сообщение там, где вы могли бы ожидать строку состояния.

Неправильный ключ проявляется как вывод инструмента, а не как неудачное подключение. Перечисление инструментов принимает любой непустой ключ, и клиент завершает рукопожатие со статусом успеха. Первый же вызов инструмента возвращает isError: true и текст HasData API error: 401 Unauthorized. Ищите именно эту строку, потому что ничто более ранее в потоке не сообщит о проблеме.

Единственная реальная HTTP-ошибка — отсутствующий ключ. Авторизация выполняется до любого инструмента, и само соединение падает с ошибкой 401.

Аргумент, нарушающий схему, отклоняется до того, как станет поиском. Поиска без q отсутствует и возвращает isError: true и текст MCP error -32602: Input validation error с именем поля. Ничего не загружается и не списывается.

Устаревший AI Overview-токен приводит к ошибке. Токен ответа SERP действителен около 4 минут. Если попытаться развернуть сохранённый ранее токен, вы получите isError: true и текст HasData API error: 400 Bad Request — так же, как при неверном ключе. Заметив это, повторно выполните SERP, чтобы получить свежий токен.

Блок, который Google не показал, — отсутствует, а не пуст. Запрос без AI Overview, без панели покупок или без «Люди также спрашивают» возвращает ответ без этих ключей, а не с пустыми ключами. Проверяйте ключ перед чтением.

Если результат содержит данные, в нём также будет requestMetadata.id, который стоит цитировать при обращениях в поддержку, плюс ссылки html и json на сохранённый артефакт именно этого вызова.

Цены, бесплатный тариф и лимиты

Кредиты списываются за каждый инструмент. Полный SERP, AI Mode, News, Shopping и короткие видео стоят 10 кредитов за вызов. SERP Light, иммерсивный продукт и инструмент AI Overview по 5 кредитов. AI Overview, входящий в ответ SERP, бесплатен — он часть этого вызова за 10 кредитов. Но разворачивание токена через инструмент AI Overview, включая каждый токен «Люди также спрашивают», — отдельный вызов за 5 кредитов. Размер ответа не влияет на цену.

Бесплатный триал — 1,000 кредитов на 30 дней без карты: это 100 вызовов полного SERP или 200 вызовов по 5 кредитов. После этого активный аккаунт ежедневно получает 100 кредитов, когда остаток становится ниже 100, поэтому агент с небольшим трафиком может работать на бесплатном тарифе бессрочно.

Платные тарифы начинаются от 49 $ в месяц за 200,000 кредитов. Цена кредита снижается с объёмом, актуальные цифры — на странице тарифов.

Тариф также определяет параллельность. Пробная версия разрешает 1 запрос за раз, для Startup — 15, для Business — 30, для Growth — 50, а для высокообъёмных тарифов — от 200 до 1,500. Parallelity — единственный ограничитель, отдельного лимита запросов в минуту нет. Берегите обработку переполнения в любом автоматическом режиме, потому что агент, разветвляющийся на множество запросов, упрётся в потолок раньше вас.

Выбор инструментов

Параметр ?apis=google_serp включает эти восемь инструментов. Он принимает список: ?apis=google_serp,google_maps добавит инструменты Google Maps к поиску. Если параметр опущен, вы получите всё, что предоставляет HasData — сейчас это 57 инструментов.

Обычно лучший вариант — узкий список. Модели, выбирающая из восьми инструментов, чаще делает правильный выбор, чем модель, выбирающая из пятидесяти семи. Кроме того, сами описания инструментов занимают контекст на каждом шаге.

Как это устроено

Google больше не предоставляет универсальный поисковый API. Официальный путь — Custom Search JSON API, и он отвечает на другой вопрос, чем этот инструмент.

Custom Search JSON API ищет по управляемому вами программируемому поисковому движку (Programmable Search Engine), работающий либо по указанным сайтам, либо по всему веб-индексу, если вы это включите. У него 100 бесплатных запросов в день, дальше или тариф за тысячу запросов до суточной наценки, и он возвращает усечённый набор результатов. Он не возвращает AI Overview, «Люди также спрашивают», локал-пак, Shopping, News`а и короткие видео — потому что это функции живой страницы результатов, а не API. Он подходит, когда нужно искать по собственному сайту или фиксированному набору сайтов и оставаться в рамках официальных условий Google.

Этот сервер возвращает живую страницу результатов Google такой, какой видит её пользователь, после парсинга. Настраивать ничего не нужно: запрос уходит ко всей выдачи Google, а не к ручному движку, и AI Overview, People Also Ask, покупки и прочее возвращаются структурированными блоками.

Две строки определяют выбор. Если нужно искать только по своим сайтам и для этого нужен официальный API Google — подходит Custom Search JSON API. Если нужен реальный SERP, его AI Overview или любые панели из живой выдачи, то официальный API их вернуть не может, а этот инструмент может.

Что этот сервер не делает. Не обходит страницы кэшей за результатами, не хранит историю ранжирования, ничего не пишет. Он возвращает только расписанную страницу результатов.

Ответы на вопросы

Что такое Google Search MCP server?

Как Google Search MCP server? Google Search MCP server — это инструмент, который подключает языковую модель (например, Claude Desktop) к данным поиска Google в МСП. Через него вы получаете живые результаты Google — поискующие результаты, AI Overview, товары, новости и «Ллюди также спрашивают» — прямо в интерфейсе агента.

Сервер, который предоставляет результаты поиска Google как инструменты, которые может вызывать ИИ-клиент. Клиент отправляет вызов инструмента через Model Context Protocol, сервер загружает страницу результатов и возвращает структурированный JSON, а модель работает с результатом и никогда не видит HTML-страницу. Этот сервер предоставляет восемь инструментов только для чтения и работает удалённо, поэтому клиент подключается по URL и не запускает локальный процесс.

SERP здесь — то же самое, что Google Search?

Да. SERP — это страница результатов поисковой системы. Эти инструменты возвращают страницы результатов Google, поэтому «SERP API» и «Google Search API» в этом репозитории означают одно и то же.

Есть ли официальный MCP-сервер Google Search?

Google не публикует ни MCP-сервер, ни общий поисковый API. Ближайший официальный продукт — Custom Search JSON API, который выполняет поиск по Programmable Search Engine, настраиваемой вами. Некоторые MCP-серверы сообщества, в том числе этот, вместо этого возвращают живую страницу результатов.

Как получить AI Overview?

Выполните SERP-вызов. Обычно aiOverview приходит встроенным вместе со своими textBlocks и references. Если вместо этого он возвращается как pageToken, а также для каждого вопроса из блока People Also Ask, передайте этот токен инструменту AI Overview, чтобы получить ответ. Токены истекают быстро, поэтому разворачивайте их из свежего вызова.

Нужен ли мне проект Google Cloud или Programmable Search Engine?

Нет. Для доступа нужен только ваш ключ HasData. В Google Cloud не нужно ничего создавать, и отдельную квоту API настраивать не требуется.

Истекает ли срок действия API-ключа?

Нет. Ключ не истекает. Замените его в панели управления, когда понадобится.

Данные в реальном времени или кэшируются?

В реальном времени. Каждый вызов получает страницу результатов в момент запроса и содержит собственный requestMetadata.id. Два одинаковых вызова — это два отдельных запроса, а не воспроизведение сохранённой копии.

Этот сервер связан с Google?

Нет. HasData — независимый сервис и не связан с Google, не одобрен им и не спонсируется им. Google — товарный знак своего владельца. Инструменты работают только с общедоступными данными, и вы несёте ответственность за использование результатов в соответствии с условиями Google и применимым законодательством.

Ссылки HasData

Разработка

Этот репозиторий содержит конфигурацию и документацию для удалённого сервера. Здесь нет этапа сборки и нечего собирать в контейнер.

При этом в нём есть контрактный тест. В README описаны восемь инструментов с конкретными параметрами, а вышестоящий список инструментов может измениться без коммита в этот репозиторий, и тогда этот файл незаметно начнёт вводить вас в заблуждение. Тест проверяет, что описанные инструменты существуют с заявленными параметрами, и выполняется в CI еженедельно, а также при каждом push.

HASDATA_API_KEY=your_key_here npm test

В PowerShell:

$env:HASDATA_API_KEY = "your_key_here"; npm test

Последняя проверка выполняет реальный поиск и стоит 10 кредитов — это цена канарейки, которая может упасть по правильной причине. Список инструментов успешно возвращается с любым непустым ключом, поэтому тест, который только перечисляет инструменты, останется зелёным даже с отозванным ключом.

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

Самый полезный вклад — исправления в таблицах инструментов и примерах ответов, потому что именно эти части со временем расходятся с реальностью. Приводите сделанный вами вызов и полученный ответ. Pull request из форков запускает набор тестов без ключа, а живые проверки пропускаются, а не падают в красный.

Лицензия

MIT. См. LICENSE.