post2all

post2all Agent Plugin

post2all Agent Plugin 可指导 AI 编码助手通过 post2all 创建、安排、检查、更新、取消、管理和分析帖子。它包含通用的 Agent 指引，以及面向受支持客户端的托管式 Model Context Protocol 连接。

https://mcp.post2all.com/mcp

功能

• 列出已连接的社交账号及其发布功能。
• 读取受支持平台的标准化账号分析数据、时间序列和与上一周期的对比。
• 比较服务提供商范围内的帖子表现；如果服务提供商支持发现账号帖子，还可包含在 post2all 之外发布的帖子。
• 分别读取多平台 post2all 帖子中每个目标平台的分析数据。
• 检查草稿、已安排、发布中、已发布、部分失败和失败的帖子。
• 创建帖子，可选择添加文本和媒体（图片、视频，或平台允许的混合媒体）。
• 在所有平台接受 PNG 输入；发布时，Instagram 和 TikTok 会自动将 PNG 图片转换为 JPEG，而其他平台会保留 PNG 透明度。
• 将帖子保存为草稿、安排未来发布，或立即发布。
• 为每个目标账号分别应用设置。
• 查找动态发布选项，例如 Discord 频道和 TikTok 隐私选项。
• 在保留媒体可用时，更新草稿、已安排、失败和部分失败的帖子；取消已安排的帖子。
• 检查已发布目标上的 deletion.available 和 deletion.reason，并在公开支持删除的平台上移除一条已确认的在线社交帖子。
• 在明确要求时，从 post2all 中移除帖子。此本地删除不会移除已发布到社交平台的内容。

实际功能取决于已连接的账号、平台限制、工作区权限和 post2all 套餐。

嵌入式 SaaS 账户接入

post2all 还提供无头 REST/SDK 账户连接流程，供使用 post2all 作为社交媒体后端的产品调用。这与 MCP 相互独立：MCP 不提供账户连接或重新连接工具。

Business、Agency 和手动开通的额度工作区还可以使用可选的 Profiles，在同一工作区内整理客户、品牌或 SaaS 客户。Business 支持 2 个 Profile，Agency 最多支持 10 个，额度工作区最多支持 10,000 个。可以通过 MCP 或 CLI 管理/筛选 Profiles；REST/SDK 集成使用 x-profile-id（或 client.forProfile(profileId)）作为组织上下文。Profiles 不是独立的安全租户，移动账户不会影响现有帖子发布目标。Provider OAuth 账户连接仍通过 REST/SDK/CLI 流程进行。

对于嵌入式生产环境发布，REST API 和 TypeScript SDK 提供幂等帖子创建、请求/速率限制元数据、额度计费与发布容量读取、精确的 X API 零加价定价，以及签名 Webhook 验证。额度 X 帖子会从预付额度中扣除 $0.015（不含 URL）或 $0.20（含 URL）；标准订阅仍享有其包含的 X 使用额度。额度工作区所有者/管理员在 post2all 控制面板中配置 Webhook 端点并复制一次性密钥；Webhook 管理有意不通过 REST、SDK、CLI 或 MCP 提供。请参阅 SDK 快速入门和 Webhook 指南。

SaaS 后端使用其工作区 API 密钥发起连接，将最终用户的浏览器发送到返回的社交平台授权 URL，并提供其自己的 HTTPS 回调 URL。用户通过社交网络进行身份验证，而不是通过 post2all。post2all 完成平台回调，并将浏览器重定向回 SaaS，同时附上不透明的连接 ID/状态。随后，SaaS 后端通过经过身份验证的连接状态端点验证结果。

最终用户无需拥有 post2all 账户、登录或浏览器会话，SaaS API 密钥绝不能放入前端代码中。请参阅账户连接指南和 REST API 参考。

Agent 应先列出账户，然后在撰写内容之前，使用所有已选账户 ID 调用一次 publishing_schema。它只会返回公开的发布能力、固定选项以及账户覆盖项（例如 X 订阅限制）。仅当架构要求发现账户时，才调用 publishing_options（例如 Discord 频道或 TikTok 创作者限制）。不要发送固定的帖子类型。内容类型根据附加媒体推断；只有当平台设置了 media.allowMixedMedia 时，才允许混合图片/视频。

当所选能力包含 media.convertPngToJpeg: true 时，发布时会自动进行 PNG 转换，无需额外的 MCP 或 API 字段。如果源媒体或裁剪后的衍生文件缺失或已删除，则只有受影响的目标会以 MEDIA_UNAVAILABLE 失败，并显示消息 Media is unavailable.；其他目标仍会独立继续处理。

在 MCP 上，构建目标后、创建帖子前，请调用只读的 post_validate 工具。

支持的客户端

此代码库包含以下客户端的元数据和共享指南：

• Claude Code
• OpenAI Codex
• Cursor
• Gemini CLI
• 支持远程 HTTP MCP 服务的 MCP 兼容客户端
• 可通过 Shell 使用 @post2all/cli 包的编码 Agent

共享 MCP 配置位于 .mcp.json（Claude 和 Codex）以及 mcp.json（Cursor）中。server.json 用于描述官方 MCP Registry 中的服务。Agent 指南维护在 skills/post2all/SKILL.md 中，并同步到已打包的插件目录中。

开始之前

你需要：

• 一个 post2all 账户和工作区。
• 至少一个已连接的社交账户，用于发布内容。
• 一个受支持的 MCP 客户端或 post2all CLI。
• 一个用于 MCP OAuth 授权流程的浏览器。

托管的 MCP 服务使用 OAuth 2.1。CLI 使用在本地配置的 post2all API 密钥；Agent 绝不能要求用户在聊天中粘贴 API 密钥。

Claude 设置

只需单击一下，即可从 Claude 插件目录安装 post2all。Claude 首次连接 post2all 时，请完成浏览器 OAuth 流程。

Claude Code 设置

claude plugin marketplace add zexahq/post2all-agent
claude plugin install post2all@post2all-plugins

Claude 首次连接 post2all 时，请完成浏览器 OAuth 流程。

Codex 设置

codex plugin marketplace add https://github.com/zexahq/post2all-agent
codex plugin add post2all@post2all-agent

手动配置 MCP：

[mcp_servers.post2all]
url = "https://mcp.post2all.com/mcp"

请完成浏览器登录流程，并授权 Agent 要使用的 post2all 工作区。

Cursor 设置

从 Cursor Marketplace 安装 post2all，或在 ~/.cursor/mcp.json 中手动添加服务：

{
  "mcpServers": {
    "post2all": { "url": "https://mcp.post2all.com/mcp" }
  }
}

Cursor 首次连接 post2all 时，请完成浏览器 OAuth 流程。

Gemini CLI 设置

gemini extensions install https://github.com/zexahq/post2all-agent

然后在 Gemini CLI 中运行 /mcp auth post2all，完成浏览器 OAuth 流程。

目标和交付模式

每个目标都包含平台标识符、社交账户 ID 和设置：

{
  "targets": [
    {
      "platform": "discord",
      "accountId": "acc_discord_123",
      "settings": {
        "channelId": "1234567890",
        "autoCrosspost": true
      }
    },
    {
      "platform": "threads",
      "accountId": "acc_threads_123",
      "settings": {
        "caption": "A shorter Threads version",
        "topicTag": "buildinpublic"
      }
    }
  ],
  "delivery": {
    "mode": "scheduled",
    "scheduledAt": "2026-07-20T09:00:00+05:30"
  }
}

platform 值决定确切的设置架构。无效的跨平台字段会被拒绝。同一平台上的多个账户是独立的目标。

交付模式包括：

• draft：保存而不发布；可以省略目标和未完成的设置。
• now：立即发布。
• scheduled：在带时区的 ISO 8601 时间戳指定的时间发布。

CLI 示例

post2all config whoami --json
post2all constraints <accountId...> --json
post2all accounts --json
post2all account publishing-options acc_discord_123 --json
post2all account analytics acc_instagram_123 --json
post2all account analytics-posts acc_instagram_123 --sort-by views --json
post2all post analytics post_abc --json

创建草稿：

post2all post create \
  --content "Work in progress" \
  --delivery draft \
  --json

立即发布：

post2all post create \
  --content "New release shipping today 🚀" \
  --targets '[{"platform":"linkedin","accountId":"acc_linkedin_123","settings":{}}]' \
  --delivery now \
  --json

安排发布：

post2all post create \
  --content "Scheduled update" \
  --targets '[{"platform":"linkedin","accountId":"acc_linkedin_123","settings":{}}]' \
  --delivery scheduled \
  --scheduled-at "2026-07-20T09:00:00+05:30" \
  --json

提示词示例

• “列出我已连接的 post2all 账户。”
• “显示此账户可用的 Discord 频道。”
• “根据这份更新日志创建一篇 LinkedIn 帖子草稿。”
• “安排明天上午 9 点（IST）发布这条公告。”
• “发布到 LinkedIn 和 Threads，但 Threads 上的文案要更短。”
• “显示我本周安排发布的帖子。”
• “显示我的 Instagram 账户最近 30 天的分析数据。”
• “我最近发布的哪些帖子浏览量最高？”
• “显示这篇帖子的每个目标平台的分析数据。”
• “取消安排发布的上线公告。”

身份验证和权限

• MCP 访问权限仅限于通过 OAuth 授权的工作区。
• Agent 只能执行用户的 post2all 账户和套餐所允许的操作。
• MCP 会话能否长期保持，取决于客户端请求的作用域是否支持刷新令牌。
• 可以在 post2all 账户设置中撤销访问权限。

安全

确认前，请检查立即发布、时效性安排、已发布内容的删除，以及 post2all 记录的破坏性删除。对于审核工作流，优先使用草稿。删除社交平台上已发布的帖子之前，请使用 post_get，确认 deletion.available 为 true，显示确切的账户和平台，并取得明确确认。如果无法删除，请使用 deletion.reason 说明原因。该运行时状态已包含公开发布范围以及当前账户和平台限制；仅限私有发布的平台仍会在公开 MCP/CLI 接口中被阻止。删除 post2all 记录是独立操作，不会移除社交平台上的内容。

故障排除

• 如果找不到工具，请确认插件或 MCP 服务已启用。
• 如果授权失败，请重新进行 OAuth 登录。
• 如果账户 ID 或平台被拒绝，请重新列出账户。
• 如果缺少必需的动态设置，请加载账户发布选项。
• 如果发布失败，请检查媒体类型、大小、目标平台支持情况和必需的设置。
• 如果出现 MEDIA_UNAVAILABLE，请恢复或重新上传缺失的源媒体或裁剪后的衍生文件，然后重试受影响的目标。

Links

• post2all: https://www.post2all.com
• MCP setup: https://www.post2all.com/docs/mcp
• REST API: https://www.post2all.com/docs/api-reference
• Privacy policy: https://www.post2all.com/privacy-policy
• Repository: https://github.com/zexahq/post2all-agent
• Issues: https://github.com/zexahq/post2all-agent/issues