Skip to main content
Glama
Google Trends MCP

Google Trends MCP

by jain-eshan

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 в самой свежей точке данных означает, что период ещё не завершён и значение предварительное; не стоит считать падение в этой точке реальным изменением тренда.

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

То же, что и 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} — по одной на регион.

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

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

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

Related MCP server: Google Trends MCP Server

Установка

Требуются 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.

Available Tools

11 tools
app_store_appsA

Existing iPhone/iPad apps matching a query, from Apple's public iTunes Search API - who already serves this need, and how many people rate them (rating count is a rough proxy for user base). No setup needed.

Args: query: search terms, e.g. "meal planner" or "invoice". country: ISO country code for the store, e.g. "US" (default), "IN", "GB". limit: max apps, capped at 50.

Returns: A list in App Store relevance order, each with "name", "developer", "rating", "rating_count", "price", "genre", "released", "last_updated", "url".

Inputs: query (required), limit, country.

builder_activityA

Are people actually building and shipping in this space? Hacker News stories (launches, Show HNs, debates) plus GitHub repositories - a builder signal, as opposed to search interest or community chatter. Works with no setup; a GITHUB_TOKEN saved via /gutcheck setup raises GitHub's limit from 10 to 30 searches a minute.

For Product Hunt launches, use web search restricted to producthunt.com instead - Product Hunt's API has no search endpoint.

Args: query: search terms, e.g. a product category ("habit tracker") or problem.

Returns: {"hn": {"total": int, "stories": [...]}, "github": {"total": int, "repos": [...]}}. Each story: title, points, num_comments, url, created_at. Each repo (top 10 by stars): name, description, stars, last_push, url.

Inputs: query (required).

company_registrationA

Company registration lookup via OpenCorporates - registration facts only (incorporation date, status, company number). Does NOT cover funding, valuation, or traction data - no free API exists for that (see README for why).

Requires a free OpenCorporates API token: as of 2026 OpenCorporates requires a token on every request, even on the free tier (roughly 50 requests/day, 200/month). Register at https://opencorporates.com/api_accounts/new and save it as OPENCORPORATES_API_TOKEN via /gutcheck setup.

Args: name: company name to search for. jurisdiction: optional OpenCorporates jurisdiction code (e.g. "in", "us_de") to narrow results.

Returns: A list of up to 5 matches, each containing "company_name", "jurisdiction_code", "incorporation_date", "company_number", "current_status", "opencorporates_url". Empty list if no matches. A setup-instructions string if OPENCORPORATES_API_TOKEN is unset, or OpenCorporates' own rejection message if the token is invalid/expired.

Inputs: name (required), jurisdiction.

interest_by_regionA

Search interest for a keyword broken down by state/region within a country, or by country when geo is "" (worldwide).

Args: keyword: a single search term. timeframe: pytrends timeframe string, e.g. "today 12-m". geo: ISO country code (e.g. "US", "IN"), or "" for worldwide (default). response_format: "concise" (default) returns only the top 10 regions by interest, rounded to whole numbers. "full" returns every region, unrounded.

Returns: A list of records, one per state/region within the specified geo, each containing: - "geoName": the state/region name (e.g. "California"), or the country name when worldwide - A column with the keyword name as the key: relative search interest (0-100 scale) for that region. Higher values indicate higher relative interest in that region compared to others in the same country. This is Google Trends' standard region-relative scale.

Inputs: keyword (required), geo, timeframe, response_format.

interest_over_timeA

Relative Google search interest (0-100) over time for up to 5 keywords, compared side by side.

Args: keywords: 1-5 search terms to compare. Only the first 5 are used; additional keywords are silently dropped. timeframe: pytrends timeframe string, e.g. "today 12-m", "today 5-y", "now 7-d", or "YYYY-MM-DD YYYY-MM-DD". geo: ISO country code (e.g. "US", "IN", "GB"), or "" for worldwide (default). response_format: "concise" (default) covers the whole requested timeframe, thinned to about 26 evenly spaced points (first and last always kept) and rounded to whole numbers, so the shape of the window is intact at a low token cost. "full" returns every point unrounded - use it when you need week-by-week detail.

Returns: A list of records, one per date, each containing: - "date": ISO date string - "isPartial": present and true only when the period is incomplete (most recent point) - omitted when false in "concise" mode, since false is the common case. - One numeric key per keyword (0-100 relative interest value)

Inputs: keywords (required), geo, timeframe, response_format.

news_coverageA

Recent news coverage from Google News - is the press writing about this, and what angle are they taking? Useful for spotting funding rounds, regulation, launches, and whether a topic is getting more or less attention. No setup needed.

Args: query: search terms. geo: ISO country code for the news edition, e.g. "US" (default), "IN", "GB". recent: how far back - "7d", "1m", "1y" (default). Uses Google News' own when: filter. limit: max headlines to return (Google returns up to ~100; "total" counts all of them).

Returns: {"total": int, "last_30_days": int, "headlines": [{"title", "source", "published", "url"}]}, newest first. "total" and "last_30_days" are counts within Google's capped result set, so treat them as a rough attention gauge, not an exact article count.

Inputs: query (required), geo, limit, recent.

reddit_signalA

What real people on Reddit are saying, asking, or complaining about - qualitative community signal, as opposed to Trends/Wikipedia's passive search/reading numbers.

Works with no setup via Reddit's public search feed (which returns post text but not scores, and rate-limits after a burst of requests). If REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are saved via /gutcheck setup, uses the official API instead, which adds score and comment counts.

Args: query: search terms. subreddits: optional subreddit names to restrict the search to (e.g. ["startups", "SaaS"]). limit: max results, capped at 100. time_filter: "week", "month", "year" (default), or "all".

Keep the query short (2-4 words) and pass subreddits when obvious communities exist. Reddit's keyless search matches loosely on long questions, so results that share no meaningful word with the query are dropped and the rest are ranked by how many query words they match.

Returns: A list of records with "title", "subreddit", "snippet" (first ~300 chars of the post body), "url", "created". "score" and "num_comments" are included only in API mode.

Inputs: query (required), limit, subreddits, time_filter.

wikipedia_pageviewsA

Monthly Wikipedia pageview counts for an article - a free, no-auth reference/reading interest signal that complements Google Trends' search-interest signal. The two diverging (e.g. a term trending in search but flat on Wikipedia) can itself be a signal worth flagging.

Args: article: an English Wikipedia article title, e.g. "Artificial_intelligence" or "Machine learning" (spaces are handled automatically). timeframe: how far back to request, as a simple duration - "P1Y" (1 year, default), "P6M" (6 months), "P90D" (90 days). Only whole Y/M/D forms are supported. response_format: "concise" (default) returns only the most recent 12 months. "full" returns the entire requested timeframe.

Returns: A list of records, one per month, each containing: - "month": "YYYY-MM" - "views": total pageviews that month (all access methods, human traffic only - bot traffic is excluded by Wikimedia's "user" agent filter)

Inputs: article (required), timeframe, response_format.

youtube_videosA

YouTube videos matching a query, with view and comment counts - shows how much people watch content about a topic (tutorials, reviews, "I tried X" videos), which is often a stronger consumer-interest signal than search volume.

Requires a free YOUTUBE_API_KEY (Google Cloud, YouTube Data API v3), saved via /gutcheck setup. Each call uses about 101 of the free 10,000 daily quota units.

Args: query: search terms. limit: max videos, capped at 25. published_after_days: only videos from the last N days; omit for any time.

Returns: A list in YouTube relevance order, each with "title", "channel", "published", "views", "likes", "comments", "url". A setup-instructions string if no key is saved.

Inputs: query (required), limit, published_after_days. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct data source or dimension: Google Trends topics, queries, time series, regional breakdown, plus Wikipedia, OpenCorporates, Reddit, HN/GitHub, Google News, App Store, and YouTube. Even within Trends, related_topics vs related_queries are clearly separated by content type. No ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent snake_case noun phrase pattern (e.g., interest_over_time, reddit_signal, builder_activity). No mixing of conventions or verb styles, making the set predictable and easy to navigate.

    Tool Count5/5

    With 11 tools covering a wide but focused range of market research signals, the count is well-scoped. Each tool contributes a unique data source, and none feel redundant or missing for the server's stated purpose.

    Completeness4/5

    The surface covers search interest, related topics/queries, regional data, reference interest (Wikipedia), community chatter (Reddit), builder activity (HN/GitHub), news coverage, app ecosystem, and YouTube viewership. Minor gaps exist (e.g., no global 'trending now' without a keyword, no multi-keyword regional comparison), but core workflows are well supported.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers