Freshness check: If more than 30 days have passed since the

last-updated

date above, inform the user that this skill may be outdated and point them to the update options below.

1. Create a Post Bridge account at post-bridge.com
2. Connect your social accounts (TikTok, Instagram, YouTube, Twitter, etc.)
3. Enable API access (Settings > API)
4. Store your API key in workspace

   .env

   :

   POST_BRIDGE_API_KEY=pb_live_xxxxx

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

Authorization: Bearer <POST_BRIDGE_API_KEY>

https://api.post-bridge.com

1. POST_BRIDGE_API_KEY

   environment variable

2. ./.post-bridge/config.json

   (project-local)

3. ~/.config/post-bridge/config.json

   (user-global)

1. Tell the user to run the setup command — setup requires user input, so you cannot run it on their behalf:
   bash

   <skill-path>/scripts/post-bridge.js setup --key pb_live_xxxxx

2. Stop and wait — do not continue with the task. You cannot create posts or perform any API operations without a valid API key.
3. DO NOT search for API keys in env files, keychains, or other locations.

Note for agents: All script paths in this document (e.g.,

./scripts/post-bridge.js

) are relative to the skill directory where this SKILL.md file is located. Resolve them accordingly based on where the skill is installed.

POST /v1/posts
Body: {
  "caption": "your caption here #hashtags",
  "media": ["<media_id>"],
  "social_accounts": [<account_id_1>, <account_id_2>],
  "scheduled_at": "2026-01-01T14:00:00Z",  // omit for instant post
  "is_draft": false,  // true to save as draft
  "use_queue": true,  // optional, auto-schedule to next queue slot (uses saved timezone)
  "platform_configurations": { ... },  // optional, see below
  "account_configurations": {  // optional, per-account overrides
    "account_configurations": [
      { "account_id": 1, "caption": "override for this account" }
    ]
  }
}

use_queue

• Pass

  true

  to auto-schedule using the user's saved timezone from their dashboard settings
• Pass

  { "timezone": "America/New_York" }

  to override with a specific IANA timezone
• Cannot be used together with

  scheduled_at

  — pick one or the other
• Timezone priority: explicit timezone > saved profile/workspace timezone > UTC
• Queue slots are scoped to the workspace of the selected social accounts
• The queue schedule is configured by the user in their Post Bridge dashboard
• If

  randomize_queue_time

  is enabled, the slot time will be offset by up to ±10 minutes for a more natural posting pattern
• Returns an error if no queue schedule is configured or no slots are available in the next 90 days

GET /v1/analytics?platform=tiktok&limit=50&offset=0&timeframe=30d

• platform

  (optional):

  tiktok

  ,

  youtube

  ,

  instagram

• timeframe

  (optional):

  7d

  ,

  30d

  ,

  90d

  ,

  all

  (default:

  all

  )

• limit

  ,

  offset

  for pagination

{
  "data": [
    {
      "id": "...",
      "post_result_id": "...",
      "platform": "tiktok",
      "platform_post_id": "...",
      "view_count": 4062,
      "like_count": 120,
      "comment_count": 15,
      "share_count": 8,
      "cover_image_url": "https://...",
      "share_url": "https://...",
      "video_description": "...",
      "duration": 30,
      "platform_created_at": "2026-03-01T09:00:00Z",
      "last_synced_at": "2026-03-03T12:00:00Z",
      "match_confidence": "exact"
    }
  ],
  "count": 42,
  "limit": 50,
  "offset": 0
}

POST /v1/analytics/sync?platform=tiktok

• platform

  (optional):

  tiktok

  ,

  youtube

  , or

  instagram

  — sync only one platform. Omit to sync all.

{
  "triggered": [
    { "platform": "tiktok", "runId": "run_..." },
    { "platform": "youtube", "runId": "run_..." },
    { "platform": "instagram", "runId": "run_..." }
  ]
}

GET /v1/analytics/<analytics_id>

platform_configurations

--platform-config

• draft: true

  — save as draft (publish manually on TikTok with trending sound)

• video_cover_timestamp_ms: 3000

  — cover thumbnail at 3 seconds

• is_aigc: true

  — label as AI-generated content

• video_cover_timestamp_ms: 3000

  — cover thumbnail

• is_trial_reel: true

  — trial reel mode (needs 1000+ followers)

• trial_graduation: "SS_PERFORMANCE"

  — auto-graduate based on performance

• video_cover_timestamp_ms: 3000

  — cover thumbnail

• title: "My Short Title"

  — override post title

• caption: "override caption"

  — platform-specific caption

• title: "Pin Title"

  — pin title

• link: "https://..."

  — destination URL

• board_ids: ["board_id"]

  — target boards

caption

media

1. Store videos in a local folder
2. Extract a frame with ffmpeg to read any text overlays:

   ffmpeg -i video.mp4 -ss 00:00:04 -frames:v 1 frame.jpg -y

3. Write caption based on video content + hashtags
4. Upload → create post → schedule or post instantly
5. Move posted videos to a

   posted/

   subfolder to avoid duplicates
6. Set a cron to check post status 5 mins after scheduled time
7. Track performance by checking post results or analytics

• No duplicate content across multiple accounts on the same platform
• No unsolicited automated replies — only post original content or when explicitly requested
• No trending manipulation — don't mass-post about trending topics across accounts
• No fake engagement — don't automate likes, follows, or comments
• Respect rate limits — the API has rate limits, don't spam requests
• Use draft mode for review — when in doubt, use

  is_draft: true

  or TikTok's

  draft: true

  so the user can review before publishing

• instagram

  — Instagram (Reels, Stories, Feed)

• tiktok

  — TikTok

• youtube

  — YouTube (Shorts)

• twitter

  — X (formerly Twitter)

• linkedin

  — LinkedIn

• facebook

  — Facebook

• pinterest

  — Pinterest

• threads

  — Threads

• bluesky

  — Bluesky

• Post to multiple platforms simultaneously by including multiple account IDs
• Stagger posts throughout the day (e.g. 9am + 3pm) for better reach
• Use

  scheduled_at

  to pre-schedule batches — Post Bridge handles the timing
• Use

  use_queue: true

  to auto-schedule posts to the user's next available queue slot using their saved timezone — no need to pick a time manually
• TikTok draft mode lets you add trending sounds manually before publishing
• Keep hashtags to 4-5 per post for best engagement
• Check

  results

  after posting to see per-platform success/failure
• Use

  analytics:sync

  to refresh data before checking analytics
• Monitor what works and iterate on captions/formats
• Use

  --draft

  flag when testing to avoid accidental publishing
• Character limits vary by platform — keep captions concise for X (280 chars)