China News

@pipeworx/china-news

中国本土、香港、台湾および海外華人系の28の報道機関による最近のニュース記事を検索します。GDELT Project の Global Knowledge Graph を情報源として、見出し、発行元、URL、公開日時、テーマタグ、記事の平均論調を取得できます。

Pipeworx の一部です。AI エージェントを1875以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• china_news_search({query?, region?, outlets?, lang?, since?, until?, limit?}) — 中国本土、香港、台湾、海外華人系の報道機関で、あるトピックがどのように報じられているかを調べます。自由形式のテキストは、見出し、記事の URL、GDELT のテーマタグと照合されます。
• china_news_article({url}) — インデックス済みの記事1件について、発行元、見出し、日時、テーマ、論調、言及された場所など、把握できる情報をすべて取得します。空の body を返すのではなく、記事本文を取得できないことを文章で伝えます。
• china_news_outlets({region?, method?, searchable_only?}) — 監査済みの106の報道機関の一覧です。各機関には searchable: true|false が付与され、最後にインデックスされた記事のタイムスタンプも含まれます。このツールにより、報道範囲を推測ではなく確認できます。

認証

キー不要です。呼び出し元の認証情報は一切必要ありません。

データソース

• http://data.gdeltproject.org/gdeltv2/ — 15分ごとに公開される GDELT Global Knowledge Graph の一括フィードです。中国・香港・台湾の発行元のセットに絞り込まれています。GDELT の利用規約では、商用利用が認められています。
• Pipeworx モノレポ内の docs/data/china-news-inventory.json — china_news_outlets（fleet #1390）の基盤となる、手作業で監査された報道機関の一覧です。

次の担当者が同じことを調べ直さずに済むように

• GDELT には、どのパブリッシャーの記事本文も一切ありません。 Global Knowledge Graph は記事のインデックスであり、記事のコピーではありません。china_news_article は理由を明示して body_available: false を返します。場合によって空文字列になる body フィールドを追加しないでください。
• region は lang ではありません。 国勢調査の region はパブリッシャーの 管轄地域です。中国語のクエリに台湾の報道が返されるのは、この分野で最もよくある 間違いです。docs/china-news-plan.md sec 9 には、GDELT 独自の sourcelang: パラメーターを使ってこの間違いをした記録が あります。
• lang はパブリッシャーの本国版ではなく、配信ホストから読み取ります。 2026-09-11 時点の測定では、インデックスに存在するすべてのホストが英語版で、そのうち 4 つ （english.news.cn、en.people.cn、 en.gmw.cn、en.ce.cn）は国勢調査で zh と記録されたパブリッシャーのものです。 GDELT は中国本土の国営メディアの英語版を中国語版よりはるかに多くインデックス化 しています。パブリッシャーの言語で絞り込むと、英語の記事に対して lang: "zh" を 返すことになります。
• 報道件数は実際に少なく、それは不具合ではありません。 15 分ごとのファイルで パブリッシャーのセットに一致する行は 0～20 件で、連続するファイルでは一致する 行が 1 件もないこともよくあります。これらのメディアの多くは 1 日に数回しか記事を 公開しないためです。そのため、検索結果が空になるのは通常のことです。 china_news_search は、適用したフィルターを示し、現在記事があるパブリッシャーを 一覧表示して空の結果を返すため、ツールの故障と区別できます。
• 見出しは HTML エンティティにエンコードされており、これには両面があります。 GDELT の PAGE_TITLE は、ASCII 以外の文字をすべて数値文字参照として出力するため、 中国語の見出しは 葉門叛軍… のように保存されます。 ここでは、次の 2 点に対処しています。読み込み時にタイトルをデコードするため、 現在の 30 日間の期間も修正され、今後の行だけが対象になるわけではありません。 また、ASCII 以外の文字を含むフリーテキストクエリは、両方の表記で検索されます。 保存されたテキストに対しては、行がいくつあっても、CJK 文字をそのまま使った クエリでは一致しません。
• パブリッシャーのドメインはサブドメインとして記録されます。 GDELT は、国勢調査上の ホームドメイン（news.cn）ではなく、配信ホスト（english.news.cn）を記録します。 ここでのすべてのドメインフィルターは、完全一致またはドット付きサフィックスで 一致させます。部分文字列では一致させません。そうしないと、別のパブリッシャーである epochtimes.com に theepochtimes.com が一致してしまいます。
• 見出しが本当に存在しない記事もあります。 China Daily の GKG 行には記事の見出し ではなく、サイト全体のタグラインが含まれるため、見出しは存在しないものとして保存 されます。行には title: null と title_unavailable の注記が含まれることが あります。これが、フリーテキスト検索で URL のスラッグとテーマタグも照合する理由 です。見出しだけの検索では、こうした行を見つけられません。
• DOC API は代替バックエンドではありません。 api.gdeltproject.org は、どの リクエスト間隔でも、3 回の測定セッションを通じて成功率が 50% を超えることは ありませんでした（docs/china-news-plan.md sec 8a）。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "china-news": {
      "url": "https://gateway.pipeworx.io/china-news/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/china-news/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツールも返します。そのため、表示されるツール数はこの表の数より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共有ツールがおよそ30個一覧表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の状況を確認するための信頼できる情報です。

これは意図的なものであり、偶然の多重化ではありません。メタツールを使うと、このパックでは対応できない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を介して回答できます。そのため、MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、完全なゲートウェイに一度だけ接続してください。

または、完全な Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと、同じ1875以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/china_news_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"Taiwan","limit":5}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/china_news_search を呼び出します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "china-news": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-china-news"]
    }
  }
}

または、起動することを確認するために、直接実行します。

npx -y @pipeworx/mcp-china-news

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に対して、このパック独自のツールのみで応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、完全なゲートウェイでも機能します。

ask_pipeworx({ question: "your question about China News data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT