today.ai — AI情報フィード集約サイト

特定の X(Twitter)アカウント・Feedlyフォルダ・はてなブックマーク 人気エントリー テクノロジー から AI関連情報を自動集約し、時系列の統合タイムラインとして表示する静的サイト（GitHub Pages）。

• 基盤: Astro 5 + Tailwind v4
• 更新: GitHub Actions（6時間ごと）でフィード取得 → src/data/feed.json をコミット → Pages へデプロイ
• 公開URL想定: https://satory074.github.io/todayai/

ローカル開発

npm install
cp .env.example .env   # トークンを記入（X取得・Feedly取得をローカルで試す場合）
npm run aggregate      # 3ソースを取得して src/data/feed.json を生成
npm run dev            # http://localhost:4321/todayai/
npm run build          # 本番ビルド（型チェック込み）

npm run aggregate はトークンが無いソースを自動的にスキップし、前回キャッシュを維持します （クラッシュしません）。トークン無しでも npm run dev でサンプルデータの表示確認が可能です。

設定

feeds.config.ts を編集します。

項目	内容
x.username	取得したい X アカウントのユーザー名（@なし）
feedly.rssUrls	集約する AI 関連 RSS フィードの URL 一覧（下記参照）
feedly.perFeedLimit	1フィードあたり取り込む最大件数
hatena.rssUrl	既定 https://b.hatena.ne.jp/hotentry/it.rss
maxItems / maxAgeDays	保持件数・保持日数

各ソースは disabled: true で個別に無効化できます。

Feedly（RSS 直接集約）について

Feedly の開発者 API トークンは現在 Enterprise プラン限定で個人/Pro では取得できません （公式 Authorization docs）。 そのため Feedly API は使わず、Feedly フォルダに入れていた 各 RSS フィードを直接取得します （トークン・課金・失効なし）。表示上は従来どおり「Feedly」バッジになります。

取り込みたい RSS の URL を feeds.config.ts の feedly.rssUrls に列挙するだけです。 Feedly フォルダの購読 RSS 一覧は OPML エクスポート（feedly.com → Organize sources / feedly.com/i/opml）から取得できます。 フィードごとに try/catch するため、1本が落ちても他は表示されます。

X(Twitter) について

X API は叩きません。basecamp が公開している x-tweets.json （https://storage.googleapis.com/basecamp-feeds/x-tweets.json）を読むだけです。これにより:

• X API・トークン・追加課金が不要
• basecamp の X feed とトークンローテーションが競合しない

feeds.config.ts の x.categories で post / like / bookmark を選べます（既定は post のみ）。

デプロイ（初回セットアップ）

1. このディレクトリを git 初期化し、GitHub に todayai リポジトリを作成して push
2. リポジトリ Settings → Pages → Build and deployment → Source: GitHub Actions
3. Settings → Secrets and variables → Actions（任意）:
   • X_BEARER_TOKEN … 外部アカウントのポスト取得用（未設定ならそのソースをスキップ）。
   • Feedly・はてブは公開 RSS を直接読むためトークン不要。
4. feeds.config.ts の feedly.rssUrls を確認（X は設定済み）
5. Actions タブ → 「Update feeds & Deploy」→ Run workflow（workflow_dispatch）で初回実行

以降は6時間ごとに自動更新・デプロイされます。

構成

feeds.config.ts            ソース定義（username / streamId / URL / 保持設定）
scripts/aggregate.ts       集約オーケストレータ（取得→正規化→マージ→trim→書き出し）
scripts/sources/           x.ts / feedly.ts / hatena.ts
src/data/feed.json         集約キャッシュ（CIがコミット）
src/lib/feed.ts            FeedItem 型・相対時刻などのヘルパ
src/components/            Layout / FeedCard / SourceFilter
src/pages/                 index / about / rss.xml
.github/workflows/         update-and-deploy.yml