{
"markdown": "# Post Bridge Agent Mode\n\n[](LICENSE)\n[]()\n[](https://www.npmjs.com/package/postbridge-cli)\n[](https://api.post-bridge.com/reference)\n\nGive your AI agent the ability to post to 9 social media platforms from a single command.\n\n**Supports:** Instagram, TikTok, YouTube, X (Twitter), LinkedIn, Facebook, Pinterest, Threads, Bluesky\n\nBuilt on the [Post Bridge API](https://api.post-bridge.com/reference). [Post Bridge](https://www.post-bridge.com) is a social media scheduling tool used by 1,500+ creators and teams to post everywhere from one place.\n\n## Agent Plugins standard\n\nThis repo is also a portable [Agent Plugin](https://agent-plugins.org) (spec 1.0.0), the open packaging standard from Amazon, Cursor, Microsoft, OpenAI, and Vercel. Root `plugin.json` + `mcp.json` + `skills/` mean any compatible client (Cursor, VS Code, and more as they adopt it) can load the post bridge skill and connect to the hosted MCP server from this one package. Claude Code keeps using `.claude-plugin/` as before; both formats live side by side.\n\n## What Are Skills?\n\nSkills 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.\n\n## Install\n\n### Skill (works with Claude Code, Cursor, Windsurf, Codex, and other agents):\n\n```bash\nnpx skills add post-bridge-hq/agent-mode\n```\n\nThis installs the skills **and** makes the `postbridge-cli` CLI available to your agent.\n\nTwo skills ship in this repo:\n\n| skill | what it does |\n|---|---|\n| `post-bridge` | Create, schedule and manage posts across 9 platforms via the Post Bridge API |\n| `b2c-organic-social-media-marketing` | Organic growth coach for B2C apps on TikTok and Instagram, the system behind 500M+ views and 130K+ downloads with no ad spend |\n\nInstall just one with `--skill`:\n\n```bash\nnpx skills add post-bridge-hq/agent-mode --skill b2c-organic-social-media-marketing\n```\n\n### CLI only (no skill, any terminal):\n\nThe CLI is published standalone on npm — no install required, `npx` fetches it on first use:\n\n```bash\nnpx postbridge-cli setup --key pb_live_xxxxx\nnpx postbridge-cli accounts\n```\n\nRequires Node.js 18+. Install globally with `npm i -g postbridge-cli` if you'd rather drop the `npx` prefix.\n\n\nOther installation methods
\n\n**Claude Code Plugin:**\n\nAdd the marketplace and install:\n\n```\n/plugin marketplace add post-bridge-hq/agent-mode\n/plugin install post-bridge@post-bridge\n```\n\nOr load locally for development:\n\n```bash\nclaude --plugin-dir ./agent-mode\n```\n\n**Cursor:**\n\n1. Open Settings (Cmd+Shift+J)\n2. Go to \"Rules & Command\" > \"Project Rules\"\n3. Click \"Add Rule\" > \"Remote Rule (GitHub)\"\n4. Enter: `https://github.com/post-bridge-hq/agent-mode.git`\n\n**Manual:**\n\nClone this repository and copy `skills/post-bridge/` to your project's `.cursor/skills/` or `.claude/skills/` directory.\n\n \n\n## Setup\n\n1. Sign up at [post-bridge.com](https://www.post-bridge.com) and connect your social accounts\n2. [Enable API access](https://www.post-bridge.com/dashboard/api-keys) (API Keys page in your dashboard) — $5/month add-on\n3. Run the setup command:\n\n```bash\nnpx postbridge-cli setup --key pb_live_xxxxx\n```\n\n> **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).\n\n### Start using it\n\nAsk your AI agent things like:\n\n- \"Post this to all my social accounts\"\n- \"Schedule a post for tomorrow at 9am on Instagram and TikTok\"\n- \"Upload this video and post it everywhere\"\n- \"How did yesterday's post perform?\"\n- \"Show my scheduled posts\"\n- \"Delete the draft I made earlier\"\n\n## What your agent can do\n\n- **Post** to any or all 9 connected platforms in one command\n- **Schedule** posts for any date/time\n- **Upload** images and videos (automatic format conversion)\n- **Check analytics** — views, likes, comments, shares across TikTok, YouTube, Instagram\n- **Manage accounts** — list connections, check status\n- **Per-platform overrides** — custom captions, TikTok draft mode, YouTube titles, Instagram trial reels, Pinterest boards, etc.\n\n## Quick start\n\n```bash\n# List your connected accounts\nnpx postbridge-cli accounts\n\n# Post to specific accounts\nnpx postbridge-cli post --caption \"Hello world!\" --accounts 1,2,3\n\n# Schedule a post (specific UTC time)\nnpx postbridge-cli post --caption \"Morning post\" --accounts 1,2 --schedule \"2026-06-20T14:00:00Z\"\n\n# Or auto-schedule to your next queue slot\nnpx postbridge-cli post --caption \"Morning post\" --accounts 1,2 --use-queue\n\n# Upload media and post with it\nnpx postbridge-cli upload --file ./video.mp4\nnpx postbridge-cli post --caption \"Check this out\" --accounts 1,2,3 --media mid_xxx\n\n# Check analytics\nnpx postbridge-cli analytics\n```\n\n## Supported Platforms\n\n- Instagram (Reels, Stories, Feed)\n- TikTok\n- YouTube (Shorts)\n- X (formerly Twitter)\n- LinkedIn\n- Facebook\n- Pinterest\n- Threads\n- Bluesky\n\n### Media requirements\n\nSome platforms can't publish a text-only post and will fail without an image or video:\n\n| Platform | Media | Accepts |\n|----------|-------|---------|\n| YouTube | Required | exactly 1 video |\n| TikTok | Required | 1 video, or one+ images (photo post) |\n| Instagram | Required | 1–10 images/videos; story = exactly 1; no PDFs |\n| Pinterest | Required | 1-5 images (2+ publishes as a carousel; all images must share one aspect ratio) or 1 video |\n| X (Twitter) | Optional | up to 4 images, or 1 video |\n| Facebook | Optional | 1 video, or one+ images |\n| LinkedIn | Optional | up to 20 images, or 1 video, or 1 PDF |\n| Threads | Optional | up to 20 images/videos |\n| Bluesky | Optional | up to 4 images, or 1 video |\n| Google Business | Optional | text or a single image; no video |\n\nYou can create a post without media and add it later with `posts:update` — but it won't publish to a media-required platform until the media exists.\n\n## Troubleshooting\n\n### \"API key not found\"\n\nRun the setup command:\n\n```bash\nnpx postbridge-cli setup --key pb_live_xxxxx\n```\n\nOr set the environment variable manually:\n\n```bash\nexport POST_BRIDGE_API_KEY=pb_live_xxxxx\n```\n\nTo persist across sessions, add it to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.).\n\n### \"Node.js is required\"\n\nThe 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.\n\n### API errors (401, 403)\n\n- Verify your API key is correct\n- Check that API access is enabled at [post-bridge.com/dashboard/api-keys](https://www.post-bridge.com/dashboard/api-keys)\n- Make sure you have an active subscription with the API add-on ($5/month)\n\n### Post failed on one platform\n\nEach platform posts independently. If one fails, the others still go through. Use `npx postbridge-cli results --post-id ` to see per-platform status and error details.\n\n## MCP Server\n\nPost Bridge also runs a hosted **MCP server**, so MCP-compatible clients (Claude, ChatGPT, Cursor, and other agents) can connect directly — no CLI, no install.\n\n- **Endpoint:** `https://www.post-bridge.com/api/mcp/mcp` (streamable HTTP)\n- **Auth:** OAuth 2.0 — connect and sign in, no API key needed. (Or pass a `pb_live_...` key as a Bearer token, see below.)\n\n### Connect\n\n**Claude or ChatGPT (one-click, OAuth):** add a custom connector / app using the endpoint URL above, sign in to Post Bridge, and authorize. Leave any OAuth client ID/secret blank — the server registers the client automatically.\n\n**Claude Desktop (via `mcp-remote`)** — add to `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"post-bridge\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://www.post-bridge.com/api/mcp/mcp\",\n \"--header\",\n \"Authorization: Bearer pb_live_your_api_key_here\"\n ]\n }\n }\n}\n```\n\n**Claude Code / other HTTP MCP clients** — add to `~/.claude/settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"post-bridge\": {\n \"type\": \"http\",\n \"url\": \"https://www.post-bridge.com/api/mcp/mcp\",\n \"headers\": { \"Authorization\": \"Bearer pb_live_your_api_key_here\" }\n }\n }\n}\n```\n\n### Tools (13)\n\n`list_social_accounts`, `create_post`, `update_post`, `get_post`, `list_posts`, `delete_post`, `list_post_results`, `upload_media`, `list_media`, `delete_media`, `list_analytics`, `get_analytics_daily`, `sync_analytics`\n\n### Try it\n\n- \"Which social accounts do I have connected?\"\n- \"Schedule this video to TikTok, Instagram Reels and YouTube Shorts for tomorrow at 9am.\"\n- \"Which of my posts got the most views in the last 30 days?\"\n\nFull setup guide and tool reference: [post-bridge.com/mcp/docs](https://www.post-bridge.com/mcp/docs)\n\n## Links\n\n- [Post Bridge](https://www.post-bridge.com)\n- [Agent Mode Landing Page](https://www.post-bridge.com/agents)\n- [API Documentation](https://api.post-bridge.com/reference)\n- [MCP Setup](https://www.post-bridge.com/mcp)\n\n## License\n\nMIT\n",
"bytes": 9256,
"sha": "a6ce519f56ab6feeca60f7805077238c7431cae858f294d4191b46b6564ea92d",
"repo_slug": "post-bridge-hq/agent-mode",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_jackfriks_post_bridge_301419b5/readme"
}