post bridge

Post Bridge エージェントモード

単一のコマンドで10のソーシャルメディアプラットフォームに投稿できる機能を、AI エージェントに追加します。

対応プラットフォーム： Instagram、TikTok、YouTube、X（Twitter）、LinkedIn、Facebook、Pinterest、Threads、Bluesky、Google Business

Post Bridge API を基盤としています。Post Bridge は、1,500人以上のクリエイターやチームが、1か所からあらゆる場所に投稿するために利用しているソーシャルメディアのスケジュール管理ツールです。

Agent Plugins 標準

このリポジトリは、Amazon、Cursor、Microsoft、OpenAI、Vercel が提供するオープンなパッケージング標準である、ポータブルな Agent Plugin（仕様 1.0.0）にも対応しています。ルートにある plugin.json + mcp.json + skills/ により、互換性のある任意のクライアント（Cursor、VS Code など。今後対応が進む予定）から、このパッケージを使って Post Bridge スキルを読み込み、ホストされた MCP サーバーに接続できます。Claude Code ではこれまでどおり .claude-plugin/ を使用します。両方の形式を併用できます。

スキルとは？

スキルは、特定のタスクに関する専門知識やワークフローを AI エージェントに提供する Markdown ファイルです。これをプロジェクトに追加すると、AI エージェントで10のプラットフォームにわたるソーシャルメディアコンテンツの作成、スケジュール設定、公開ができるようになります。

インストール

スキル（Claude Code、Cursor、Windsurf、Codex などのエージェントで利用できます）：

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

これにより、スキルがインストールされ、postbridge-cli CLI もエージェントから利用できるようになります。

このリポジトリには2つのスキルが含まれています。

--skill を指定すると、スキルを1つだけインストールできます。

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

ヒント： setup を実行する代わりに、API キーを環境変数として設定することもできます：export POST_BRIDGE_API_KEY=pb_live_xxxxx（永続化するには ~/.zshrc / ~/.bashrc に追加してください）。

使い始める

AI エージェントに、次のように依頼できます。

• 「すべてのソーシャルアカウントにこれを投稿して」
• 「明日の午前9時に Instagram と TikTok で投稿をスケジュールして」
• 「この動画をアップロードして、すべてのプラットフォームに投稿して」
• 「昨日の投稿のパフォーマンスはどうだった？」
• 「スケジュール済みの投稿を表示して」
• 「さっき作った下書きを削除して」

エージェントにできること

• 1つのコマンドで、接続済みの9つのプラットフォームの一部またはすべてに投稿できます
• 任意の日付と時刻に投稿を予約できます
• 画像や動画をアップロードできます（形式は自動変換されます）
• アナリティクスを確認できます — TikTok、YouTube、Instagramでの再生数、いいね数、コメント数、シェア数
• アカウントを管理できます — 接続状況の一覧表示、ステータスの確認
• プラットフォームごとの設定 — カスタムキャプション、TikTokの下書きモード、YouTubeのタイトル、Instagramのトライアルリール、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（リール、ストーリーズ、フィード）
• TikTok
• YouTube（ショート）
• X（旧Twitter）
• LinkedIn
• Facebook
• Pinterest
• Threads
• Bluesky

メディア要件

テキストのみの投稿を公開できず、画像または動画がないと失敗するプラットフォームがあります。

メディアなしで投稿を作成し、後からposts:updateで追加できます。ただし、メディアが追加されるまでは、メディアが必須のプラットフォームには公開されません。

トラブルシューティング

「API key not found」

セットアップコマンドを実行してください。

npx postbridge-cli setup --key pb_live_xxxxx

または、環境変数を手動で設定してください。

export POST_BRIDGE_API_KEY=pb_live_xxxxx

セッションをまたいで設定を保持するには、シェルのプロファイル（~/.bashrc、~/.zshrcなど）に追加してください。

「Node.js is required」

CLIは依存関係のないNode.jsスクリプトで、Node.js 18以降（組み込みのfetchを使用するため）が必要です。新しいバージョンのNode.jsをインストールしてから、もう一度お試しください。

APIエラー（401、403）

• APIキーが正しいことを確認してください
• post-bridge.com/dashboard/api-keysでAPIアクセスが有効になっていることを確認してください
• APIアドオン（5ドル／月）付きの有効なサブスクリプションがあることを確認してください

1つのプラットフォームで投稿に失敗した場合

各プラットフォームへの投稿は個別に処理されます。1つのプラットフォームで失敗しても、ほかのプラットフォームへの投稿は続行されます。npx postbridge-cli results --post-id <id>を使うと、プラットフォームごとのステータスとエラーの詳細を確認できます。

MCP サーバー

Post Bridgeはホスト型のMCP サーバーも提供しているため、MCP対応クライアント（Claude、ChatGPT、Cursor、その他のエージェント）から直接接続できます。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リール、YouTubeショートへ投稿するよう予約してください。」
• 「過去30日間で、最も再生数が多かった投稿はどれですか？」

セットアップガイドとツールのリファレンス全文：post-bridge.com/mcp/docs

リンク

• Post Bridge
• エージェントモードのランディングページ
• API ドキュメント
• MCP のセットアップ

ライセンス

MIT