OpenAPI
通过 OpenAPI 与 CLI 把 BestBlogs 的精选内容、早报和阅读数据接入你的工作流或智能体。
BestBlogs 提供完整的 OpenAPI 与官方 @bestblogs/cli，把平台变成你工作流和智能体可调用的内容基础设施。
三类资源族
| 资源族 | 典型场景 | 关键端点 |
|---|---|---|
| Discover（发现） | 列精选内容、抓主题页、读早报 / 周刊 | /api/v2/resources、/api/v2/topics、/api/v2/brief |
| Read（阅读） | 拉单篇正文 / 摘要 / 翻译，触发 AI 伴读 | /api/v2/resources/{id}、/api/v2/copilot/* |
| Capture（沉淀） | 写收藏、划线、阅读历史 | /api/v2/bookmarks、/api/v2/highlights、/api/v2/history |
三种使用方式
| 层 | 形态 | 谁来用 |
|---|---|---|
| REST 直连 | OpenAPI（HTTP + JSON） | 任意编程语言、服务端集成。详见 认证 与 主要端点 |
| CLI | @bestblogs/cli 命令行 |
人类、脚本、CI；TypeScript 实现，封装认证、分页、错误重试 |
| Agent Skills | @bestblogs/skills SKILL.md 套件 |
Claude Code / Codex / Cursor 等智能体主动触发，覆盖 5 个 skill / 25 个原语 |
三层共享同一套底层契约：CLI shell out 到 OpenAPI，Skills 又 shell out 到 CLI。挑哪一层取决于使用者是 代码 / 人 / 智能体。
谁能用
| 账户 | 端点范围 |
|---|---|
| 免费版 | 基础发现端点（精选内容列表、来源目录、公共早报） |
| Pro | 完整 v2（含我的早报、为你推荐、AI 伴读、收藏 / 划线 / 阅读历史） |
API 与 CLI 都遵循 BestBlogs 术语表：用户对源的动作统一是 follow / unfollow，付费关系才用 subscribe。
下一步
- 认证 — 如何申请 OpenAPI Key、如何携带 Token。
- 主要端点 — 各资源族的关键参数与示例响应。
- CLI 工具 —
npm i -g @bestblogs/cli之后的几条常用命令。 - Agent Skills —
npx @bestblogs/skills install一键装到 Claude Code / Codex。