Home
Softono
feed-curator

feed-curator

Open source MIT TypeScript
23
Stars
2
Forks
12
Issues
0
Watchers
2 months
Last Commit

About feed-curator

Personalized RSS briefings for developers, powered by Claude Code. No API keys needed.

Platforms

Web Self-hosted

Languages

TypeScript

Links

Feed Curator

Personalized RSS briefings for developers, powered by Claude Code. No separate API keys.

Your reading history trains the curation — the more you read and dismiss, the sharper your daily briefing becomes.

日本語版は下にあります / Japanese version below

Briefing View — AI-generated daily briefing with topic clusters

Daily Briefing — AI clusters articles by topic and summarizes each group

More screenshots
All Articles Feed Management
All View Feeds View
Score-ranked articles with tier grouping Manage feeds by category

Features

  • No API Keys — Claude Code itself is the AI curator; no separate API key setup required
  • Personalized Scoring — Learns from your reading history (reads, dismisses) to boost what you care about
  • AI Curation — Scores relevance (0.0-1.0), writes summaries, assigns topic tags — all in your language
  • Daily Briefing — AI clusters today's articles by topic with summaries
  • Feed Collection — Register RSS/Atom feeds by URL or discover them by topic via AI
  • Web UI — Two-column layout with tier grouping, filters, read/unread tracking, dark/light theme
  • Multi-language — Summaries and briefings written in your preferred language

Requirements

Quick Start

# Install and start
npx feed-curator serve
# Open http://localhost:3000

Or install globally:

npm install -g feed-curator
feed-curator serve
  1. Choose your language when prompted on first visit
  2. Add feeds — discover by topic in the search box, or load a starter pack:
    npx feed-curator init --starter   # Adds 12 popular dev/AI/security feeds
  3. Click "Update" to fetch articles + AI curate + generate briefing

That's it — the Web UI handles everything. For advanced use, see the CLI commands below.

CLI Commands

feed-curator init --starter            # Load starter feed pack
feed-curator add <url> [-c category]   # Register RSS feed
feed-curator list                      # List registered feeds
feed-curator fetch                     # Fetch articles from all feeds
feed-curator add-article <url>         # Add single article URL
feed-curator articles [--uncurated] [--unread] [--json]
feed-curator update <id> --score <n> --summary "..." [--tags "a,b"]
feed-curator tag <id> <tags>           # Set tags on an article
feed-curator read <id...>              # Mark articles as read
feed-curator unread <id...>            # Mark articles as unread
feed-curator categorize <id> <cat>     # Set feed category
feed-curator profile [--prompt]        # Show reading profile
feed-curator serve [--port 3000]       # Start web UI server
feed-curator config <key> [value]      # Get/set config

All commands also work with npx feed-curator <command>.

Web UI

Start with feed-curator serve and open http://localhost:3000.

Views

  • Briefing — AI-generated daily briefing with topic clusters
  • All — All articles (curated and uncurated) grouped by tier
  • Archive — Dismissed and archived articles
  • Feeds — Manage registered feeds by category

Features

  • Tier grouping — Must Read (85-100) / Recommended (70-85) / Worth a Look (50-70) / Low Priority (0-50)
  • Score ring — Visual score indicator per article
  • One-click actions — Update (fetch + curate + briefing), or run each step individually
  • Feed discovery — Enter a topic in the sidebar to discover and add feeds via AI
  • Filters — Category, read status, tags (combinable, persisted in URL)
  • Read tracking — Click to read, checkbox toggle, mark-all-read per section, skip/dismiss
  • Dark/Light/Auto theme — Follows OS by default, or manually toggle (saved to localStorage)
  • Multi-language — Select your language on first visit; summaries and briefings use it

How Curation Works

  1. Fetch — pulls new articles from all registered RSS feeds
  2. Curate — AI reads uncurated articles and for each one:
    • Scores relevance (0.0-1.0) based on novelty, depth, utility
    • Adjusts scores using your reading profile (preferred/ignored tags)
    • Writes a 2-3 sentence summary in your configured language
    • Assigns 1-3 topic tags
  3. Briefing — AI clusters today's curated articles by topic with summaries
  4. Results appear in the Web UI and a Markdown digest is generated

In the Web UI, the Update button runs all three steps in sequence.

Architecture

CLI (Node.js + TypeScript + SQLite)     Web UI (SSE-based)
  Data management                         Update / Fetch / Curate / Briefing
  Feed fetching & parsing                 Feed discovery
  Web UI server (http)                    Read/dismiss/filter management

No API keys needed — Claude Code itself is the AI.

Data

  • SQLite database: data/feed-curator.db (auto-created, gitignored)
  • Digest output: output/digest-YYYY-MM-DD.md (gitignored)

Roadmap

Next

Planned

Exploring


Feed Curator

Claude Codeで動く、APIキー不要の、開発者向けパーソナル技術朝刊。

読んだ記事・スキップした記事から嗜好を学習し、毎日のブリーフィングを最適化します。

ブリーフィングビュー

日次ブリーフィング — AIが記事をトピック別にクラスタリングして要約

その他のスクリーンショット
記事一覧 フィード管理
全記事ビュー フィードビュー
スコア順・ティア別の記事表示 カテゴリー別のフィード管理

特徴

  • APIキー不要 — Claude Code自身がAIキュレーター。別途APIキーの設定は不要
  • パーソナライズ — 既読・スキップ履歴から学習し、興味のあるトピックのスコアを自動調整
  • AIキュレーション — 関連度スコア(0.0-1.0)、要約、トピックタグを設定言語で生成
  • 日次ブリーフィング — AIが今日の記事をトピック別にクラスタリングして要約
  • フィード収集 — URLでRSS/Atomフィードを登録、またはトピックでAIが自動検索
  • Web UI — 2カラムレイアウト、ティア別グループ、フィルター、既読管理、ダーク/ライトテーマ
  • 多言語対応 — 要約とブリーフィングを設定した言語で出力

必要なもの

クイックスタート

# インストールして起動
npx feed-curator serve
# http://localhost:3000 を開く

またはグローバルインストール:

npm install -g feed-curator
feed-curator serve
  1. 初回アクセス時に言語を選択
  2. フィードを追加 — 検索ボックスでトピック検索、またはスターターパックを読み込み:
    npx feed-curator init --starter   # 開発/AI/セキュリティの人気フィード12件を追加
  3. 「Update」ボタンで記事取得 → AIキュレーション → ブリーフィング生成を一括実行

Web UIですべて完結します。高度な使い方はCLIコマンドを参照してください。

CLIコマンド

feed-curator init --starter             # スターターフィードパックを読み込み
feed-curator add <url> [-c カテゴリー]  # RSSフィード登録
feed-curator list                       # 登録フィード一覧
feed-curator fetch                      # 全フィードから記事取得
feed-curator add-article <url>          # 単独記事URL追加
feed-curator articles [--uncurated] [--unread] [--json]
feed-curator update <id> --score <n> --summary "..." [--tags "a,b"]
feed-curator tag <id> <tags>            # 記事にタグ設定
feed-curator read <id...>               # 既読にする
feed-curator unread <id...>             # 未読に戻す
feed-curator categorize <id> <cat>      # フィードのカテゴリー設定
feed-curator profile [--prompt]         # 読書プロファイル表示
feed-curator serve [--port 3000]        # Web UIサーバー起動
feed-curator config <key> [value]       # 設定の取得/変更

npx feed-curator <コマンド> でも同様に使えます。

キュレーションの仕組み

  1. Fetch — 全フィードから新着記事を取得
  2. Curate — AIが未キュレーション記事を処理:
    • 新規性、技術的深さ、実用性に基づきスコアリング (0.0-1.0)
    • 既読履歴のプロファイルに基づきスコアを調整
    • 設定言語で2-3文の要約を生成
    • 1-3個のトピックタグを付与
  3. Briefing — AIが今日のキュレート記事をトピック別にクラスタリングして要約
  4. Web UIとMarkdownダイジェストに結果が反映

Web UIのUpdateボタンで3ステップを一括実行できます。

ロードマップ

次のリリース

計画中

検討中

ライセンス

MIT