Postatron

postatron-cli

适用于 Postatron 的命令行客户端和 MCP 服务。Postatron 是一个社交媒体排期工具，可将一条帖子发布到你已连接的所有平台。

此仓库包含通过终端或 AI Agent 使用 Postatron 所需的一切。 服务本身为闭源。

• cmd/postatron - CLI。
• cmd/postatron-mcp - 通过标准输入输出运行的本地 MCP 服务，供无法连接远程服务的客户端使用。
• apiv1 - REST API 的 Go 客户端，以及 API 本身所基于的请求和响应类型。

连接 Claude（无需安装）

Postatron 在以下地址托管 MCP 服务：

https://api.postatron.com/mcp

在 Claude 中将其添加为自定义连接器（Settings → Connectors → Add custom connector），并在提示时登录。

Claude Code：安装插件，即可一步连接服务并添加 Postatron 技能。

/plugin install postatron --marketplace henrwal/postatron-cli

在终端中的 Claude Code 里运行（v2.1.275 或更高版本）；它会提示添加 Postatron 市场，然后进行安装。 Claude 桌面应用没有 /plugin 命令：请改为添加上面的连接器 URL。

然后运行 /mcp 并登录 Postatron。 若只想连接服务，不安装技能：

claude mcp add --transport http postatron https://api.postatron.com/mcp

任何支持通过 OAuth 2.1 和动态客户端注册连接远程 MCP 服务的客户端，都可以采用相同方式使用。 无需复制密钥：客户端会自行注册，你只需在 Postatron 的授权页面上批准即可。

Agent 技能

npx skills add henrwal/postatron-cli

将 postatron 技能安装到 Claude Code、Codex、Cursor 以及 skills CLI 支持的其他 Agent 中。 Claude Code 中的上述插件已包含该技能。 它会教 Agent 如何处理类似“明天上午 9 点将这条内容排期发布到 LinkedIn 和 X”的请求：找到合适的个人资料，按你的时区确定时间，遵守各平台的限制，添加媒体，并在发布前确认。 连接了 MCP 工具时，它会通过这些工具执行；否则会使用 CLI 或 REST。

安装 CLI

从 Releases 下载适用于你平台的二进制文件，或使用 Go 1.23 或更高版本从源代码构建：

go install github.com/henrwal/postatron-cli/cmd/postatron@latest
go install github.com/henrwal/postatron-cli/cmd/postatron-mcp@latest

获取 API 密钥

在 postatron.com/dashboard/api 创建密钥。 密钥具有作用域，且只会在创建时显示一次。 所有付费方案均包含 API、MCP 服务和 CLI。

export POSTATRON_API_KEY=ptn_your_key_here

如有需要，可通过 POSTATRON_API_URL 覆盖 API 主机。

使用 CLI

postatron create-post --content "Shipping today." --platforms x,linkedin
postatron create-post --content "Out on Friday." --platforms x --scheduled-at 2026-09-12T09:00:00Z
postatron create-post --content "New in store" --platforms instagram --profile Acme --media-urls https://example.com/shoe.jpg
postatron list-posts --status scheduled
postatron get-post <id>
postatron delete-post <id>
postatron delete-posts <id> <id>
postatron update-post <id> --add-platforms instagram
postatron retry-post <id>
postatron list-events --range 24h --status error
postatron list-accounts
postatron connect-account instagram --profile Acme
postatron list-profiles
postatron create-profile "Acme Ltd"
postatron create-connect-session --profile "Acme Ltd" --platforms instagram --redirect-url https://app.example.com/connected
postatron list-queues
postatron create-queue --name "Weekday mornings" --timezone Europe/London --slots "mon 09:00,wed 09:00"
postatron create-post --content "Whenever there's room" --platforms x --queue "Weekday mornings"
postatron get-usage
postatron get-analytics --range 7d
postatron create-upload --purpose "photo for Tuesday"
postatron get-upload <id>
postatron webhooks create --url https://example.com/webhooks/postatron --events post.failed,post.partial
postatron webhooks test <id>

在任何命令后添加 --json，即可获取原始 API 响应。 完整参考见 docs/cli.md。

帖子发布失败时

每次投递失败都会附带一个 error_code，说明应如何处理：reconnect（使用 connect-account --account-id 重新登录账号，或通过 MCP 使用 connect_account）、rate_limited、platform_unavailable 和 postatron（重试）、media_rejected 和 validation（修改内容后创建新帖子）、policy 和 unknown（阅读错误消息）。 retry-post（retry_post）会将帖子重新发送到发布失败的账号，不会发送到已成功发布的账号，也不会再次收费。 list-events（list_events）读取的日志与控制面板 Logs 页面相同。

Webhooks

帖子发布、部分发布或失败，以及账号连接、断开连接或需要重新连接时，Webhook 会向你自己的服务器发送带签名的 JSON 事件。 可在控制面板中设置，也可使用 POST /v1/webhooks 或 postatron webhooks create 创建；请使用其密钥检查每个请求中的 Postatron-Signature。docs/api.md 说明了相关规则，并提供 Go、Node 和 Python 的校验示例。

配置文件

配置文件用于归组已连接的账户，通常每个品牌或客户对应一个配置文件，且每个平台最多包含一个账户。 每个人都有一个 Default 配置文件；付费方案可添加更多配置文件。 传入 --profile（CLI）或 profile（API 和 MCP），即可代表一个品牌发布内容。 当某个平台在多个配置文件中都有账户时，如果未指定配置文件，系统会拒绝按平台发布，而不会同时发送给所有品牌。

本地 MCP 服务

对于只能启动本地服务的客户端，postatron-mcp 可通过 stdio 使用 API 密钥提供相同的工具。 Claude Desktop 的配置文件 claude_desktop_config.json：

{
  "mcpServers": {
    "postatron": {
      "command": "postatron-mcp",
      "env": { "POSTATRON_API_KEY": "ptn_your_key_here" }
    }
  }
}

详见 docs/mcp.md。

OpenAPI

REST API 使用 OpenAPI 3.1 描述，位于 api.postatron.com/v1/openapi.json，其中包含 Webhook；获取该文件无需密钥。 可用它生成任意语言的客户端，也可以直接交给 Agent；在 Go 中，同一文档为 apiv1.OpenAPI。

文档

• docs/api.md - REST API 参考、身份验证、速率限制和错误。
• apiv1/openapi.json - API 提供的 OpenAPI 3.1 描述。
• docs/mcp.md - MCP 工具和客户端设置。
• docs/cli.md - 所有命令和标志。

许可证

MIT。详见 LICENSE。