feedport

feedport

feedport は Web フィードを読み取ります。RSS 2.0 または Atom ドキュメントのアドレスを渡すと、フィードのタイトル、リンク、説明に加え、項目のタイトル、リンク、説明、日付、IDを整形して返します。生の XML を確認する必要はありません。また、アドレスを先に確認して、そこにあるものが本当にフィードかどうかを判定することもできます。

インストール

npx @reneturcios/feedport validate-feed https://example.com/feed.xml

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/feedport

コンテナはデフォルトで MCP サーバーを起動します（下記参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

すべてのコマンドは JSON を出力します。

# Whole feed: channel metadata plus items
feedport fetch-feed https://example.com/feed.xml

# Just the items, at most five of them
feedport fetch-feed-items https://example.com/feed.xml --limit 5

# Is this address actually a feed?
feedport validate-feed https://example.com/feed.xml
# {"valid": true, "format": "rss", "item_count": 12}

feedport --version

終了コード：成功時は 0、フィードを取得または解析できない場合は 1（エラーに問題の内容が示されます）、使い方に誤りがある場合は 2 です。

MCP サーバー

1 つのバイナリでどちらの用途にも対応します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/feedport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "feedport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/feedport", "mcp"]
    }
  }
}

ツール

ツール	入力	返される内容
fetch_feed	url（文字列、必須）、limit（整数、任意）	フィードの title、link、description に加え、各項目の title、link、description、およびドキュメントに含まれている場合は pubDate と guid を含む items。
fetch_feed_items	url（文字列、必須）、limit（整数、任意）	fetch_feed の items と同じ形式の項目リストのみ。
validate_feed	url（文字列、必須）	valid、検出された format（rss、atom、unknown のいずれか）、item_count、およびアドレスが利用可能なフィードではない場合の error 文字列。

RSS 2.0 の項目は <item> 要素から取得され、Atom のエントリーは <entry> 要素から取得されます。Atom では、エントリーの概要（またはコンテンツ）が説明になり、公開日（または更新日）が pubDate になり、ID が guid になります。CDATA セクションと XML エンティティはデコードされます。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。