ようやくわかる

公式アプデは正しい。でも長くて、読む気にならない——それでも正確さは欲しい人向けに、RSS で集めた公式更新を日本語の「結論＋使える場面」だけで読める更新リーダーです。

Demo: https://yoyaku-wakaru.vercel.app

ChatGPT / Claude / Gemini などの更新を追いながら、「何が変わったか」「自分の仕事にどう効くか」だけ先に把握できます。

主な機能

• 公式・準公式 RSS から新着を自動取り込み
• ホーム最上段で X（SNS） / 公式サイト / All を切り替える。各チャネルは1ページ20件で、Xが公式RSSの下に埋もれない
• X の投稿は API では取らない。人がバズ順で渡した候補を記事にする。公式URLがあればそれを出典にし、無ければ投稿URLを出典にする。要約はタイトルの転記ではなく、投稿本文（公式ページが取れたときはその本文も）から2ボイスで書く
• 一覧の初期表示は直近3日。同じソースの近い更新はまとめて出す
• Gemini による日本語要約（結論 / 詳細 / 使える場面）。用語は本文中の点線を押すと解説が開く
• 非エンジニア向け / エンジニア向け の2ボイス切替（事実は同じ・言い方だけ変える）
• 30秒で読む / 詳しく読む の粒度切替（結論だけ先に読める）
• 一覧の絞り込みは、チャネルの下に「モデル・API / コーディングAI / 基盤・CDN / フレームワーク / 開発ツール / セキュリティ」。OpenAI や Cursor などのソース名でも絞れる
• キーワード検索・ページネーション
• あとで読む・既読・未読のみ表示（ログイン不要。この端末のブラウザにのみ保存）
• ウォッチキーワード（登録した語を含む記事に印を付けて絞り込み）
• 保存データの管理ページ /library（JSON エクスポート / インポート / 全削除）
• 要約の Markdown / Slack 用コピー と、詳細ページの関連ニュース表示
• 任意で Slack 通知

保存・既読・ウォッチは localStorage（端末内だけに保存する領域）を使うため、認証・追加インフラなしで動きます。端末間の同期はありません。

構成

役割	技術
画面・取り込み API	Next.js（Vercel）
RSS 取得 → 要約 → 送信	Google Apps Script + Gemini
記事の保存（任意）	Neon（Postgres）。未設定時はローカル JSON / サンプル表示

要約フォーマット

詳細ページでは読者タブと、要約の深さ（30秒で読む / 詳しく読む）を切り替えます。各ボイス共通で次の構成です。

1. 結論（3行程度）… どちらの深さでも表示
2. 詳細内容（2〜4文）… 「詳しく読む」のみ。背景・変更点・注意点の補足
3. 使えるシチュエーション（3点）… 「詳しく読む」のみ
4. 用語解説 … 独立した一覧は出さない。表示中の本文（結論 → 詳細内容 → 使えるシチュエーション）を上から見て、各用語の最初の1回だけ点線にする。押すと解説が開く。本文に無い用語は画面に出さない（terms データと Markdown コピーには残る）

既存記事に詳細内容が無い場合は、そのセクションだけ非表示になります。GAS の backfillDualVoiceArticles で再要約すると埋まります。

セットアップ

1. 必要なキー

名前	どこに置くか	用途
GOOGLE_API_KEY	GAS スクリプトプロパティ	Gemini 要約
INGEST_SECRET	Vercel 環境変数 と GAS（同じ値）	/api/ingest の認証
DATABASE_URL	Vercel 環境変数（推奨）	本番の永続化（Neon）
SLACK_WEBHOOK_URL	GAS（任意）	新着の Slack 通知

画面を見るだけなら、キーなしでローカル起動できます（サンプル表示）。

2. ローカルで画面を見る

npm install
cp .env.example .env.local
# 画面閲覧だけなら空のままでOK
# 取り込みや本番DB接続をするなら INGEST_SECRET / DATABASE_URL を埋める
npm run dev

開く: http://localhost:3000

3. Vercel へデプロイ

ワンクリック Import（Vercel / GitHub にログイン済みの状態で開く）:

https://vercel.com/new/import?s=https://github.com/osanai1004/ai-feed-digest

1. Framework Preset: Next.js（自動検出）
2. Environment Variables:
   • INGEST_SECRET = 長いランダム文字列
3. Deploy
4. （推奨）Marketplace で Neon Free を接続して DATABASE_URL を入れる

CLI 例:

npx vercel link --yes
npx vercel env add INGEST_SECRET production
npx vercel --prod --yes

4. GAS 連携

詳細は gas/README.md。

1. Apps Script で新規プロジェクト
2. gas/Code.gs を貼り付け
3. スクリプトプロパティを設定:
   • GOOGLE_API_KEY = Gemini API キー
   • INGEST_URL = https://<your-app>.vercel.app/api/ingest
   • INGEST_SECRET = Vercel と同じ値
   • SLACK_WEBHOOK_URL = （任意）Slack Incoming Webhook
   • APP_BASE_URL = （任意）アプリのベース URL
4. runOnce を手動実行（初回は権限承認）… 新着のみ取り込み
5. 既存記事を2ボイス化したいときは backfillDualVoiceArticles（必要なら複数回）
6. 毎日自動なら createDailyTrigger を実行
7. X の ready を取り込むなら、Apps Script のタイムゾーンを Asia/Tokyo にして createXSignalTrigger を実行（毎日 9 時台と 22 時台。平日 8:45 / 21:45 の投入の直後）

監視対象（初期設定）: OpenAI / Claude / Claude Code / Anthropic News / Google DeepMind / Google AI / Gemini / Cursor / Laravel / Vercel / Next.js / GitHub Changelog / Cloudflare / Supabase / AWS（Machine Learning）

Slack 通知は Webhook 未設定ならスキップされます（後から有効化可）。

API

POST /api/ingest

Authorization: Bearer <INGEST_SECRET>
Content-Type: application/json

{
  "source": "OpenAI",
  "title": "記事タイトル",
  "url": "https://example.com/post",
  "publishedAt": "2026-08-02T00:00:00.000Z",
  "summary": {
    "general": {
      "conclusion": "非エンジニア向け結論1行目\\n2行目\\n3行目",
      "detail": "詳細の補足1\\n詳細の補足2\\n詳細の補足3",
      "situations": ["場面1", "場面2", "場面3"],
      "terms": [{ "term": "API", "plain": "アプリ同士の接続口" }]
    },
    "engineer": {
      "conclusion": "エンジニア向け結論1行目\\n2行目\\n3行目",
      "detail": "詳細の補足1\\n詳細の補足2\\n詳細の補足3",
      "situations": ["場面1", "場面2", "場面3"],
      "terms": [{ "term": "API", "plain": "外部から機能を呼ぶインターフェース" }]
    }
  }
}

旧形式（summary.conclusion + summary.situations）も受け付け、両ボイスへ展開します。

X 由来の記事は、同じエンドポイントに次を足します。url は公式ページ、公式URLが無ければ xPostUrl と同じ投稿URLです。signalId は必須で、ready の候補だけを ingested にします。公式ページの本文を根拠にしたときだけ officialNote を付けます。結論はタイトルの転記では受け付けません。

{
  "origin": "x",
  "xPostUrl": "https://x.com/someone/status/123",
  "officialNote": "公式もこう言っている",
  "signalId": "s_0123456789abcdef"
}

origin を付けない既存の RSS 取り込みはそのまま動きます。同じ公式URLが既にあれば1件にまとまり、後から付いた X のリンクは RSS の再取り込みでは消えません。

POST /api/intake

浅子がブラウザで拾った X の候補を渡す入口です。X の API は使いません。Authorization: Bearer <INGEST_SECRET> が必要です。

{
  "items": [
    {
      "xPostUrl": "https://x.com/someone/status/123",
      "text": "Claude の新しいモデルが公開された、という投稿本文",
      "source": "Claude",
      "author": "@someone",
      "publishedAt": "2026-10-01T00:00:00.000Z",
      "impressions": 12000,
      "reposts": 80,
      "likes": 340
    }
  ]
}

1件だけなら items なしで同じフィールドを直に渡せます。サーバーが粗い仕分けをします。impressions（表示回数）・reposts（リポスト数）・likes（いいね数）は任意です。X の public_metrics でも同じ数値を読めます。無い項目は 0 として保存しません。

結果	意味
pending_review	浅子の確認待ち
filtered	短すぎる、または監視製品名が無い。restore で確認待ちに戻せる
同じ URL の再送	確認待ち以降は本文を上書きしない（duplicate: true）。数値が付いていれば、公開から14日以内の既存X記事の表示回数だけ更新する（1回あたり最大20件）。その1回だけ広げるときは、items と同じ階層に metricsRefreshWindowDays（1以上30以下の整数。例: 17）を付ける。省略すると14日のまま

GET /api/intake

同じ秘密文字列が必要です。status を省略すると作業列（pending_review / needs_factcheck / ready）です。memo や filtered、all も指定できます。

POST /api/intake/:id

浅子と龍馬の判断です。actor は記録用です（認証の分けはまだありません）。

action	誰	結果
approve + officialUrl	浅子	ready。GAS が公式ページを読んで2ボイス要約する
approve（投稿URLあり・公式URLなし）	浅子	ready。GAS が投稿本文から2ボイス要約し、記事URLは投稿URL
approve（memo。投稿URLあり、公式URLは任意）	浅子	ready。確認待ちと同じ条件。メモは自動では動かさない
flag_factcheck	浅子	needs_factcheck。裏取りが曖昧なとき龍馬へ
resolve_factcheck + officialUrl	龍馬	ready
resolve_factcheck（投稿URLあり・公式URLなし）	龍馬	ready。要約の根拠は投稿本文
reject	どちらでも	rejected
restore	浅子	filtered を確認待ちに戻す

公式URLも投稿URLも無い承認は受け付けません。公式本文が取れた X 記事には「公式もこう言っている」を出します。投稿だけが根拠の記事は「投稿から要約」と出します。以前のルールで残ったメモは /memos に残ります。記事にするには POST /api/intake/:id で action を approve にします。投稿URLがあれば公式URLは空のままでよく、一括では ready にしません。

期間は「直近3日」（window 省略時。公開日時が今から72時間以内）と「すべて」（window=all）の2つです。期間側に並び順 order=new（新しい順・既定）／order=old（古い順）を持ちます。

Xチャネル（/?channel=x）だけ、並び替え sort=latest（指定なし）、sort=impressions（インプレッション数）、sort=reposts（リポスト数）、sort=likes（いいね数）を選べます。数値を選ぶとその数値の多い順を一番目にし、数値が無い記事は後ろに並べ、同じ値（と数値が無い記事どうし）の中は期間側の新しい順・古い順です。「指定なし」は期間側の並び順だけで並べます。期間・チャネル・並びは SQL（src/lib/articleQueries.ts）で行います。All と公式サイトには並び替えを出しません。カードには取得できたインプレッションとリポスト数を出します。いいね数があればそれも出します。

GET /api/articles

保存済み記事一覧（全件。GAS の手動メンテ用）。?id= を付けると1件だけ返します。

UI

VoltAgent/awesome-design-md の Clay / Framer 系を参考にしたカード UI です。

• ソフトなグラデーション背景
• 角丸カード + ホバーで浮く
• ソース別カラーバッジ
• Space Grotesk（見出し）+ Manrope（本文）

iPhone での見方

1. Safari で Demo URL（または自分の Vercel URL）を開く
2. 共有 → ホーム画面に追加
3. 一覧タップ → 要約確認 → 必要なら「元記事で詳細を確認する」

License

MIT