TrendPulse - Google News & Trends
mcp-trendpulse
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_trendsanalyze_keyword_trendcompare_keyword_trendsdiscover_related_demandget_trend_contextfind_seo_opportunities
これらの名前はホステッド ChatGPT Apps/MCP インターフェースを表しており、現在のコミュニティ MCP ツール名とは別のものです。
インストール
GitHub から uvx で直接実行する(推奨)
パッケージはまだ PyPI に公開されていないため、最も直接的なインストール方法は次のとおりです:
uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulsePyPI リリースが行われた後は、より短い形式になります:
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.0GOOGLE_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 |
| キーワードに一致する最近のニュース記事を検索します。 |
| 地域に関連する最近のニュースを検索します。 |
| サポートされている Google News トピックの最近のニュースを検索します。 |
| Google News のトップニュース記事を取得します。 |
| 特定のパブリッシャードメインからの最近のニュースを検索します。 |
| 1 つの記事 URL をダウンロード、検証、抽出し、オプションで要約します。 |
トレンドツール
Tool | Purpose |
| 地理的ターゲットの現在の急上昇ワードを取得します。 |
| 1つ以上のキーワードの期間別関心度ポイントを取得します。 |
| 要求された期間における検索関心の成長を計算します。 |
| 現在のトレンドを成長率またはボリュームでランク付けします。 |
| キーワードを指定せずにトップトレンドフィードを取得します。 |
| 地理的リージョン間でキーワードの関心度を比較します。 |
| 上位および急上昇中の関連検索クエリを取得します。 |
| 上位および急上昇中の関連 Google Trends トピックを取得します。 |
| クエリのオートコンプリート/トピックサジェスチョンを解決します。 |
| 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
trendingCLI と 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 をリモートにデプロイする場合は、これらの制御を維持し、アプリケーションのデフォルトだけに頼らず、デプロイメントレベルのレート制限、リクエストタイムアウト、可観測性、リソース制限を追加してください。
ロードマップ
現在の本番稼働準備に向けた作業は次の点に焦点を当てています:
ドキュメント、パッケージングメタデータ、生成された MCP マニフェストを実際のツールサーフェスと整合させ続けること。
ユニットテストと静的チェックの継続的インテグレーションを追加すること。
プロバイダーアクセスを TrendPulse のドメインロジックから分離し、MCP レイヤーを書き直さずにプロバイダーを変更できるようにすること。
ローカルの stdio 運用を維持しながら、本番用のリモート HTTP トランスポートを追加すること。
ChatGPT/Codex 向けに、より小さな高レベルのホステッドツールサーフェスを設計すること。
ホステッドサービスを DigestSEO アプリケーションと運用スタックに統合すること。
サービスが本番稼働可能になった後にのみ、ホステッド MCP を OpenAI プラグインとしてパッケージ化およびテストすること。
ライセンス
MIT。 LICENSE を参照してください。
Available Tools
16 toolsget_article_contentARead-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_categoriesARead-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_growthARead-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_regionARead-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_keywordARead-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_locationARead-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_siteARead-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_topicARead-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_ranked_trendsARead-only
Return ranked terms in the Google Trending Now 24-hour feed by provider-reported recent growth or approximate volume. The growth percentage has no stated comparison baseline and is NOT a week-over-week change. Use get_top_trends for a simpler current feed and get_trends for historical series.
Inputs: geo, sort, limit, source. Returns: result
get_suggestionsARead-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_newsARead-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
get_top_trendsARead-only
Return a bounded current topic discovery feed from Google Trends RSS, including related news where available. Use this for current top or daily trends; use get_ranked_trends when explicit ranking by growth or volume matters.
Inputs: geo, type, limit. Returns: result
get_trending_termsARead-only
Return terms that are trending now for a geography, optionally with related news metadata. Use this for current trend discovery; use get_trends when the user wants historical interest over time for known keywords.
Inputs: geo, full_data. Returns: result
get_trendsARead-only
Return historical Google Trends interest-over-time points for one or more known keywords. Use this for trajectory and comparisons across a timeframe; values are normalized 0-100 interest scores, not absolute search volume. Use get_trending_terms for what is trending now.
Inputs: keyword (required), cat, geo, source, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Google Veo AI video generation
MCP server for Google search results via SERP API
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server providing news article mention volume data, weekly series, growth percentages, and a live Google News feed as an AI tool.MIT
- FlicenseNot gradedqualityDmaintenanceAn 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.-
- AlicenseNot gradedqualityCmaintenanceA 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 PyPI8MIT
- FlicenseNot gradedqualityDmaintenanceMCP 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.-