newsintel

    _   __                 ____      __       __     ___    ____  ____
   / | / /__ _      _____|  _/___  / /____  / /    /   |  / __ \/  _/
  /  |/ / _ \ | /| / / __|/ // _ \/ __/ _ \/ /    / /| | / /_/ // /
 / /|  /  __/ |/ |/ /\__ \ // ___/ /_/  __/ /    / ___ |/ ____// /
/_/ |_/\___/|__/|__//___/___/\___/\__/\___/_/    /_/  |_/_/   /___/

AI エージェント、MCP 統合、開発者のワークフロー向けのパーソナライズされたニュースインテリジェンス。
_{20 以上のソース。リアルタイムランキング。エージェントですぐに使えるダイジェスト。セルフサービスでのオンボーディング。}

ポータルを試す  •  API リファレンス  •  MCP サーバー  •  アーキテクチャ  •  コントリビューション

---

NewsIntel を選ぶ理由

多くのニュース API が提供するのは生のフィードです。NewsIntel が提供するのはインテリジェンスです。ランキング付け、重複排除、バイアスへの配慮を行った、AI ですぐに利用できるブリーフィングです。

• AI エージェント向け：MCP または REST 経由で、1 回の呼び出しで構造化されたブリーフィングを取得できます
• 開発者向け：セルフサービスの API キー、OpenAPI スキーマ、Prometheus メトリクスを標準で利用できます
• チーム向け：ワークスペースごとの分離、フィードバックに基づくランキング、Grafana ダッシュボードを利用できます

# Get a personalized briefing in 10 seconds
curl -sS "https://newsintelapi.com/v1/briefing?format=digest&limit=6" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

機能

 INGEST           PROCESS              DELIVER             OBSERVE
 ------           -------              -------             -------
 RSS (20+)  -->  Dedup & Normalize    REST API            Prometheus
 GDELT       -->  Bias-aware ranking   Agent digests       Grafana
 Guardian    -->  Topic inference      MCP server          Sentry
 X signals   -->  Feedback loop        Self-serve portal   OpenTelemetry

	機能	詳細
ニュース	マルチソース集約	RSS（20 以上のソース）、GDELT、Guardian API、X のフォローシグナル
AI	エージェントですぐに使える出力	/briefing/agent エンドポイントとスタンドアロン MCP サーバー
ランキング	スマートフィルタリング	バイアス多様性のゲート、ソースの信頼性スコアリング、鮮度による重み付け
認証	マルチワークスペース	ワークスペースごとの API キー、動的なキー発行、X OAuth セルフサービス
フィードバック	学習ループ	いいね／スキップ／保存／無関係のシグナルが今後のランキングに反映されます
運用	本番環境対応	Prometheus メトリクス、Grafana ダッシュボード、Sentry、OpenTelemetry

クイックスタート

オプション A：ホスト型 API を使う（推奨）

1. newsintelapi.com/portal を開きます
2. X（OAuth）で接続し、API キーを取得します
3. リクエストを開始します

AI エージェントには、ネイティブなツール統合を行える MCP サーバーを使用してください。

オプション B：Docker でセルフホストする（安全な基本設定）

git clone https://github.com/stabem/newsintel-api.git && cd newsintel-api
cp .env.example .env
# REQUIRED before first run: replace all CHANGE_ME_* placeholders in .env
# example internal DB URL: postgresql://newsintel:<strong-password>@postgres:5432/newsintel
# generate strong secrets, e.g.:
#   API_KEYS=$(openssl rand -hex 24)
#   OPS_ADMIN_KEY=$(openssl rand -hex 32)
#   TOKEN_ENCRYPTION_SECRET=$(openssl rand -hex 32)

docker compose up --build -d

# Verify
curl -sS http://localhost:8090/healthz

メインの docker-compose.yml はデフォルトで安全です。組み込みの脆弱な DB／Grafana 認証情報はなく、Postgres／Redis のポートも公開されません。使い捨てのローカルテスト以外で使用する前に、.env の CHANGE_ME_* プレースホルダーを置き換える必要があります。

オプション C：ローカル開発

npm ci && cp .env.example .env
# For local dev, replace the CHANGE_ME_* placeholders with local-only values first.
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d postgres redis
npm run migrate:up && npm run dev

便利なデフォルト設定と公開された開発用ポートを備えた、オールインワンのローカルスタックを利用するには：

docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build -d

ローカル開発サービス：API localhost:8090 | Postgres localhost:5436 | Redis localhost:6386

API の概要

完全なリファレンス：docs/api-reference.md | OpenAPI スキーマ：GET /openapi.json

Method	Endpoint	Auth	Description
GET	/healthz	-	稼働状態チェック
GET	/readyz	-	準備状態（DB／Redis／キュー）
GET	/metrics	-	Prometheus メトリクス
GET	/v1/briefing	Bearer	パーソナライズされたブリーフィング
GET	/v1/briefing/agent	Bearer	エージェント向けに最適化されたダイジェスト
GET	/v1/news/search	Bearer	ニュースの検索と集約
POST	/v1/profile/sync	Bearer	プロフィールの同期（manual/x-browser/x-api）
POST	/v1/keys	Bearer	動的 API キーの発行
GET	/v1/ops/status	Admin	運用状況ダッシュボード

AI 連携

MCP サーバー（Claude Desktop、Cursor、Windsurf など向け）

スタンドアロンの MCP サーバーが付属しています。任意の MCP 対応クライアントに接続できます：

cd integrations/newsintel-mcp && npm install

または、.mcp.json に追加します：

{
  "mcpServers": {
    "newsintel": {
      "command": "node",
      "args": ["integrations/newsintel-mcp/server.mjs"],
      "env": { "NEWSINTEL_API_BASE": "https://newsintelapi.com" }
    }
  }
}

ツール：sync_profile | get_profile | get_news_briefing

詳しいドキュメントは integrations/newsintel-mcp/README.md をご覧ください。

Anthropic SDK（ツールの使用＋エージェント）

NewsIntel をツールとして使用する AI エージェントを構築できます。TypeScript と Python の例をご覧ください：

# TypeScript — agentic loop
cd examples/agent-sdk-typescript && npm install
ANTHROPIC_API_KEY=sk-... NEWSINTEL_API_KEY=ni_live_... npx tsx agent.ts

# Python — agentic loop
cd examples/agent-sdk-python && pip install -r requirements.txt
ANTHROPIC_API_KEY=sk-... NEWSINTEL_API_KEY=ni_live_... python agent.py

ツールの使用例とエージェントのパターンについては、examples/ をご覧ください。

アーキテクチャ

                     +------------------+
                     |   Self-serve     |
                     |   Portal (HTML)  |
                     +--------+---------+
                              |
  AI Agents (MCP) --+        |        +-- Prometheus
                    |        v        |
                    +-> [ Fastify ] <--+-- Grafana
                    |   [ API    ]    |
                    +-> [ Server ] <--+-- Sentry
                        +---+---+
                            |
            +-------+-------+-------+-------+
            |       |       |       |       |
          RSS    GDELT  Guardian  X API   pg-boss
         (20+)                           (queue)
            |       |       |       |       |
            +-------+-------+---+---+-------+
                                |
                    +-----------+-----------+
                    |                       |
                PostgreSQL              Redis
              (profiles, news,       (briefing cache,
               feedback, jobs)        enrichment cache)

ドキュメント

ドキュメント	説明
docs/architecture.md	システム概要とデータフロー
docs/api-reference.md	エンドポイント、パラメーター、例
docs/configuration.md	環境変数
docs/observability.md	メトリクス、ログ、トレース
docs/operations.md	Docker、セキュリティ強化、トラブルシューティング
SECURITY.md	脆弱性の報告、認証情報のローテーション
SUPPORT.md	コミュニティサポートの窓口

開発

npm run lint         # Biome linter
npm run typecheck    # TypeScript type checking
npm test             # Full test suite (127 tests)
npm run build        # Compile to dist/

OpenAPI コントラクトのスナップショット：スキーマの変更時に npm run test:openapi-snapshot:update を実行します。

コントリビューション

詳しい手順は CONTRIBUTING.md をご覧ください。

1. フォークして、機能追加用のブランチを作成します
2. 範囲を絞った変更を行い、テストを追加します
3. 次を実行します：npm run lint && npm run typecheck && npm test && npm run build
4. Issue へのリンクを記載して PR を作成します

ロードマップ

ロードマップの全容は docs/OPEN_SOURCE_ROADMAP.md をご覧ください。

• ソースレジストリ：ファイルベースから DB 管理へ
• ニュースの永続化：一括挿入を最適化
• API のページネーションと、より豊かなクエリーセマンティクス
• カスタムニュースプロバイダー向けプラグインシステム

スター履歴

ライセンス

ISC — ご自由にお使いください。

---

_{Fastify、TypeScript、PostgreSQL、Redis、pg-boss で構築されています。
NewsIntel がワークフローに役立ったら、リポジトリにスターを付けてください。}