mcpField
F
freshrss

freshrss

github.com/wmy2981生産性155 回インストール5 週間前に更新
リポジトリ

freshrss について

freshrssは、FreshRSSのGoogle Reader互換APIを通じて購読フィードや記事を扱うスキルです。セルフホスト型RSSリーダーの利用者向けに、Pythonスクリプトで閲覧、検索、フィード管理を行います。

主な機能

  1. 01最新・未読・スター付き記事の表示
  2. 02フィードまたはカテゴリで記事を絞り込み
  3. 03記事のタイトルや本文を検索
  4. 04フィードとカテゴリの管理
  5. 05記事の既読化やスター設定
  6. 06JSON形式で結果を出力

活用シーン

  1. 01FreshRSSの未読記事を確認
  2. 02購読記事からキーワードを検索
  3. 03フィードの追加、移動、削除
  4. 04トピック別に新しいフィードを探す

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/wmy2981/skills --skill freshrss

インストール後、Claude Code で/freshrssを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.claude-plugin/
plugin.json
references/
api_doc.md
scripts/
.env.example
freshrss.py

詳細

FreshRSS

Google Reader 互換 API（GReader）経由でアクセスするセルフホスト可能な RSS リーダーです。 すべての操作は 1 つの Python スクリプトを通じて実行します。

実行ルール

依存関係、環境変数、設定を事前に確認せず、ユーザーが要求したコマンドを直接実行してください。問題があれば、スクリプトが明確なエラーを表示します。その場合に限り、確認して修正してください。

環境変数

変数説明
FRESHRSS_URLベース URL（例：http://127.0.0.1:1180）
FRESHRSS_API_USERAPI ユーザー名
FRESHRSS_API_PASSWORDAPI パスワード

💡 環境変数は ~/.wmyskills/.env（スキル間で共有）または scripts/.env（存在する場合はこちらが優先）で設定できます。スクリプトが自動的に読み込みます。

使用方法

python scripts/freshrss.py <command> [options]

記事を読むコマンドでよく使うオプション：--count N（デフォルトは 20）、-v／--verbose（要約テキストを含める）。

記事を読む

最近の記事
python scripts/freshrss.py recent --count 10
python scripts/freshrss.py recent --count 5 -v    # with summary
未読の記事
python scripts/freshrss.py unread --count 20
特定のフィードの記事
python scripts/freshrss.py feed --url "https://example.com/rss" --count 10
カテゴリ内の記事
python scripts/freshrss.py category --name "Technology" --count 15
スター付きの記事
python scripts/freshrss.py starred --count 20
記事を検索

タイトルのみ（高速。デフォルトでは 200 件をスキャンし、最大 1000 件）：

python scripts/freshrss.py search -k "keyword"

タイトルと本文（低速。スキャン件数の調整には --batch を使用）：

python scripts/freshrss.py search -k "keyword" --deep --batch 500

フィード管理

すべての購読を一覧表示
python scripts/freshrss.py list-feeds
カテゴリを一覧表示
python scripts/freshrss.py list-categories
未読件数
python scripts/freshrss.py unread-count
フィードを追加
python scripts/freshrss.py add-feed --url "https://example.com/feed.xml" --category "News"
フィードを別のカテゴリに移動
python scripts/freshrss.py move-feed --feed-id "feed/https://..." --to "NewCat" --from "OldCat"
フィードを削除
python scripts/freshrss.py remove-feed --feed-id "feed/https://..."
記事を既読にする
python scripts/freshrss.py mark-read --item-id "tag:google.com,2005:reader/item/..."
記事にスターを付ける
python scripts/freshrss.py star --item-id "tag:google.com,2005:reader/item/..."

フィードのおすすめ

おすすめを求められた場合：

  1. list-feeds を実行して、現在の購読とカテゴリを確認します
  2. フィードのタイトルとカテゴリからテーマを特定します
  3. ウェブ検索を使って、ユーザーがまだ購読していない、類似トピックのフィードを探します
  4. 興味のある分野ごとにおすすめをまとめて提示します

注意事項

  • 認証トークンは呼び出しごとに新しく取得します（キャッシュは不要です）
  • 出力はすべて JSON 形式で、簡単に解析できます
  • GReader API に検索機能がないため、検索はクライアント側で絞り込みます
  • フィードストリーム ID は feed/https://example.com/rss の形式です
  • -v を使用すると、出力に記事の要約を含められます（すべての記事読み取りコマンドで使用できます）

コメント

Markdown 対応