跳转到主要内容
Logo

CLI 工具

@bestblogs/cli — 官方命令行工具，封装 OpenAPI 调用与认证。

它是什么

@bestblogs/cli 是 BestBlogs 官方维护的命令行工具，用 TypeScript / Node.js 编写。

封装了：

  • OpenAPI Key 管理（一次配置，全局可用）
  • 分页、错误重试、限流等待
  • 常用资源族的命令式接口

适合脚本、智能体集成、本地工作流自动化。

安装

# 全局安装
npm i -g @bestblogs/cli

# 验证
bestblogs --version

首次配置

bestblogs auth login
# 提示输入 OpenAPI Key（在 设置 → OpenAPI 创建）
# Key 会被加密保存到 ~/.bestblogs/config.json

也可以用环境变量：export BESTBLOGS_API_KEY=bb_live_xxx，CLI 会优先读取。

常用命令

拉取今天的早报

bestblogs brief today
bestblogs brief today --json > today.json

列精选内容

bestblogs discover list --type article --time 1w --qualified
bestblogs discover list --type podcast --language zh --limit 50

取某条内容的正文 + 摘要

bestblogs read get art_123
bestblogs read get art_123 --summary key_points

收藏 / 划线

bestblogs capture bookmark art_123 --folder inbox --tags 灵感,待写
bestblogs capture highlight art_123 --text "..." --comment "..."

调用 AI 伴读追问

bestblogs copilot ask art_123 "作者推荐的 Agent 架构是什么？"

列出我的关注源

bestblogs sources list --following

在脚本里使用

CLI 默认输出表格，加 --json 可输出 JSON 直接管道处理：

bestblogs discover list --type article --time 24h --qualified --json \
  | jq '.data[] | {title, score, url}'

与 LLM / Agent 集成

CLI 命令是面向智能体设计的——所有命令都接受 --json 输出，错误码遵循标准 POSIX 约定，token 用量在 stderr 输出。

如果你在写一个本地阅读智能体，推荐的最小流程：

  1. bestblogs brief today --json 拿今天要读的内容
  2. 对每条 bestblogs read get <id> --summary key_points
  3. 写回 bestblogs capture bookmark <id> --note "..."

Claude Code / Codex / Cursor 用户：直接装 Agent Skills（npx @bestblogs/skills install）即可，5 个 skill 已经把上面的最小流程封装好，按自然语言主动触发。

详细 schema 与高级用法见 GitHub README。

← 回到文档首页