post-bridge

Post Bridge Agent Mode

Give your AI agent the ability to post to 9 social media platforms from a single command.

Supports: Instagram, TikTok, YouTube, X (Twitter), LinkedIn, Facebook, Pinterest, Threads, Bluesky

Built on the Post Bridge API. Post Bridge is a social media scheduling tool used by 1,500+ creators and teams to post everywhere from one place.

What Are Skills?

Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. Add this to your project and your AI agent will be able to create, schedule, and publish social media content across 9 platforms.

Install

CLI (works with Claude Code, Cursor, Windsurf, Codex, and other agents):

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

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

claude --plugin-dir ./agent-mode

Setup

1. Sign up at post-bridge.com and connect your social accounts
2. Enable API access (Settings > API) — $5/month add-on
3. Run the setup command:

./scripts/post-bridge.js setup --key pb_live_xxxxx

Tip: The path depends on how you installed the skill, but you can ask your agent "Help me set up the Post Bridge skill" to get the correct path.

You can also set the API key as an environment variable instead: export POST_BRIDGE_API_KEY=pb_live_xxxxx

Start using it

Ask your AI agent things like:

• "Post this to all my social accounts"
• "Schedule a post for tomorrow at 9am on Instagram and TikTok"
• "Upload this video and post it everywhere"
• "How did yesterday's post perform?"
• "Show my scheduled posts"
• "Delete the draft I made earlier"

What your agent can do

• Post to any or all 9 connected platforms in one command
• Schedule posts for any date/time
• Upload images and videos (automatic format conversion)
• Check analytics — views, likes, comments, shares across TikTok, YouTube, Instagram
• Manage accounts — list connections, check status
• Per-platform overrides — custom captions, TikTok draft mode, YouTube titles, Instagram trial reels, Pinterest boards, etc.

Quick start

# List your connected accounts
./scripts/post-bridge.js accounts

# Post to specific accounts
./scripts/post-bridge.js post --caption "Hello world!" --accounts 1,2,3

# Schedule a post
./scripts/post-bridge.js post --caption "Morning post" --accounts 1,2 --schedule "2026-03-05T14:00:00Z"

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

# Check analytics
./scripts/post-bridge.js analytics

Supported Platforms

• Instagram (Reels, Stories, Feed)
• TikTok
• YouTube (Shorts)
• X (formerly Twitter)
• LinkedIn
• Facebook
• Pinterest
• Threads
• Bluesky

Troubleshooting

"API key not found"

Run the setup command:

./scripts/post-bridge.js setup --key pb_live_xxxxx

Or set the environment variable manually:

export POST_BRIDGE_API_KEY=pb_live_xxxxx

To persist across sessions, add it to your shell profile (~/.bashrc, ~/.zshrc, etc.).

"Node.js is required"

The CLI is a zero-dependency Node.js script and requires Node.js 18+ (for built-in fetch). Install a recent Node.js version, then retry.

API errors (401, 403)

• Verify your API key is correct
• Check that API access is enabled at post-bridge.com/dashboard/api-keys
• Make sure you have an active subscription with the API add-on ($5/month)

Post failed on one platform

Each platform posts independently. If one fails, the others still go through. Use ./scripts/post-bridge.js results --post-id <id> to see per-platform status and error details.

Alternative: MCP

For deeper integration with Claude Desktop, ChatGPT, or other MCP-compatible clients, use the Post Bridge MCP server — it connects in one click with no setup:

post-bridge.com/mcp

Links