CLIAPI

在终端中定时并发布

fopost 是 FoPost 官方 CLI:单个静态二进制文件,无需安装其他任何东西。创建帖子、附加媒体、为所有已连接账号定时发布,并检查每次投递,无论在 shell、脚本还是 CI 任务中都能完成。

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

单个二进制文件

支持 macOS、Linux 和 Windows 的 amd64 与 arm64。可通过 Homebrew、go install 或发行版压缩包安装。

为脚本而生

每个命令都支持 --json,错误输出到 stderr,每种失败都有各自的退出码。

绝不意外发布

在你传入 --publish、运行 posts publish 或设置定时之前,帖子始终是草稿。

帖子

一条命令完成创建、定时和发布

posts create 接收账号、文本、本地媒体文件和时间。文件会上传到你的媒体库并自动附加。长文案可来自文件或管道,预检会在发送前针对每个目标网络检查帖子。

阅读帖子命令
帖子
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

定时或发布

传入时间即定时,传入 --publish 立即发送,什么都不传则保留为草稿。

预检

发布前查看哪些账号已就绪或被阻止,以及原因。

投递状态

查看每个账号的状态、尝试次数,以及网络返回的线上链接。

脚本

输出 JSON,返回退出码

为任何命令加上 --json,并将结果通过管道传给 jq。401、404、速率限制和错误请求各自以不同的退出码结束,脚本无需解析文本即可区分。每个请求在底层都会自动重试并退避。

阅读脚本指南
需要处理的账号
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

处处支持 --json

资源本身以缩进格式输出到 stdout。表格是给人看的。

清晰的退出码

错误输入、认证、权限范围、未找到、速率限制和服务器错误各有对应的退出码。

内置重试

速率限制、服务器错误和网络故障会按退避策略自动重试。

CI

直接从流水线发布

将 API 密钥设为密文,指定工作区,CLI 就无需任何已保存的配置。可发布版本公告、分享更新日志,或在预检失败时阻止合并。针对 GitHub,还有封装同一流程的官方 Action。

开始构建
每个标签自动发布版本说明
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

从环境变量读取密钥

自动读取 FOPOST_API_KEY。CI 中无需登录步骤。

适配任何 CI 系统

GitHub Actions、GitLab CI,或任何能运行 shell 的环境。

自动化与 Webhook

在同一个工具中触发自动化并管理 Webhook 订阅。

关于 CLI 的常见问题解答

如何安装 CLI?

运行 brew install fopost/tap/fopost,或运行 go install github.com/fopost/fopost-cli@latest,也可以从 GitHub 发布页下载适合你平台的压缩包,并将 fopost 放入 PATH。

需要账号吗?

需要。CLI 与托管的 FoPost API 通信,因此需要 API 密钥,可在控制台的“设置”,“API 密钥”中创建。用 fopost auth login 保存,或改为设置 FOPOST_API_KEY。

我的 API 密钥存储在哪里?

存储在你的用户配置文件夹中,仅你本人可读。CLI 绝不会回显密钥:auth status 只显示被遮蔽的前缀,详细输出中也不包含它。

它能做什么?

帖子、账号及其健康状态、工作区、媒体上传、标签、分析、自动化和 Webhook。运行 fopost --help 或查阅 CLI 文档了解所有命令。

它是开源的吗?

是的。CLI 采用 MIT 许可,源码位于 GitHub 的 fopost/fopost-cli。

今天就基于 CLI 开始构建

免费开始,包含完整 API。创建密钥,几分钟内完成第一次调用。

获取 API 密钥