newsflash

Newsflash

エージェントから検索できる、裏付けの取れたニュースイベントの過去5年分。 newsflash.sh は、複数の地域と言語にわたる260以上の報道機関を監視し、ノイズを重複排除されたイベントグラフにまとめます。1つの出来事、それを裏付けるすべての情報源、信頼度スコアを、分単位で更新しながら提供します。さらに過去5年分を遡って収録しているため、エージェントは過去のデータでバックテストを行い、最新ニュースに基づいて行動できます。MCP、CLI、リアルタイムSSEストリーム、シンプルなHTTP APIで利用できます。

人間は読み、エージェントは検索します。すぐに利用を始めるのにアカウントは不要です。

エージェント向け： Newsflash はホスト型サービスです。newsflash.sh はドメインであり、シェルスクリプトではありません。インストールするローカルバイナリやサーバーはありません。 https://newsflash.sh/api/*（REST）または https://newsflash.sh/mcp（MCP）に直接アクセスしてください。curl "https://newsflash.sh/api/events?limit=1" で確認できます。

# keyless test drive — 50 requests/day, straight from your shell
npx newsflash events -q "etf" -c crypto -n 5
npx newsflash stream -c crypto --min-sources 2   # the live wire, corroborated only
curl "https://newsflash.sh/api/events?q=fed&category=tradfi&limit=5"

MCP（主要な利用方法 — エージェント向け）

イベントグラフは、MCP の Streamable HTTP トランスポートを通じて https://newsflash.sh/mcp で提供されています。公式 MCP レジストリでは sh.newsflash/newsflash として掲載され、Claude のコネクタディレクトリにも登録されています（claude.ai または Claude Desktop で、Settings → Connectors → Browse connectors → 「Newsflash」を検索 → Connect）。ほかの MCP ホストでは、次の URL を指定してください。

// Claude Code / Claude Desktop — remote MCP server
{
  "mcpServers": {
    "newsflash": {
      "type": "http",
      "url": "https://newsflash.sh/mcp",
      "headers": { "Authorization": "Bearer nf_your_key" }   // optional — raises limits
    }
  }
}

Claude Code プラグインのインストール：

/plugin marketplace add zatmonkey/newsflash
/plugin install newsflash@newsflash

エンドポイントはステートレスです（各リクエストは独立しています）。ツール：get_events、get_event、search_articles、list_sources、corpus_stats。Claude、Cursor、ChatGPT などのホスト向け設定ガイドは、newsflash.sh/docs をご覧ください。

OpenClaw

すぐに使えるスキルがこのリポジトリに含まれています（skills/newsflash/）。パーソナライズされた毎日のブリーフィングと、リアルタイムの速報アラートを利用できます。

clawhub install newsflash        # or: openclaw skills install git:zatmonkey/newsflash

次に、エージェントに「ニュースのブリーフィングを設定して」と伝えてください。エージェントが関心事を聞き取り、毎日のブリーフィングをスケジュールします。また、アラートを有効にすると、ライブストリームを監視し、記事が設定した裏付けのしきい値を超えたときに通知します。

CLI

単体で使える、依存関係ゼロの npm パッケージです（./cli、newsflash として公開）。

npm i -g newsflash

newsflash events -q "etf" -c crypto --from 2026-07-10 -n 5
newsflash events --json -q fed | jq '.[0].sources'   # --json for agents
newsflash sources
newsflash stats
newsflash login [email protected]    # free API key via emailed one-time code
newsflash me                       # tier + today's usage

HTTP API

ベース URL https://newsflash.sh：

Method	Route	Purpose
GET	/api/events?q=&source=&category=&from=&to=&limit=	重複排除されたイベント
GET	/api/events/:id	1件のイベントと、それを裏付ける記事
GET	/api/articles?…	記事の生データ検索
GET	/api/sources	追跡対象の情報源と件数
GET	/api/stats · /api/health	コーパスの規模と鮮度
GET	/api/stream	リアルタイムSSEプッシュ — クラスタリングの確定に伴う event.new / event.corroborated
POST	/mcp	MCP サーバー（Streamable HTTP）— エージェント向けのインターフェース

カテゴリ：crypto tradfi business tech politics world science health energy sports。

OpenAPI

REST API 全体は openapi.yaml で記述されています。これは、稼働中の API から生成された OpenAPI 3.1 仕様で、上記のすべてのエンドポイントについて、SSE ストリームと認証フローを含む正確なリクエスト／レスポンススキーマを定義しています。Pipedream、RapidAPI、Postman、またはカスタム GPT Action にインポートして独自のツールから Newsflash を利用したり、任意の OpenAPI ジェネレーターで型付きクライアントを生成したりできます。

ティア

ティア	認証	上限	方法
test	なし	50 req/day（IP ごと）・過去 24 時間・1 ストリーム	API または MCP エンドポイントを呼び出すだけです
free	API キー	1,000 req/day・過去 30 日間・2 ストリーム	newsflash login — メールアドレス + ワンタイムコード
premium	サブスクリプション	50,000 req/day・5 年分の全アーカイブ・10 ストリーム	newsflash upgrade — $29/月

キーは Authorization: Bearer nf_…（または x-api-key）として渡します。REST と /mcp で同じ制限が適用されます。すべてのレスポンスには X-RateLimit-Limit / X-RateLimit-Remaining / X-Newsflash-Tier が含まれます。上限は UTC の午前 0 時にリセットされます。キーは一度だけ表示され、 ハッシュとしてのみ保存されます。

イベントグラフの仕組み

新しい記事は正規化され、トライグラム類似度を使って最近のイベントと照合されます。 カテゴリーをまたいで照合するため、暗号資産メディアと伝統的金融メディアが 同じ出来事を報じていれば、1 つのイベントの裏付けとなります。類似度がしきい値を 超えると、記事はイベントに追加され、その裏付け度が上がります。そうでなければ、 新しいイベントの起点となります。confidence = min(1, distinct_sources / 3) — 独立したメディア 3 社以上に 裏付けられたイベントは、信頼度が最大になります。

これにより、グラフはシグナルとして機能します。エージェントは、 単一メディアのうわさ（confidence 0.33）と、報道機関全体が報じているニュース （confidence 1.0、情報源を一覧表示）を区別し、全アーカイブを検索して 過去データでバックテストできます。

このリポジトリについて

このリポジトリには、Newsflash のオープンソース（MIT）クライアント部分である、 依存関係ゼロのCLI（cli/）、Claude Code プラグインのマニフェスト （.claude-plugin/）、MCP レジストリマニフェスト （server.json）が含まれています。Newsflash のバックエンドは newsflash.sh で運用されているホステッドサービスであり、このリポジトリには含まれません。

CLI の開発：cd cli && npm install && npm run build && node dist/index.js stats。 実行時の依存関係はありません — Node ≥ 20 の組み込み機能のみを使用します。

---

ドキュメント · 情報源 · プライバシー · 利用規約 · [email protected]