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

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

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

This installs the skill and makes the postbridge-cli CLI available to your agent.

CLI only (no skill, any terminal):

The CLI is published standalone on npm — no install required, npx fetches it on first use:

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

Requires Node.js 18+. Install globally with npm i -g postbridge-cli if you'd rather drop the npx prefix.

Claude Code Plugin:

Add the marketplace and install:

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

Or load locally for development:

claude --plugin-dir ./agent-mode

Cursor:

1. Open Settings (Cmd+Shift+J)
2. Go to "Rules & Command" > "Project Rules"
3. Click "Add Rule" > "Remote Rule (GitHub)"
4. Enter: https://github.com/post-bridge-hq/agent-mode.git

Manual:

Clone this repository and copy skills/post-bridge/ to your project's .cursor/skills/ or .claude/skills/ directory.

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:

npx postbridge-cli setup --key pb_live_xxxxx

Tip: You can also set the API key as an environment variable instead of running setup: export POST_BRIDGE_API_KEY=pb_live_xxxxx (add it to ~/.zshrc / ~/.bashrc to persist).

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
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
npx postbridge-cli 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:

npx postbridge-cli 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 npx postbridge-cli 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

• Post Bridge
• Agent Mode Landing Page
• API Documentation
• MCP Setup

License

MIT