post bridge

Post Bridge Agent 模式

让你的 AI Agent 只需一条命令，就能向 10 个社交媒体平台发布内容。

支持： Instagram、TikTok、YouTube、X（Twitter）、LinkedIn、Facebook、Pinterest、Threads、Bluesky、Google Business

基于 Post Bridge API 构建。Post Bridge 是一款社交媒体排期工具，已有 1,500 多位创作者和团队使用，可在一个地方向各个平台发布内容。

Agent 插件标准

此代码库也是一个可移植的 Agent Plugin（规范 1.0.0），采用由 Amazon、Cursor、Microsoft、OpenAI 和 Vercel 推出的开放打包标准。根目录下的 plugin.json + mcp.json + skills/ 表示任何兼容的客户端（Cursor、VS Code 等，随着它们采用该标准）都可以从这个软件包加载 post bridge 技能，并连接到托管的 MCP 服务。Claude Code 仍像以前一样使用 .claude-plugin/；两种格式并存。

什么是技能？

技能是为 AI Agent 提供特定任务所需专业知识和工作流的 Markdown 文件。将其添加到你的项目后，AI Agent 就能够在 10 个平台上创建、排期和发布社交媒体内容。

安装

技能（适用于 Claude Code、Cursor、Windsurf、Codex 和其他 Agent）：

npx skills add post-bridge-hq/agent-mode

这会安装技能，并且让 Agent 可以使用 postbridge-cli CLI。

此代码库包含两项技能：

使用 --skill 只安装其中一项：

npx skills add post-bridge-hq/agent-mode --skill b2c-organic-social-media-marketing

仅安装 CLI（无技能，可在任何终端中使用）：

CLI 已独立发布到 npm，无需安装，首次使用时 npx 会自动获取：

npx postbridge-cli setup --key pb_live_xxxxx
npx postbridge-cli accounts

需要 Node.js 18+。如果你希望省去 npx 前缀，也可以通过 npm i -g postbridge-cli 全局安装。

/plugin marketplace add post-bridge-hq/agent-mode
/plugin install post-bridge@post-bridge

claude --plugin-dir ./agent-mode

设置

1. 在 post-bridge.com 注册并连接你的社交账号
2. 启用 API 访问权限（仪表板中的 API Keys 页面）——每月额外收费 5 美元
3. 运行设置命令：

npx postbridge-cli setup --key pb_live_xxxxx

提示： 你也可以将 API 密钥设为环境变量，而不运行 setup：export POST_BRIDGE_API_KEY=pb_live_xxxxx（将其添加到 ~/.zshrc / ~/.bashrc 以持久保存）。

开始使用

可以向 AI Agent 提出这样的要求：

• “将这条内容发布到我的所有社交账号”
• “明天上午 9 点在 Instagram 和 TikTok 上排期发布一条帖子”
• “上传这个视频并发布到所有平台”
• “昨天发布的帖子效果如何？”
• “显示我已排期的帖子”
• “删除我之前创建的草稿”

你的 Agent 可以做什么

• 发布到已连接的 9 个平台中的任意一个或全部平台，只需一条命令
• 安排在任意日期和时间发布帖子
• 上传图片和视频（自动转换格式）
• 查看分析数据 — TikTok、YouTube 和 Instagram 上的观看量、点赞数、评论数和分享数
• 管理账号 — 列出连接、检查状态
• 按平台自定义 — 自定义说明文字、TikTok 草稿模式、YouTube 标题、Instagram 试播 Reels、Pinterest 画板等

快速开始

# List your connected accounts
npx postbridge-cli accounts

# Post to specific accounts
npx postbridge-cli post --caption "Hello world!" --accounts 1,2,3

# Schedule a post (specific UTC time)
npx postbridge-cli post --caption "Morning post" --accounts 1,2 --schedule "2026-06-20T14:00:00Z"

# Or auto-schedule to your next queue slot
npx postbridge-cli post --caption "Morning post" --accounts 1,2 --use-queue

# Upload media and post with it
npx postbridge-cli upload --file ./video.mp4
npx postbridge-cli post --caption "Check this out" --accounts 1,2,3 --media mid_xxx

# Check analytics, then per-day numbers for one post
npx postbridge-cli analytics
npx postbridge-cli analytics:daily --id <analytics_id>

# File is on someone else's device? Mint a 24h drop page, then list media for the id
npx postbridge-cli upload-link

# Per-platform options, e.g. YouTube title + tags and a TikTok inbox draft
npx postbridge-cli post --caption "New video" --accounts 1,2 --media mid_xxx \
  --platform-config '{"youtube":{"title":"My video","tags":["cooking","easy recipes"]},"tiktok":{"draft":true}}'

# Every command and flag
npx postbridge-cli help

支持的平台

• Instagram（Reels、Stories、Feed）
• TikTok
• YouTube（Shorts）
• X（原 Twitter）
• LinkedIn
• Facebook
• Pinterest
• Threads
• Bluesky

媒体要求

部分平台无法发布纯文本帖子，没有图片或视频时会发布失败：

你可以创建不含媒体的帖子，之后再使用 posts:update 添加媒体 — 但在添加媒体之前，无法将其发布到要求媒体的平台。

故障排除

“未找到 API 密钥”

运行设置命令：

npx postbridge-cli setup --key pb_live_xxxxx

或手动设置环境变量：

export POST_BRIDGE_API_KEY=pb_live_xxxxx

要让设置在多个会话中持续生效，请将其添加到 shell 配置文件（~/.bashrc、~/.zshrc 等）中。

“需要 Node.js”

此 CLI 是零依赖的 Node.js 脚本，需要 Node.js 18+（以使用内置的 fetch）。安装较新版本的 Node.js，然后重试。

API 错误（401、403）

• 确认 API 密钥正确
• 检查是否已在 post-bridge.com/dashboard/api-keys 启用 API 访问权限
• 确认你有有效订阅，且已开通 API 附加服务（$5/月）

某个平台上的帖子发布失败

每个平台的发布操作相互独立。如果一个平台发布失败，其他平台仍会正常发布。使用 npx postbridge-cli results --post-id <id> 查看各平台的状态和错误详情。

MCP 服务

Post Bridge 也提供托管的 MCP 服务，因此兼容 MCP 的客户端（Claude、ChatGPT、Cursor 和其他 Agent）可以直接连接 — 无需 CLI，也无需安装。

• 端点： https://www.post-bridge.com/api/mcp/mcp（可流式传输的 HTTP）
• 身份验证： OAuth 2.0 — 连接并登录，无需 API 密钥。（或者将 pb_live_... 密钥作为 Bearer 令牌传递，见下文。）

连接

Claude 或 ChatGPT（单击连接，OAuth）： 使用上方的端点 URL 添加自定义连接器/应用，登录 Post Bridge 并授权。OAuth 客户端 ID/密钥留空 — 服务会自动注册客户端。

Claude Desktop（通过 mcp-remote） — 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "post-bridge": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.post-bridge.com/api/mcp/mcp",
        "--header",
        "Authorization: Bearer pb_live_your_api_key_here"
      ]
    }
  }
}

Claude Code / 其他 HTTP MCP 客户端 — 添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "post-bridge": {
      "type": "http",
      "url": "https://www.post-bridge.com/api/mcp/mcp",
      "headers": { "Authorization": "Bearer pb_live_your_api_key_here" }
    }
  }
}

工具（14 个）

list_social_accounts、create_post、update_post、get_post、list_posts、delete_post、list_post_results、upload_media、request_upload_link、list_media、delete_media、list_analytics、get_analytics_daily、sync_analytics

试用

• “我连接了哪些社交账号？”
• “将这个视频安排在明天上午 9 点发布到 TikTok、Instagram Reels 和 YouTube Shorts。”
• “过去 30 天里，我的哪些帖子获得了最多观看量？”

完整设置指南和工具参考：post-bridge.com/mcp/docs

链接

• Post Bridge
• Agent Mode 落地页
• API 文档
• MCP 设置

许可证

MIT