SuperAPI AI 工具集

bestblogs-discover

通用与其它

查看项目

更新于 10-16 05:48

技能介绍

用途:帮助用户快速了解今日最值得读的内容,查找某主题、作者或内容类型的精选,浏览周刊,以及获取个性化流与关注源流。

主要能力(对应 CLI 原语):bestblogs discover today --json 返回带多源回退链的今日候选;bestblogs discover for-you --json 提供个性化推荐(需 Pro);bestblogs discover following --json 查看关注源流;bestblogs discover trending --period week --json 查看热趋(today / week / month);bestblogs discover search "<q>" --json 做关键词搜索;bestblogs discover newsletters --json 列出周刊;bestblogs discover newsletter <id> --json 获取单期周刊。

today 返回的候选含 resourceId、title、url、resourceType、language、score、sourceName、candidateSource、selectionReason、fallbackApplied、personalized 等字段,并返回 primarySource、fallbackApplied 与 details.triedSources。candidateSource 枚举包括 my_brief(Pro 个性化早报)、public_brief(公共精选)、public_brief_fallback、for_you、following;展示时应按该字段打徽标,并在 fallbackApplied=true 时标注降级。

使用方式:先运行 bestblogs auth status --json 检查;多数命令需 API Key,search 与 newsletters 在某些配置下可匿名消费,未登录时提示先 bestblogs auth login。常用参数含 --limit、--lang、--type、--sort。

限制与错误处理:for-you 遇 403 说明用户非 Pro,可降级到 following 或 today;brief 相关 404 表示当日早报尚未生成,可尝试 public_brief 或 following;429 时 CLI 已退避一次,仍失败应退出并提示稍后重试;candidates 为空则报告今日无推荐,并建议通过 bestblogs intake setup 建立或修正画像。

组合建议:对感兴趣条目链式调用 bestblogs-read 深读,对高价值条目调用 bestblogs-capture 收藏或加笔记,如需解释推荐原因可展示 candidateSource 与 selectionReason,更深入的解释使用 bestblogs-explain。

其余细节暂未提供。