用途:该技能面向需要以编程方式操作自托管 CommaFeed RSS 阅读器的场景,通过其 REST API 完成分类、订阅、条目管理与设置调整。所有请求以 $COMMAFEED_HOST/rest 为基址,采用 HTTP Basic Auth 认证。使用前必须设置环境变量 COMMAFEED_HOST(实例 URL,含协议、无尾部斜杠)、COMMAFEED_USER、COMMAFEED_PASS,未设置时应先向用户索取。
主要能力:分类管理(获取分类树、增删改、折叠、获取条目、标记已读、未读计数);订阅源管理(订阅、退订、修改、获取详情、按 URL 预览、刷新全部、获取条目、标记已读、favicon、OPML 导出与导入);单条条目操作(标记已读/未读、批量标记、收藏、打标签、获取全部标签);用户资料与设置(获取和更新资料、删除账户、获取与保存设置);服务器信息(获取无需认证的服务器信息、图片代理);管理员端点(需 ADMIN 角色,含指标、用户列表、查询、保存与删除,资料中删除部分被截断,相关参数暂未提供)。
必要用法:只读请求如 curl -s -u "$COMMAFEED_USER:$COMMAFEED_PASS" "$COMMAFEED_HOST/rest/category/get" | jq .;写入请求需加 -X POST 与 -H "Content-Type: application/json",OPML 导入使用 multipart/form-data(-F "file=@subscriptions.opml"),不能用 JSON。
限制:资料未提供收费、价格与可用平台信息;refreshAll 调用过频会返回 429;管理员端点需 ADMIN 角色;导入、删除账户等操作请谨慎。