在终端中定时并发布
fopost 是 FoPost 官方 CLI:单个静态二进制文件,无需安装其他任何东西。创建帖子、附加媒体、为所有已连接账号定时发布,并检查每次投递,无论在 shell、脚本还是 CI 任务中都能完成。
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。表格是给人看的。
清晰的退出码
错误输入、认证、权限范围、未找到、速率限制和服务器错误各有对应的退出码。
内置重试
速率限制、服务器错误和网络故障会按退避策略自动重试。
直接从流水线发布
将 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 订阅。