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가 없으므로, 이 서버는 표준 비공식 Python 클라이언트인 pytrends를 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")

최대 5개 키워드에 대한 시간대별 상대적 검색 관심도(0–100)를 나란히 비교해 보여 줍니다. 처음 5개를 초과하는 키워드는 조용히 무시됩니다. 각 레코드에는 isPartial이 포함됩니다. 가장 최근 데이터 지점에서 true가 나오면 그 기간이 아직 끝나지 않았으며 해당 값은 잠정적이라는 뜻입니다. 그 지점의 하락을 실제 추세 변화로 읽지 마십시오.

단일 키워드에 대한 인기 연관 검색어와 급상승 연관 검색어를 보여 줍니다. {"top": [...], "rising": [...]}을 반환하며, 각각은 {"query": ..., "value": ...} 레코드 목록입니다. top 값은 0–100의 상대적 관심도입니다. rising 값은 증가율(백분율)입니다 — 단, 5000%는 예외인데, 이는 거의 0에 가까운 베이스라인에서 폭발적으로 증가했다는 Google의 "Breakout" 마커이지 실제 백분율이 아닙니다.

related_queries와 동일하지만, 원본 검색어 문자열 대신 주제 클러스터(Google 자체 주제 그룹)로 보여 줍니다 — 레코드에는 value와 함께 topic_title과 topic_type이 있습니다. rising에도 동일한 Breakout 규칙이 적용됩니다.

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

주어진 geo 내에서 키워드의 검색 관심도를 주/지역별로 나눠 보여 줍니다. 지역별로 하나씩 {"geoName": ..., "<keyword>": 0-100} 레코드 목록을 반환합니다.

오늘 한 국가에서 가장 많이 오르found 않은 인기 검색어를 보여 줍니다. 여기서 geo 형식은 다르다는 점에 유의하세요. — 다른 네 도구와 달리 ISO 코드가 아니라 전체 소문자 국가 이름("india", "united_states")을 사용합니다. 이는 버그가 아니라 Google 자체 엔드포인트에 실제로 있는 불일치입니다입니다.

알려진 제한 사항: 현재 시점에서 trending_now는 HTTP 404로 실패합니다. Google은 pytrends의 급상승 검색 메서드들이 의존하던 기존 엔드포인트(hottrends/dailytrends/realtimetrends)를 폐지한 것으로 보이며, pytrends가 제공하는 세 가지 변형을 모두 테스트해 본 결과입니다. 이는 업스트림 문제이므로 이 코드베이스에서 해결할 수 없습니다. 크래시하는 대신, 읽을 수 있는 오류 문자열을 반환하며 깔끔하게 실패합니다. 나머지 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에서 자연스럽게 사용하도록 요청하면 됩니다. 예:

"google-trends MCP를 사용해 지난 12개월 동안 인도에서 'lab grown diamonds' vs 'diamond jewellery'에 대한 관심를 비교해 주고, 연관 검색어가 무엇인지 보여 줘."

선택 사항: /trends 스킬

이 저장소에는 .claude/skills/trends/SKILL.md에 Claude Code 스킬이 포함되어 있어, 원본 도구들을 "조사 후 종합"하는 작업 흐름으로 감쌉니다. 이 스킬은 사용자 주제와 관련된 도구를 스스로 결정하고, raw 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