feedport

feedport

feedport 可为你读取网络订阅源。提供 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 服务

一个二进制文件同时支持两种用途。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，以及 items——每个条目都包含 title、link 和 description；如果文档中有 pubDate 和 guid，也会一并返回。
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。