Postemi: Social Media Scheduler

Postemi CLI

通过命令行或 AI Agent 安排社交媒体发布。

Postemi（https://postemi.com）是一款社交媒体发布排期工具，而这是它的命令行工具。它使用与 Web 应用相同的公开 API：你在这里安排的内容会显示在 Postemi 日历中，你在那里安排的内容也能在这里看到。

渠道：37 个平台和应用，包括 Facebook、Instagram、X、LinkedIn、TikTok、YouTube、Threads、Bluesky、Pinterest 和 Mastodon。

套餐：使用 CLI、API 和 MCP 需要 Pro 或更高级别的套餐（Pro、Creator 或 Team）。Basic 套餐不提供 API 访问权限。

SKILL.md 是完整的命令参考，专为 AI Agent 编写。 将它提供给 Claude、ChatGPT、Codex、OpenClaw 或 Hermes，它们就能使用整个 CLI，无需进一步说明。

安装

npm install -g postemi
postemi --help

Node.js 18 或更高版本。

登录

postemi auth:login     # device flow: opens postemi.com/app/device in the browser
postemi auth:status    # checks the credential
postemi auth:logout    # deletes the stored credential

登录 Postemi 后，在浏览器中批准登录，并选择密钥可以访问的工作区和渠道。CLI 会将密钥存储在 ~/.postemi/credentials.json 中（模式为 0600）。

还没有账户？从终端创建一个：

postemi auth:signup --email [email protected]    # e-mails a code, asks for it and for the terms
postemi auth:signup --email [email protected] --code 123456 --accept-terms --workspace-name "Anna's Cafe"

用户必须先同意 https://postemi.com/terms 和 https://postemi.com/privacy。通过 postemi auth:signup 创建的账户没有免费试用期：接下来需要运行 postemi billing:plans 和 postemi billing:subscribe。如果改为在 https://postemi.com/app/signup 注册，则会开始 7 天免费试用；然后运行 postemi auth:login。

对于没有浏览器的服务器、CI 或 Agent，请使用 Web 应用“Settings（设置）”中的“Developers（开发者）”页面提供的 API 密钥：

export POSTEMI_API_KEY=your_api_key

变量	默认值	用途
POSTEMI_API_KEY	无	不使用 auth:login 时的 API 密钥
POSTEMI_API_URL	https://api.postemi.com	API 基础地址
POSTEMI_WORKSPACE	无	每条命令使用的工作区 ID（与 --workspace 相同）
POSTEMI_TIMEZONE	无	为未指定偏移量的日期指定的 IANA 时区
POSTEMI_AUTH_SERVER	https://api.postemi.com	auth:login 执行设备授权流程的服务地址
POSTEMI_CLIENT_NAME	Postemi CLI	批准页面上显示的名称

通过 auth:login 存储的凭据优先于 POSTEMI_API_KEY。

快速开始

postemi auth:status
postemi integrations:list                        # your channels and their ids
postemi config:set timezone Europe/London        # once: how to read dates without an offset

IMG=$(postemi upload ./photo.jpg | jq -r '.path')
postemi posts:create -c "Hello from the terminal" -m "$IMG" \
  -s "2026-12-31 09:00" -i "<integration-id>"

结果以 JSON 格式输出到 stdout；状态行和错误输出到 stderr，所有失败都会以状态码 1 退出。运行 postemi <command> --help 查看各命令的帮助。

Agent 技能（可选）

CLI 可以将技能安装到你机器上的编码 Agent 中（Claude Code ~/.claude/skills、Codex ~/.codex/skills 或 $CODEX_HOME/skills、Cursor ~/.cursor/skills、Grok Build ~/.grok/skills）。其中都会包含核心 postemi 技能；另外两项为可选技能：

postemi skills list                    # core, writing, growth: installed where
postemi skills add writing             # ideas, hooks, formatting, templates
postemi skills add growth              # niche, cadence, 30-day plan
postemi skills add all --agent claude --yes
postemi skills remove growth

在终端运行 postemi auth:login 后，CLI 会询问一次你是否需要写作和增长技能（默认选择 No），并将选择记录在 ~/.postemi/config.json 中。Agent 或脚本运行 CLI 时（没有终端、设置了 --json 或设置了 CI），CLI 不会提问；它只会显示一行提示，而且只显示一次。 如果检测到多个 Agent，CLI 会询问你要使用哪一个；使用 --agent 和 --yes 可跳过此询问。

更多信息

• SKILL.md：所有命令、标志和规则
• PROVIDER_SETTINGS.md：各渠道设置
• SUPPORTED_FILE_TYPES.md：支持的八种媒体类型
• examples/：可直接使用的 --json 负载
• 面向聊天客户端的 MCP 服务：https://mcp.postemi.com/mcp
• 帮助：https://postemi.com/help，支持邮箱：[email protected]
• 隐私：https://postemi.com/privacy，条款：https://postemi.com/terms

面向 AI Agent 的插件

此仓库还包含 Postemi 插件，位于 plugins/：

文件夹	适用对象	内容
plugins/postemi-mcp	Claude（聊天、桌面、Code）	托管的 MCP 服务 https://mcp.postemi.com/mcp，以及一个技能
plugins/postemi-cli	Claude Code	此 CLI 的技能；Agent 会运行 postemi 命令
plugins/postemi-chatgpt	ChatGPT	ChatGPT 应用包
plugins/postemi-cursor	Cursor	MCP 服务、技能和命令
plugins/postemi-grok	Grok Build	MCP 服务、技能和命令
plugins/postemi-growth	Claude Code、Cursor、Grok Build	可选：仅包含增长技能

在 Claude Code 中：

claude plugin marketplace add norbertlevente/postemi-agent
claude plugin install postemi@postemi-agent        # MCP server
claude plugin install postemi-cli@postemi-agent    # CLI skill

单独使用的技能（适用于 OpenClaw 和其他 Agent）位于 skills/postemi/SKILL.md。

写作与增长技能

另外还有三个技能可帮助 Agent 撰写帖子，而不只是安排发布时间：

技能	内容	所在插件
skills/postemi-writing	帖子创意、吸引点和标题、开场句、格式、串帖、各个平台的写作规则，以及发布前检查	每个主插件中
skills/postemi-templates	Postemi 撰写器的模板和吸引点库，由 Web 应用生成	每个主插件中，与写作技能一同提供
skills/postemi-growth	选择平台和第一个细分领域、30 天测试、解读数据、发布频率、一个主题的 30 个切入角度、内容再利用、简介和个人资料链接、每周回顾	可选：独立插件 plugins/postemi-growth

claude plugin install postemi-growth@postemi-agent   # the optional growth plugin

使用 CLI 时，写作和增长功能均为可选；详见下文。

开发

pnpm install
pnpm build        # dist/index.js
pnpm test         # type check, build, unit tests (test/), scripts/check.mjs (manifests, skill copies, no other-brand text)
node dist/index.js --help

pnpm sync:templates ../postemi/src/lib/app/templates   # regenerate skills/postemi-templates/reference from the web app
pnpm sync:skills                                       # copy writing and templates into the main plugins, growth into postemi-growth

发布步骤：PUBLISHING.md。变更记录：CHANGELOG.md。

许可证：AGPL-3.0，详见 LICENSE。 源代码：https://github.com/norbertlevente/postemi-agent