post.buzz

postbuzz-mcp

适用于 post.buzz 社交媒体 API 的 MCP（模型上下文协议）服务——可通过 Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端，在 16 个以上的平台发布、安排发布并分析内容。

这是对官方 postbuzz SDK 的轻量级、与传输方式无关的封装，与 postbuzz-cli 保持一致。需要 Node.js 20+。

设置

在 post.buzz → Settings → API Keys 中创建 API 密钥（sx_live_…），然后配置客户端：

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "postbuzz": {
      "command": "npx",
      "args": ["-y", "postbuzz-mcp"],
      "env": { "POSTBUZZ_API_KEY": "sx_live_..." }
    }
  }
}

Claude Code

claude mcp add postbuzz -e POSTBUZZ_API_KEY=sx_live_... -- npx -y postbuzz-mcp

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "postbuzz": {
      "command": "npx",
      "args": ["-y", "postbuzz-mcp"],
      "env": { "POSTBUZZ_API_KEY": "sx_live_..." }
    }
  }
}

配置

Env var	Flag	Required	Purpose
POSTBUZZ_API_KEY	--api-key	是	API 密钥
POSTBUZZ_API_URL	--api-url	否	API 基础 URL（默认 https://post.buzz/api）

可通过 MCP Inspector 进行交互式测试：

npx @modelcontextprotocol/inspector node dist/index.js

工具（51 个）

诊断 — check_setup（先运行此工具）、describe_platform（各平台字段架构；调用 create_post 前请先调用）。

组织 — get_organization、get_usage。

账号 — list_accounts、get_account、connect_account（OAuth URL）、disconnect_account、refresh_account、list_account_tools、run_account_tool（Reddit flair / Pinterest board）。

帖子 — create_post、schedule_post、list_posts、get_post、update_post、delete_post、retry_post、reschedule_post。

评论 — create_comment（立即发布或安排发布；parentCommentId 可串联回复）、list_comments、get_comment、update_comment、delete_comment、retry_comment。

收件箱 — list_inbox（评论 / 提及 / 私信）、reply_to_inbox_item、edit_inbox_reply。

媒体 — upload_media（公共 URL 或本地图片 / 视频 / PDF 路径——拒绝其他文件类型）、list_media、get_media、delete_media、delete_media_many。

分析 — get_post_analytics、get_account_analytics、get_bulk_post_analytics（≤ 60 条帖子）、refresh_analytics、get_analytics_summary、get_best_times。

团队 — list_teams、get_team、create_team、update_team、delete_team、add_team_account、remove_team_account。

CSV 导入 — create_post_csv_import、list_post_csv_imports、get_post_csv_import、get_post_csv_import_rows、retry_post_csv_import。

剪辑 — create_clip（长视频 → 短片段，异步、幂等）、list_clips、get_clip、get_clip_usage。

每个工具都带有 MCP 注解：get_* / list_* / describe_* 为 readOnlyHint，delete_* / disconnect_* / remove_* 为 destructiveHint，因此客户端可以自动批准读取操作，并在删除前请求确认。

目标账号和各平台字段

帖子通过 ID 指定目标账号（list_accounts）；各平台必填字段（如 Reddit sr 风格的查找项、Pinterest 看板、TikTok 隐私设置、YouTube madeForKids……）可通过 describe_platform + run_account_tool 查明，并通过 accountOverrides[{ accountId, fields }] 传入。

错误

工具失败时会以文本内容返回 { "error": { "code", "message", "details"? } }，并设置 isError: true——与 REST API 和 CLI 返回的封装格式相同。

托管端点

post.buzz 也通过 https://post.buzz/api/mcp 提供这些工具 （Streamable HTTP），因此无需本地安装：

claude mcp add --transport http postbuzz https://post.buzz/api/mcp \
  --header "Authorization: Bearer sx_live_…"

托管服务无法访问你的文件：upload_media 仅接受 URL。

嵌入

postbuzz-mcp/server 导出 createServer(options) 和 handleMcpRequest(request, options)——后者使用 Web 标准的 Request / Response 处理单个无状态 Streamable HTTP 请求，可用于在 Workers、Deno、Bun 或任何 fetch 风格的服务上托管 这些工具。

开发

bun install
bun run build       # tsup → dist/index.js
bun run test        # vitest: MCP client over in-memory transport (manifest + flows)
node test/live-stdio.mjs   # live integration over real stdio (needs POSTBUZZ_API_KEY)

createServer({ apiKey, apiUrl? })（从 dist/index.js 导出）会构建与传输方式无关的 McpServer。

许可证

MIT