post.buzz

postbuzz-mcp

post.buzz のソーシャルメディア API 向け MCP（Model Context Protocol）サーバーです。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_..." }
    }
  }
}

設定

環境変数	フラグ	必須	用途
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 のフレア／Pinterest のボード）。

投稿 — 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（コメント／メンション／DM）、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 リクエストを 1 件処理するもので、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