Skip to main content
Glama
TrendPulse - Google News & Trends

TrendPulse - Google News & Trends

mcp-trendpulse

MCP Python License

TrendPulse は、最新ニュースと検索関心トレンドを調査するための Python Model Context Protocol (MCP) サーバーです。Google News のニュース発見・記事抽出と Google Trends 分析を組み合わせることで、MCP クライアントが現在のトレンドの確認、キーワードの勢いの比較、関連需要の探索、そしてリサーチワークフローへの最新ニュースコンテキストの追加を行えるようにします。

このプロジェクトは現在、コミュニティ/セルフホスト型 MCP サーバーとして提供されています。また、ChatGPT や Codex などのリモート MCP クライアント向けに、別の ホステッド版 TrendPulse by DigestSEO サーフェスの実装も含まれています。ホステッド層はより小さなゴール指向のツールサーフェスを使用する一方、コミュニティサーバーは開発者が利用できる完全な低レベル調査ツールキットを維持しています。

プロジェクトステータス: ローカル/コミュニティサーバーは本日から利用可能です。DigestSEO ホステッド MCP と公開 OpenAI プラグインはまだリリースされておらず、利用可能なエンドポイントとして扱わないでください。

エンジニアリングコンテキスト: TrendPulse は DigestSEO MCP エコシステムの一部です。Google Search Console データ向けの mcp-gsc、AI 可視性向けの mcp-geo、技術的な Web 検証向けの mcp-web-validator を補完します。より広いアーキテクチャは DigestSEO MCP Suite エンジニアリングケーススタディ に文書化されています。

TrendPulse でできること

ニュースリサーチ

  • キーワード、地域、トピック、またはパブリッシャードメインで Google News を検索します。

  • トップニュース記事を取得します。

  • Google News のリンクを解決し、記事コンテンツを抽出します。

  • 難しいページでは通常の HTTP 取得から Playwright/Chromium にフォールバックします。

  • オプションで MCP クライアントサンプリングを使用して記事テキストを要約し、フォールバックとしてローカル NLP を使用します。

トレンドリサーチ

  • 地理的市場における現在の急上昇ワードを取得します。

  • 1つ以上のキーワードについて Google Trends の期間別関心度データを取得します。

  • 3M や 1Y などのカスタム期間におけるキーワードの成長を計算します。

  • 現在のトレンドをボリュームまたは成長率でランク付けします。

  • 対応している場合、国、地域、都市、DMA 別の関心度を調べます。

  • 関連クエリ、関連トピック、サジェスチョン、カテゴリ ID を探索します。

  • 基盤となるプロバイダーが対応している場合、Google Search、YouTube Search、News Search、Image Search、Google Shopping のトレンドプロパティを比較します。

Related MCP server: NewsIQ MCP

コミュニティとホステッドのアーキテクチャ

TrendPulse は、意図的に2つのサーフェスで開発されています。

サーフェス

目的

ステータス

コミュニティ MCP

ローカル利用、開発、セルフホスティング、および MCP 互換クライアントとの統合のための完全な Python MCP サーバー。

このリポジトリで利用可能

TrendPulse by DigestSEO

ChatGPT/Codex 向けのマネージド リモート MCP。将来の公開 OpenAI プラグイン向けに、より小さなタスク指向ツールサーフェスを備える。

開発中

コミュニティサーバーは単独でも有用なままです。ホステッド版は同じコアとなるトレンドリサーチの概念を再利用しつつ、マネージドサービスに必要なデプロイ、信頼性、認証、可観測性、プロダクト統合を追加します。

実装されているホステッドツールサーフェスは意図的にコミュニティ API よりも高レベルで、次のようなゴールを中心としています:

  • discover_trends

  • analyze_keyword_trend

  • compare_keyword_trends

  • discover_related_demand

  • get_trend_context

  • find_seo_opportunities

これらの名前はホステッド ChatGPT Apps/MCP インターフェースを表しており、現在のコミュニティ MCP ツール名とは別のものです。

インストール

GitHub から uvx で直接実行する(推奨)

パッケージはまだ PyPI に公開されていないため、最も直接的なインストール方法は次のとおりです:

uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulse

PyPI リリースが行われた後は、より短い形式になります:

uvx mcp-trendpulse

チェックアウトから pip でインストールする

git clone https://github.com/AKzar1el/mcp-trendpulse.git
cd mcp-trendpulse
python -m pip install .
python -m mcp_trendpulse

ブラウザフォールバック

ニュース/記事ツールは、通常の取得で利用可能な記事を抽出できない場合に Playwright にフォールバックできます。Python の playwright パッケージをインストールしても、Chromium は自動的にインストールされません。

ローカルで使用する場合:

playwright install chromium

ブラウザのシステム依存関係も必要な Linux 環境の場合:

playwright install --with-deps chromium

トレンドのみの操作は本来 Chromium を必要としません。

クライアント設定

Claude Desktop

GitHub から直接 uvx を使用する場合:

{
  "mcpServers": {
    "mcp-trendpulse": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/AKzar1el/mcp-trendpulse.git",
        "mcp-trendpulse"
      ]
    }
  }
}

VS Code

{
  "mcp": {
    "servers": {
      "mcp-trendpulse": {
        "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/AKzar1el/mcp-trendpulse.git",
          "mcp-trendpulse"
        ]
      }
    }
  }
}

Cursor

Cursor はグローバルおよびプロジェクトの MCP 設定をサポートしています。関連する mcp.json 設定にサーバーを追加してください:

{
  "mcpServers": {
    "mcp-trendpulse": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/AKzar1el/mcp-trendpulse.git",
        "mcp-trendpulse"
      ]
    }
  }
}

ChatGPT およびその他のクラウド MCP クライアント

リポジトリには、mcp_trendpulse.asgi:app に専用のステートレス Streamable HTTP ASGI エントリポイントが含まれています。これは、変更されていないコミュニティ stdio エントリポイントとは別のものです。

制御されたローカル/プライベートテストでは、Uvicorn で ASGI アプリを実行するか、提供されているコンテナを使用できます。堅牢化されたコンテナ、Host/Origin 許可リスト、Chromium サンドボックスの要件、ヘルス/レディネスエンドポイント、リバースプロキシの注意事項については、deploy/README.md を参照してください。

DigestSEO ホステッドエンドポイントと公開 ChatGPT アプリはまだリリースされていません。ホステッドデプロイメントはフェイルクローズの Clerk OAuth 認証をサポートしています。Clerk の発行者/JWKS/オーディエンス設定、公開ベース URL、Host/Origin 許可リストがそのデプロイメント用に構成されていない限り、リモートトランスポートを公開しないでください。

設定

TrendPulse は、プロセス環境と、存在する場合はローカルの .env ファイルから環境変数を読み込みます。

便利な変数は次のとおりです:

HTTP_PROXY=http://your-proxy-address:port
HTTPS_PROXY=http://your-proxy-address:port
GOOGLE_TRENDS_DELAY=2.0

GOOGLE_TRENDS_DELAY は、現在の Trends プロバイダーが使用するリクエスト遅延を制御します。上流サービスが特定のネットワークをレート制限またはブロックする場合、プロキシ変数が役立つことがあります。

リモートデプロイメントは TRENDPULSE_HTTP_PATH、TRENDPULSE_HTTP_ALLOWED_HOSTS、TRENDPULSE_HTTP_ALLOWED_ORIGINS、TRENDPULSE_BROWSER_SANDBOX もサポートしています。コンテナは Chromium サンドボックスを明示的に有効にします。ローカルのコミュニティ実行では、オプトインしない限り Playwright 互換のデフォルトが維持されます。

シークレット、プライベートプロキシ認証情報、マシン固有の .env ファイルをコミットしないでください。

MCP ツール

コミュニティ MCP サーバーは現在 16 個のツールを公開しています。

ニュースツール

Tool

Purpose

get_news_by_keyword

キーワードに一致する最近のニュース記事を検索します。

get_news_by_location

地域に関連する最近のニュースを検索します。

get_news_by_topic

サポートされている Google News トピックの最近のニュースを検索します。

get_top_news

Google News のトップニュース記事を取得します。

get_news_by_site

特定のパブリッシャードメインからの最近のニュースを検索します。

get_article_content

1 つの記事 URL をダウンロード、検証、抽出し、オプションで要約します。

トレンドツール

Tool

Purpose

get_trending_terms

地理的ターゲットの現在の急上昇ワードを取得します。

get_trends

1つ以上のキーワードの期間別関心度ポイントを取得します。

get_growth

要求された期間における検索関心の成長を計算します。

get_ranked_trends

現在のトレンドを成長率またはボリュームでランク付けします。

get_top_trends

キーワードを指定せずにトップトレンドフィードを取得します。

get_interest_by_region

地理的リージョン間でキーワードの関心度を比較します。

get_related_queries

上位および急上昇中の関連検索クエリを取得します。

get_related_topics

上位および急上昇中の関連 Google Trends トピックを取得します。

get_suggestions

クエリのオートコンプリート/トピックサジェスチョンを解決します。

get_categories

Google Trends のカテゴリ ID と名前を取得します。

例: 明示的なトレンド期間

get_trends は明示的な timeframe を受け入れます。再現可能な比較が必要な場合は、指定することをお勧めします。

{
  "keyword": ["technical SEO audit", "AI SEO audit"],
  "geo": "US",
  "source": "google search",
  "timeframe": "today 12-m",
  "cat": 0
}

サポートされているプロバイダーの範囲には、today 12-m や today 5-y などの標準的な期間、today 90-d や all などの相対的な期間、2021-01-01 2026-01-01 のような正確な日付範囲が含まれます。

Google Trends の値は正規化された関心度スコアです。0-100 の関心度シリーズを絶対的な検索ボリュームとして解釈しないでください。

CLI

独立した Click CLI は、MCP サーバーよりも小さなニュース指向のコマンドセットを公開しています:

uv run mcp-trendpulse-cli --help

現在の CLI コマンド:

keyword
location
top
topic
trending

CLI と MCP のサーフェスは同じコマンドセットを公開していないため、意図的に別々に文書化されています。

開発

任意の Python 環境を使用して開発依存関係を含むプロジェクトをインストールし、ユニットテストスイートを実行してください:

python -m pytest

デフォルトの pytest 設定は、ライブの統合テストを除外しています。

ライブのプロバイダーテストを明示的に実行するには:

python -m pytest tests/integration -m integration

ブラウザマーク付きの統合テストには、Playwright Chromium のインストールが必要です。

Ruff チェックを実行するには:

ruff check .

MCP Inspector

GitHub から公開されているサーバーを MCP Inspector で実行するには:

npx @modelcontextprotocol/inspector uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulse

ローカルチェックアウトの場合:

npx @modelcontextprotocol/inspector uv run mcp-trendpulse

パッケージング

GitHub Actions ワークフローがすでに用意されており、GitHub リリースが公開されると、PyPI Trusted Publishing を介して Python ディストリビューションをビルドして公開します。最初のパッケージリリースが存在するまでは、上記の GitHub uvx --from ... コマンドを使用してください。

セキュリティに関する注意事項

記事の取得はアウトバウンドネットワーク機能であり、信頼できない入力として扱われます。実装は HTTP(S) ターゲットを検証し、プライベートおよびルーティング不可能な宛先を拒否し、リダイレクト先をチェックし、レスポンスサイズの制限を適用し、Playwright を使用する場合はブラウザルート検証を適用します。

TrendPulse をリモートにデプロイする場合は、これらの制御を維持し、アプリケーションのデフォルトだけに頼らず、デプロイメントレベルのレート制限、リクエストタイムアウト、可観測性、リソース制限を追加してください。

ロードマップ

現在の本番稼働準備に向けた作業は次の点に焦点を当てています:

  1. ドキュメント、パッケージングメタデータ、生成された MCP マニフェストを実際のツールサーフェスと整合させ続けること。

  2. ユニットテストと静的チェックの継続的インテグレーションを追加すること。

  3. プロバイダーアクセスを TrendPulse のドメインロジックから分離し、MCP レイヤーを書き直さずにプロバイダーを変更できるようにすること。

  4. ローカルの stdio 運用を維持しながら、本番用のリモート HTTP トランスポートを追加すること。

  5. ChatGPT/Codex 向けに、より小さな高レベルのホステッドツールサーフェスを設計すること。

  6. ホステッドサービスを DigestSEO アプリケーションと運用スタックに統合すること。

  7. サービスが本番稼働可能になった後にのみ、ホステッド MCP を OpenAI プラグインとしてパッケージ化およびテストすること。

ライセンス

MIT。 LICENSE を参照してください。

Available Tools

16 tools
get_article_contentA
Read-only

Download and parse one specific news article when you already have an article URL. Use it to retrieve article text or metadata or summarize that URL; do not use it for discovery - use the news search tools instead.

Inputs: url (required), full_data, summarize. Returns: result

get_categoriesA
Read-only

Return a bounded page of Google Trends category IDs and names for use in the cat parameter of trend tools. Use query to find categories by name and offset/limit to page through broader results; do not guess category IDs.

Inputs: limit, query, offset. Returns: result

get_growthA
Read-only

Estimate momentum for one or more known keywords across requested growth windows. Use this when percentage growth is the goal; use get_trends when the user needs the underlying historical time series.

Inputs: keyword (required), geo, source, percent_growth. Returns: result

get_interest_by_regionA
Read-only

Return geographic Google Trends interest for one or more known keywords at country, region, city, or DMA resolution. Use this to compare where demand is strongest; use get_trends for interest over time instead.

Inputs: keywords (required), cat, geo, gprop, +3 more. Returns: result

get_news_by_keywordA
Read-only

Find recent Google News articles for a free-form keyword or phrase. Use this for ad-hoc subject searches; use get_news_by_topic for a predefined topic category or get_news_by_site for one publisher.

Inputs: keyword (required), period, full_data, summarize, +2 more. Returns: result

get_news_by_locationA
Read-only

Find recent Google News articles about a place-focused location such as a city, state, or country. Use this when geography is the primary filter; use get_news_by_keyword for general subject searches.

Inputs: location (required), period, full_data, summarize, +2 more. Returns: result

get_news_by_siteA
Read-only

Find recent Google News articles from one publisher domain. Use this when the user wants source-specific coverage; use get_news_by_keyword for cross-publisher subject search.

Inputs: site (required), period, full_data, summarize, +2 more. Returns: result

get_news_by_topicA
Read-only

Find recent Google News articles from a predefined Google News topic category. Use this for topic category browsing such as BUSINESS, TECHNOLOGY, or SPORTS; use get_news_by_keyword for a free-form query.

Inputs: topic (required), period, full_data, summarize, +2 more. Returns: result

get_suggestionsA
Read-only

Return Google Trends autocomplete suggestions for a seed keyword. Use this for lightweight autocomplete or entity candidates; use get_related_queries when you need top or rising demand signals.

Inputs: keyword (required), language. Returns: result

get_top_newsA
Read-only

Return general headline and top-news stories from Google News without a keyword or topic seed. Use this for a broad news snapshot; use the keyword, location, topic, or site tools when the user gives a filter.

Inputs: period, full_data, summarize, max_results, +1 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 16 tools

    Disambiguation4/5

    The news tools are cleanly separated by filter (keyword, location, topic, site, top), and trend tools mostly include explicit cross-references to guide selection. The main overlap is among get_ranked_trends, get_top_trends, and get_trending_terms, which all surface current trends, though descriptions provide clear usage cues.

    Naming Consistency5/5

    All tools use snake_case with a get_ verb prefix and noun-based names such as get_news_by_topic, get_interest_by_region, and get_related_queries. The pattern is predictable throughout, with only natural variation between get_news_by_* and get_top_* forms.

    Tool Count4/5

    Sixteen tools cover two related but distinct domains—Google News search and Google Trends analysis—and each maps to a specific query type. The count is slightly above the ideal 3–15 range but remains reasonable for the breadth of functionality.

    Completeness4/5

    The surface covers news discovery across keyword, location, topic, site, and top stories, plus article retrieval and a broad Trends lifecycle including historical interest, growth, regional interest, categories, related queries/topics, suggestions, and current trends. Minor gaps include no date-range or language filters for news search and no batch article retrieval, but core workflows are well supported.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server providing news article mention volume data, weekly series, growth percentages, and a live Google News feed as an AI tool.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An AI-powered news aggregator MCP server that fetches live news from multiple sources, provides AI summaries via Claude, and performs sentiment analysis and trending topic detection.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A persistent news intelligence MCP server that enables AI agents to fetch, store, deduplicate, embed, and semantically query news from Google News across 141 countries and 41 languages.
      34 PyPI
      8
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes Google Trends data via BigQuery, enabling LLMs to query top search terms, rising terms, and compare term interest over time for different countries.
      -