Google Trends MCP

Локальный MCP-сервер, который позволяет Claude (или любому MCP-клиенту) напрямую работать с Google Trends — интерес к поиску во времени, связанные запросы и темы, разбивка по регионам и актуальные трендовые поисковые запросы — чтобы вы могли проводить маркетинговые исследования прямо в диалоге, а не переключаться на trends.google.com и вставлять обратно скриншоты.

Создан для личных/собственных маркетинговых исследований. Не требует API-ключа: у Google Trends нет официального публичного API, поэтому этот сервер оборачивает pytrends — стандартный неофициальный Python-клиент — в MCP-сервер.

Инструменты

Все инструменты по умолчанию используют geo="IN" (Индия), если не указано иное. Передавайте geo="" для поиска по всему миру или любой ISO-код страны ("US", "GB" и т. д.). timeframe принимает формат pytrends, например "today 12-m", "today 5-y", "now 7-d" или явный диапазон "2024-01-01 2024-06-01".

interest_over_time(keywords, timeframe="today 12-m", geo="IN")

Относительный поисковый интерес (0–100) во времени для до 5 ключевых слов в сравнении друг с другом. Ключевые слова сверх первых пяти молча отбрасываются. Каждая запись содержит isPartial — true в самой свежей точке данных означает, что период ещё не завершён и значение предварительное; не стоит считать падение в этой точке реальным изменением тренда.

related_queries(keyword, timeframe="today 12-m", geo="IN")

Топовые и растущие связанные поисковые запросы для одного ключевого слова. Возвращаются {"top": [...], "rising": [...]}, где каждый из них — список записей вида {"query": ..., "value": ...}. Значения top — относительный интерес 0–100. Значения rising — процентный прирост, за исключением значения 5000%, которое является маркером Google «Breakout» для взрывного роста с почти нулевой базовой точки, а не буквальным процентом.

related_topics(keyword, timeframe="today 12-m", geo="IN")

То же, что и related_queries, но вместо сырых поисковых фраз — кластеры тем (собственные группировки Google). Записи содержат topic_title и topic_type вместе с value. К rising применяется то же правило Breakout.

interest_by_region(keyword, timeframe="today 12-m", geo="IN")

Поисковый интерес по ключевому слову в разбивке по регионам в пределах заданного geo. Возвращает список записей вида {"geoName": ..., "<keyword>": 0-100} — по одной на регион.

trending_now(geo="india")

Лучшие трендовые поисковые запросы дня для одной страны. Обратите внимание: здесь формат geo другой — это полное название страны в нижнем регистре ("india", "united_states"), а не ISO-код, как в остальных четырёх инструментах. Это реальная несогласованность в самих APIgoogle, а не ошибка.

Известное ограничение: на момент написания trending_now возвращает ошибку HTTP 404. Похоже, Google вывел из эксплуатации устаревший эндпоинт (hottrends/dailytrends/realtimetrends), от которого зависят методы поиска трендов в pytrends — подтверждено проверкой всех трёх вариантов, которые предлагает pytrends. Это проблема upstream, поэтому её нельзя исправить в этом коде; при этом код аккуратно возвращает понятное сообщение об ошибке, а не кладётся. Остальные 4 инструмента используют другое, всё ещё работающее семейство эндпоинтов и не затронуты. Если Google восстановит эндпоинт или pytrends добавит обходное решение, всё снова заработает без каких-либо изменений здесь.

Все инструменты перехватывают ошибки (лимиты частоты, сетевые сбои, описанное выше) и возвращают простое сообщение об ошибке вместо падения — Google Trends, это скрейп-эндпоинт, а не стабильный API, поэтому такое поведение ожидаемо, а не исключение.

Установка

Требуются Python 3.10+ и uv.

git clone https://github.com/jain-eshan/google-trends-mcp.git
cd google-trends-mcp
uv sync

Регистрация в Claude Code

claude mcp add google-trends -- uv run --directory /absolute/path/to/google-trends-mcp server.py

Проверьте, что подключение прошло:

claude mcp list

Вы должны увидеть google-trends в списке со статусом ✔ Connected. После регистрации начните новый разговор с Claude Code — уже запущенные сессии не подхватят только что добавленный сервер.

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

После регистрации просто попросите Claude использовать его, например:

«Используйте MCP google-trends, чтобы сравнить интерес к 'lab grown diamonds' и 'diamond jewellery' в Индии за последние 12 месяцев и покажите связанные запросы.»

Необязательно: навык /trendabs

Этот репозиторий включает навык Claude Code в .claude/skills/trends/SKILL.md, который превращает сырые инструменты в рабочий процесс «исследование и синтез» — он сам решает, какие инструменты подходят к вашему вопросу, и выдаёт вывод понятным языком, а не сырой JSON. Если вы используете Claude Code, навык подхватится автоматически из этого репозитория; просто запустите:

/trends <your topic>

Заметки по дизайну

• Только данные, никакого синтеза на сервере. Каждый инструмент возвращает сырые структурированные данные; интерпретация (реалистичен ли тренд, что здесь означает маркер Breakout, что стоит выделить) происходит в диалоге, а не зашита в сервер. Это делает сервер простым и позволяет вызывающей стороне (Claude, другому MCP-клиенту) применять своё собственное суждение.

• Никаких зависимостей, кроме mcp[cli] и pytrends. Ни базы данных, ни конфигурационных файлов, ни API-ключа.

• Нет формального набора тестов. Это обёртка над внешним скрейп-эндпоинтом; тесты в основном проверяли бы pytrends и текущий формат ответов Google, а не этот код. Каждый инструмент был проверен на живых данных Google Trends во время разработки.

Лицензия

MIT — см. LICENSE.