### Install via Claude Code Plugin

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/README.md

Commands for installing the plugin via the marketplace or local directory.

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

```bash
claude --plugin-dir ./agent-mode
```

--------------------------------

### Configure API Key via CLI

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Run the setup command to configure the API key for the Post Bridge CLI.

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

--------------------------------

### Setup and Configuration

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Configure the API key to authenticate with the Post Bridge API. The CLI supports global and local configuration, with environment variables taking highest priority.

```APIDOC
## Setup and Configuration

Configure the API key to authenticate with the Post Bridge API. The CLI supports global and local configuration, with environment variables taking highest priority.

### CLI Commands

```bash
# Configure API key globally (recommended)
./scripts/post-bridge.js setup --key pb_live_xxxxx

# Configure API key locally (project-specific)
./scripts/post-bridge.js setup --key pb_live_xxxxx --local

# Or use environment variable
export POST_BRIDGE_API_KEY=pb_live_xxxxx
```

### CLI Output Example

```json
{
  "status": "configured",
  "location": "global"
}
```
```

--------------------------------

### Install Post Bridge CLI

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/README.md

Use this command to add the Post Bridge skill to your AI agent environment.

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

--------------------------------

### GET /v1/media

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Lists uploaded media files.

```APIDOC
## GET /v1/media

### Description
Retrieves a list of previously uploaded media files.

### Method
GET

### Endpoint
/v1/media

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Number of items to return
- **offset** (integer) - Optional - Number of items to skip
```

--------------------------------

### Recommended Workflow for Video Content

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

A step-by-step guide for automating video content posting, including local storage, frame extraction, caption writing, posting, and status tracking.

```APIDOC
## Recommended Workflow for Video Content

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
```

--------------------------------

### Get Post Details

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Fetch full metadata for a specific post by its ID.

```bash
./scripts/post-bridge.js posts:get --id post_abc123
```

```bash
curl -X GET "https://api.post-bridge.com/v1/posts/post_abc123" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### GET /v1/analytics

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieves performance analytics for posts.

```APIDOC
## GET /v1/analytics

### Description
Returns engagement metrics like views, likes, and comments.

### Method
GET

### Endpoint
/v1/analytics

### Query Parameters
- **platform** (string) - Optional - tiktok, youtube, or instagram
- **timeframe** (string) - Optional - 7d, 30d, 90d, or all
- **limit** (integer) - Optional
- **offset** (integer) - Optional
```

--------------------------------

### GET /v1/media

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

View all uploaded media files with their IDs and metadata.

```APIDOC
## GET /v1/media

### Description
View all uploaded media files with their IDs and metadata.

### Method
GET

### Endpoint
/v1/media

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Number of items to return.
- **offset** (integer) - Optional - Number of items to skip.

### Response
#### Success Response (200)
- **data** (array) - List of media objects.

#### Response Example
{
  "data": [
    {
      "id": "mid_xyz789",
      "name": "video.mp4",
      "mime_type": "video/mp4",
      "size_bytes": 5242880,
      "created_at": "2026-03-01T10:00:00Z"
    }
  ]
}
```

--------------------------------

### GET /v1/analytics

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Retrieve engagement metrics for posts.

```APIDOC
## GET /v1/analytics

### Description
Retrieve engagement metrics (views, likes, comments, shares) for posts across TikTok, YouTube, and Instagram.

### Method
GET

### Endpoint
https://api.post-bridge.com/v1/analytics

### Query Parameters
- **platform** (string) - Optional - Filter by platform.
- **timeframe** (string) - Optional - Time range for analytics (e.g., 30d).
- **limit** (integer) - Optional - Number of results to return.
```

--------------------------------

### GET /v1/posts

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieves a list of posts based on filters.

```APIDOC
## GET /v1/posts

### Description
Lists posts with optional filtering by status and platform.

### Method
GET

### Endpoint
/v1/posts

### Query Parameters
- **limit** (integer) - Optional - Number of records to return
- **offset** (integer) - Optional - Pagination offset
- **status** (string) - Optional - Filter by scheduled, published, failed, or draft
- **platform** (string) - Optional - Filter by platform name
```

--------------------------------

### GET /v1/post-results

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieves execution results for a specific post.

```APIDOC
## GET /v1/post-results

### Description
Returns per-platform success or failure details for a post.

### Method
GET

### Endpoint
/v1/post-results

### Query Parameters
- **post_id** (string) - Required
- **limit** (integer) - Optional
- **offset** (integer) - Optional
```

--------------------------------

### GET /v1/post-results

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Check the status of a post across different platforms.

```APIDOC
## GET /v1/post-results

### Description
View per-platform posting results to see which platforms succeeded or failed.

### Method
GET

### Endpoint
https://api.post-bridge.com/v1/post-results

### Query Parameters
- **post_id** (string) - Required - The ID of the post to check.
```

--------------------------------

### GET /v1/posts/{id}

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Retrieve full details of a specific post.

```APIDOC
## GET /v1/posts/{id}

### Description
Retrieve full details of a specific post including its current status.

### Method
GET

### Endpoint
https://api.post-bridge.com/v1/posts/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the post.
```

--------------------------------

### GET /v1/posts/<post_id>

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieves detailed information for a specific post.

```APIDOC
## GET /v1/posts/<post_id>

### Description
Returns full post details including current processing status.

### Method
GET

### Endpoint
/v1/posts/<post_id>

### Path Parameters
- **post_id** (string) - Required - The unique identifier of the post
```

--------------------------------

### GET /v1/social-accounts

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieves a list of all connected social media accounts.

```APIDOC
## GET /v1/social-accounts

### Description
Returns an array of connected social accounts including their unique IDs, platform names, and usernames.

### Method
GET

### Endpoint
/v1/social-accounts

### Response
#### Success Response (200)
- **accounts** (array) - List of connected social accounts containing id, platform, and username.
```

--------------------------------

### Analytics Data Structure

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Example structure of the analytics data returned, including counts for views, likes, comments, and shares, along with platform-specific details.

```json
{
  "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
}
```

--------------------------------

### Get a Specific Post

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Fetch detailed information for a single post using its unique ID. The response includes the post's current status.

```http
GET /v1/posts/<post_id>
```

--------------------------------

### Get Single Analytics Record

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieve a single analytics record using its unique ID.

```http
GET /v1/analytics/<analytics_id>
```

--------------------------------

### Get Post Results

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieve the results for a specific post, indicating success or failure on each platform it was posted to, along with error details if applicable. Supports pagination.

```http
GET /v1/post-results?post_id=<post_id>&limit=50&offset=0
```

--------------------------------

### Create Posts with Platform Configurations

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use the CLI to post content with specific platform overrides or the API for multi-platform batch posting.

```bash
./scripts/post-bridge.js post --caption "Trending content" --accounts 2 \
  --platform-config '{"tiktok": {"draft": true, "video_cover_timestamp_ms": 3000}}'
```

```bash
./scripts/post-bridge.js post --caption "Trial reel test" --accounts 1 \
  --platform-config '{"instagram": {"is_trial_reel": true, "trial_graduation": "SS_PERFORMANCE"}}'
```

```bash
./scripts/post-bridge.js post --caption "Description here" --accounts 3 \
  --platform-config '{"youtube": {"title": "My Custom Short Title", "video_cover_timestamp_ms": 2000}}'
```

```bash
./scripts/post-bridge.js post --caption "Check out my blog" --accounts 5 \
  --platform-config '{"pinterest": {"title": "Pin Title", "link": "https://myblog.com", "board_ids": ["board_123"]}}'
```

```bash
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Multi-platform post",
    "media": ["mid_xyz789"],
    "social_accounts": [1, 2, 3],
    "platform_configurations": {
      "tiktok": {"draft": true, "is_aigc": true},
      "instagram": {"video_cover_timestamp_ms": 3000},
      "youtube": {"title": "My YouTube Short"}
    }
  }'
```

--------------------------------

### Post with Multiple Media Attachments

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create a post that includes multiple uploaded media files. List all relevant media_ids when creating the post.

```bash
# Post with multiple media files
./scripts/post-bridge.js post --caption "Photo dump 📸" --accounts 1,2 --media mid_abc,mid_def,mid_ghi
```

--------------------------------

### List Uploaded Media via CLI

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this CLI command to view all uploaded media files with their IDs and metadata.

```bash
./scripts/post-bridge.js media
```

--------------------------------

### Create and Publish a Post Immediately

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Publish a post to multiple social media accounts simultaneously. Ensure the account IDs are correctly specified.

```bash
# Post to multiple accounts immediately
./scripts/post-bridge.js post --caption "Hello world! #socialmedia" --accounts 1,2,3
```

--------------------------------

### Configure API Key Globally

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Set up your API key globally for authentication with the Post Bridge API. This is the recommended method for persistent configuration.

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

```bash
# Or use environment variable
export POST_BRIDGE_API_KEY=pb_live_xxxxx
```

```json
{
  "status": "configured",
  "location": "global"
}
```

--------------------------------

### Upload Media via API

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Create an upload URL and then perform a PUT request to upload the binary file.

```http
POST /v1/media/create-upload-url
Body: { "mime_type": "video/mp4", "size_bytes": <int>, "name": "video.mp4" }
```

```http
PUT <upload_url>
Content-Type: video/mp4
Body: <binary file>
```

--------------------------------

### Create a New Post

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Use this endpoint to create a new post. You can schedule it for a future date/time, save it as a draft, or use the queue scheduling feature. Optional parameters allow for platform-specific configurations and account overrides.

```json
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" }
    ]
  }
}
```

--------------------------------

### Configure API Key Locally

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Configure your API key on a per-project basis using the --local flag. This is useful for managing different API keys for different projects.

```bash
./scripts/post-bridge.js setup --key pb_live_xxxxx --local
```

--------------------------------

### Configure API Key via Environment Variable

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Store the API key in the workspace .env file to authorize requests.

```text
POST_BRIDGE_API_KEY=pb_live_xxxxx
```

--------------------------------

### Configure Post Bridge API Key

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/README.md

Set up the API key required for authentication using the CLI script or environment variables.

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

```bash
export POST_BRIDGE_API_KEY=pb_live_xxxxx
```

--------------------------------

### Post with Single Media Attachment

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create a post that includes a single uploaded media file. Reference the media_id obtained from the upload process.

```bash
# Upload media first, then create post
./scripts/post-bridge.js upload --file ./video.mp4
# Output: { "media_id": "mid_xyz789" }

./scripts/post-bridge.js post --caption "Check this out! 🎬" --accounts 1,2,3 --media mid_xyz789
```

--------------------------------

### Upload Media File via CLI

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Upload media files such as images and videos using the CLI. Supported formats include JPEG, PNG, GIF, WebP, MP4, MOV, AVI, and WebM.

```bash
# Upload a video file
./scripts/post-bridge.js upload --file ./video.mp4
```

```bash
# Upload an image
./scripts/post-bridge.js upload --file ./image.jpg
```

--------------------------------

### Manage Social Media via CLI

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/README.md

Common CLI commands for listing accounts, posting content, scheduling, and retrieving analytics.

```bash
# 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
```

--------------------------------

### Sync All Platforms Analytics

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this CLI command to trigger a background refresh of analytics data from all connected platforms.

```bash
./scripts/post-bridge.js analytics:sync
```

--------------------------------

### Platform-Specific Configurations

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Apply platform-specific settings like TikTok draft mode, Instagram trial reels, YouTube titles, and Pinterest boards.

```APIDOC
## Platform-Specific Configurations

Apply platform-specific settings like TikTok draft mode, Instagram trial reels, YouTube titles, and Pinterest boards.

### Example Usage (Conceptual)

```bash
# Example for TikTok draft mode
./scripts/post-bridge.js post --caption "My TikTok draft" --accounts 2 --platform-config '{"tiktok": {"is_draft": true}}'

# Example for YouTube title
./scripts/post-bridge.js post --caption "My YouTube video" --accounts 3 --platform-config '{"youtube": {"title": "Awesome Video Title"}}'

# Example for Pinterest board
./scripts/post-bridge.js post --caption "My Pinterest Pin" --accounts 5 --platform-config '{"pinterest": {"board_id": "board_123"}}'
```

### Request Body Example (for cURL)

```json
{
  "caption": "Post with platform specific settings",
  "social_accounts": [1],
  "platform_config": {
    "tiktok": {
      "is_draft": true
    },
    "youtube": {
      "title": "My Video Title"
    },
    "pinterest": {
      "board_id": "board_xyz"
    }
  }
}
```
```

--------------------------------

### Schedule a Post for Later

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Schedule a post to be published at a specific future date and time. The time should be in ISO 8601 format.

```bash
# Schedule a post for a specific time
./scripts/post-bridge.js post --caption "Morning post ☀️" --accounts 1,2 --schedule "2026-03-05T14:00:00Z"
```

--------------------------------

### POST /v1/posts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create a new post, optionally using the queue-based scheduling feature.

```APIDOC
## POST /v1/posts

### Description
Create a new post, optionally using the queue-based scheduling feature to auto-schedule to the next available slot.

### Method
POST

### Endpoint
/v1/posts

### Parameters
#### Request Body
- **caption** (string) - Required - The post content.
- **social_accounts** (array) - Required - List of account IDs.
- **media** (array) - Optional - List of media IDs.
- **use_queue** (boolean/object) - Optional - Enable queue scheduling or provide timezone override.
```

--------------------------------

### Create a Draft Post

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Save a post as a draft without publishing it immediately. This allows for review before final posting.

```bash
# Create a draft post
./scripts/post-bridge.js post --caption "Review this before posting" --accounts 1,2,3 --draft
```

--------------------------------

### POST /v1/media/create-upload-url

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Initiates the media upload process by generating a secure upload URL.

```APIDOC
## POST /v1/media/create-upload-url

### Description
Requests a secure URL to upload media files. After receiving the URL, perform a PUT request to that URL with the binary file.

### Method
POST

### Endpoint
/v1/media/create-upload-url

### Request Body
- **mime_type** (string) - Required - The MIME type of the file (e.g., video/mp4)
- **size_bytes** (integer) - Required - The size of the file in bytes
- **name** (string) - Required - The name of the file

### Response
#### Success Response (200)
- **media_id** (string) - The unique identifier for the uploaded media
- **upload_url** (string) - The URL to perform the PUT request for the binary file
```

--------------------------------

### Platform Configurations

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Details on platform-specific configurations that can be applied when creating posts, including options for TikTok, Instagram, YouTube, Twitter/X, and Pinterest.

```APIDOC
## Platform Configurations

Pass inside `platform_configurations` object on post creation, or use `--platform-config` with the CLI:

**TikTok:**
- `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

**Instagram:**
- `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

**YouTube:**
- `video_cover_timestamp_ms: 3000` — cover thumbnail
- `title: "My Short Title"` — override post title

**Twitter/X:**
- `caption: "override caption"` — platform-specific caption

**Pinterest:**
- `title: "Pin Title"` — pin title
- `link: "https://..."` — destination URL
- `board_ids: ["board_id"]` — target boards

All platforms support `caption` and `media` overrides for per-platform customization.
```

--------------------------------

### Post with Media Attachments

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create posts with uploaded media by referencing the media_id from the upload step.

```APIDOC
## Post with Media Attachments

Create posts with uploaded media by referencing the media_id from the upload step.

### CLI Commands

```bash
# Upload media first, then create post
./scripts/post-bridge.js upload --file ./video.mp4
# Output: { "media_id": "mid_xyz789" }

./scripts/post-bridge.js post --caption "Check this out! 🎬" --accounts 1,2,3 --media mid_xyz789

# Post with multiple media files
./scripts/post-bridge.js post --caption "Photo dump 📸" --accounts 1,2 --media mid_abc,mid_def,mid_ghi
```

### cURL Equivalent

```bash
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Check this out! 🎬",
    "media": ["mid_xyz789"],
    "social_accounts": [1, 2, 3]
  }'
```
```

--------------------------------

### View Analytics

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Retrieve engagement metrics for posts across supported platforms.

```bash
./scripts/post-bridge.js analytics
```

```bash
curl -X GET "https://api.post-bridge.com/v1/analytics?platform=tiktok&timeframe=30d&limit=50" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### MCP Integration Configuration

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Configuration details for connecting MCP-compatible clients like Claude Desktop, ChatGPT, and Cursor to Post Bridge's native MCP server.

```APIDOC
## MCP Integration

Post Bridge has a native MCP (Model Context Protocol) server. If you're using Claude Desktop, ChatGPT, Cursor, or any MCP-compatible client, you can connect directly without this skill.

**Claude Desktop**: One-click connect at [post-bridge.com/mcp](https://post-bridge.com/mcp)

**Claude Code / Cursor / Other MCP clients** — add to your MCP config:
```json
{
  "mcpServers": {
    "post-bridge": {
      "type": "streamable-http",
      "url": "https://mcp.post-bridge.com/mcp"
    }
  }
}
```
```

--------------------------------

### List Uploaded Media via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this curl command to retrieve a list of uploaded media files with pagination support.

```bash
curl -X GET "https://api.post-bridge.com/v1/media?limit=50&offset=0" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### Handle API Key Errors

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Use this command when the CLI reports an API key not found error.

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

--------------------------------

### Queue-Based Scheduling via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this curl command to schedule a post to the user's next available queue slot without manually specifying a time. Requires 'use_queue': true.

```bash
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Queued post",
    "social_accounts": [1, 2],
    "media": ["mid_xyz789"],
    "use_queue": true
  }'
```

--------------------------------

### Post with Media Attachments via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create a post with media attachments using the Post Bridge API. The 'media' field should be an array of media_ids.

```bash
# curl equivalent
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Check this out! 🎬",
    "media": ["mid_xyz789"],
    "social_accounts": [1, 2, 3]
  }'
```

--------------------------------

### Create a Post via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use the Post Bridge API to create and schedule posts. This method requires specifying the caption, social account IDs, and scheduling information.

```bash
# curl equivalent for creating a post
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Hello world! #socialmedia",
    "social_accounts": [1, 2, 3],
    "scheduled_at": "2026-03-05T14:00:00Z",
    "is_draft": false
  }'
```

```json
{
  "id": "post_abc123",
  "caption": "Hello world! #socialmedia",
  "status": "scheduled",
  "scheduled_at": "2026-03-05T14:00:00Z",
  "social_accounts": [1, 2, 3]
}
```

--------------------------------

### Manage Media Files

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

List or delete uploaded media files using the API.

```http
GET /v1/media?limit=50&offset=0
```

```http
DELETE /v1/media/<media_id>
```

--------------------------------

### Create and Publish a Post

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create a post to one or multiple social media platforms. Posts can be published immediately, scheduled for later, or saved as drafts.

```APIDOC
## Create and Publish a Post

Create a post to one or multiple social media platforms. Posts can be published immediately, scheduled for later, or saved as drafts.

### CLI Commands

```bash
# Post to multiple accounts immediately
./scripts/post-bridge.js post --caption "Hello world! #socialmedia" --accounts 1,2,3

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

# Create a draft post
./scripts/post-bridge.js post --caption "Review this before posting" --accounts 1,2,3 --draft
```

### cURL Equivalent

```bash
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Hello world! #socialmedia",
    "social_accounts": [1, 2, 3],
    "scheduled_at": "2026-03-05T14:00:00Z",
    "is_draft": false
  }'
```

### Response Example

```json
{
  "id": "post_abc123",
  "caption": "Hello world! #socialmedia",
  "status": "scheduled",
  "scheduled_at": "2026-03-05T14:00:00Z",
  "social_accounts": [1, 2, 3]
}
```
```

--------------------------------

### Upload Media File via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Upload media files using the Post Bridge API. This is a two-step process involving obtaining an upload URL and then uploading the binary file.

```bash
# curl equivalent (two-step process)
# Step 1: Get upload URL
curl -X POST "https://api.post-bridge.com/v1/media/create-upload-url" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"mime_type": "video/mp4", "size_bytes": 5242880, "name": "video.mp4"}'
```

```json
{"media_id": "mid_xyz789", "upload_url": "https://..."}
```

```bash
# Step 2: Upload binary file to the returned URL
curl -X PUT "https://upload-url-from-step-1" \
  -H "Content-Type: video/mp4" \
  --data-binary @./video.mp4
```

```json
# CLI Output:
{
  "media_id": "mid_xyz789"
}
```

--------------------------------

### Check Post Results

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Verify the success or failure status of a post across different platforms.

```bash
./scripts/post-bridge.js results --post-id post_abc123
```

```bash
curl -X GET "https://api.post-bridge.com/v1/post-results?post_id=post_abc123" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### POST /v1/analytics/sync

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Triggers a background sync of analytics data.

```APIDOC
## POST /v1/analytics/sync

### Description
Refreshes analytics data from connected social platforms.

### Method
POST

### Endpoint
/v1/analytics/sync

### Query Parameters
- **platform** (string) - Optional - Sync specific platform or all if omitted
```

--------------------------------

### POST /v1/posts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Create a new post across multiple social media platforms with specific configurations.

```APIDOC
## POST /v1/posts

### Description
Create a new post and distribute it to selected social accounts with platform-specific settings.

### Method
POST

### Endpoint
https://api.post-bridge.com/v1/posts

### Request Body
- **caption** (string) - Required - The text content of the post.
- **media** (array) - Required - List of media IDs to include.
- **social_accounts** (array) - Required - List of social account IDs.
- **platform_configurations** (object) - Optional - Platform-specific settings (e.g., tiktok, instagram, youtube).

### Request Example
{
  "caption": "Multi-platform post",
  "media": ["mid_xyz789"],
  "social_accounts": [1, 2, 3],
  "platform_configurations": {
    "tiktok": {"draft": true, "is_aigc": true},
    "instagram": {"video_cover_timestamp_ms": 3000},
    "youtube": {"title": "My YouTube Short"}
  }
}
```

--------------------------------

### POST /v1/analytics/sync

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Trigger a background refresh of analytics data from connected platforms.

```APIDOC
## POST /v1/analytics/sync

### Description
Trigger a background refresh of analytics data from connected platforms.

### Method
POST

### Endpoint
/v1/analytics/sync

### Parameters
#### Query Parameters
- **platform** (string) - Optional - The specific platform to sync (e.g., tiktok).

### Response
#### Success Response (200)
- **triggered** (array) - List of triggered sync operations.

#### Response Example
{
  "triggered": [
    { "platform": "tiktok", "runId": "run_abc123" },
    { "platform": "youtube", "runId": "run_def456" },
    { "platform": "instagram", "runId": "run_ghi789" }
  ]
}
```

--------------------------------

### List Recent Posts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Retrieve a list of posts using the CLI or the API with optional filtering parameters.

```bash
./scripts/post-bridge.js posts
```

```bash
curl -X GET "https://api.post-bridge.com/v1/posts?limit=50&offset=0&status=scheduled&platform=instagram" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### Automation Guidelines

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Best practices and rules to follow when automating social media posts to maintain account health and avoid spamming.

```APIDOC
## Automation Guidelines

When automating posts, follow these rules to keep accounts in good standing:

- **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

**Publishing confirmation**: Unless the user explicitly asks to "post now" or "publish immediately", always confirm before posting. Creating a draft is safe; posting is irreversible and goes live instantly.
```

--------------------------------

### List Posts

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Retrieve a list of posts with options to filter by status and platform, and paginate results.

```http
GET /v1/posts?limit=50&offset=0&status=scheduled&platform=instagram
```

--------------------------------

### MCP Server Configuration

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Add this configuration to your MCP client to connect to the Post Bridge MCP server. Ensure your client is MCP-compatible.

```json
{
  "mcpServers": {
    "post-bridge": {
      "type": "streamable-http",
      "url": "https://mcp.post-bridge.com/mcp"
    }
  }
}
```

--------------------------------

### Sync Specific Platform Analytics via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this curl command to trigger a background refresh of analytics data for a specific platform.

```bash
curl -X POST "https://api.post-bridge.com/v1/analytics/sync?platform=tiktok" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### Platform Names

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

A list of exact platform names to be used for filtering and configurations within the Post Bridge API.

```APIDOC
## Platform Names

Use these exact names for platform filtering and configurations:
- `instagram` — Instagram (Reels, Stories, Feed)
- `tiktok` — TikTok
- `youtube` — YouTube (Shorts)
- `twitter` — X (formerly Twitter)
- `linkedin` — LinkedIn
- `facebook` — Facebook
- `pinterest` — Pinterest
- `threads` — Threads
- `bluesky` — Bluesky
```

--------------------------------

### Upload Media Files

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Upload images and videos before attaching them to posts. Supports JPEG, PNG, GIF, WebP, MP4, MOV, AVI, and WebM formats.

```APIDOC
## Upload Media Files

Upload images and videos before attaching them to posts. Supports JPEG, PNG, GIF, WebP, MP4, MOV, AVI, and WebM formats.

### CLI Commands

```bash
# Upload a video file
./scripts/post-bridge.js upload --file ./video.mp4

# Upload an image
./scripts/post-bridge.js upload --file ./image.jpg
```

### cURL Equivalent (Two-Step Process)

**Step 1: Get upload URL**

```bash
curl -X POST "https://api.post-bridge.com/v1/media/create-upload-url" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"mime_type": "video/mp4", "size_bytes": 5242880, "name": "video.mp4"}'
```

**Response:**

```json
{"media_id": "mid_xyz789", "upload_url": "https://..."}
```

**Step 2: Upload binary file to the returned URL**

```bash
curl -X PUT "https://upload-url-from-step-1" \
  -H "Content-Type: video/mp4" \
  --data-binary @./video.mp4
```

### CLI Output Example

```json
{
  "media_id": "mid_xyz789"
}
```
```

--------------------------------

### POST /v1/posts

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Creates a new social media post, supporting scheduling, drafts, and queue-based posting.

```APIDOC
## POST /v1/posts

### Description
Creates a new post. Supports instant posting, scheduled posting, or queue-based scheduling.

### Method
POST

### Endpoint
/v1/posts

### Request Body
- **caption** (string) - Required - The post content including hashtags
- **media** (array) - Required - List of media IDs
- **social_accounts** (array) - Required - List of account IDs
- **scheduled_at** (string) - Optional - ISO 8601 timestamp for scheduling
- **is_draft** (boolean) - Optional - Set to true to save as draft
- **use_queue** (boolean/object) - Optional - Auto-schedule to next queue slot
- **platform_configurations** (object) - Optional - Platform-specific settings
- **account_configurations** (object) - Optional - Per-account overrides

### Request Example
{
  "caption": "your caption here #hashtags",
  "media": ["<media_id>"],
  "social_accounts": [1, 2],
  "scheduled_at": "2026-01-01T14:00:00Z",
  "is_draft": false
}
```

--------------------------------

### Queue-Based Scheduling with Timezone Override via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this curl command to schedule a post to the user's next available queue slot, overriding the default timezone. Requires 'use_queue': {'timezone': '...'}.

```bash
curl -X POST "https://api.post-bridge.com/v1/posts" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Queued post with timezone",
    "social_accounts": [1, 2],
    "use_queue": {"timezone": "America/New_York"}
  }'
```

--------------------------------

### Delete Media via CLI

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this CLI command to remove uploaded media files by their ID.

```bash
./scripts/post-bridge.js media:delete --id mid_xyz789
```

--------------------------------

### MCP Tools

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

A list of available MCP tools for managing social media posts, analytics, and media through the Post Bridge API.

```APIDOC
## MCP Tools available (11 tools):

| Tool |
|------| Description |
| `list_social_accounts` | List all connected accounts with IDs, platforms, usernames |
| `create_post` | Create/schedule a post. Accepts caption, accounts, media_urls, schedule, use_queue (true or {timezone}), platform configs |
| `list_posts` | List posts with filters (platform, status, limit, offset) |
| `get_post` | Get full post details by ID |
| `update_post` | Update caption, schedule, accounts, or media on a scheduled/draft post |
| `delete_post` | Delete a scheduled or draft post |
| `list_analytics` | Get analytics (views, likes, comments, shares) with platform/timeframe filters |
| `sync_analytics` | Trigger a background refresh of analytics data. Optional `platform` param to sync a specific platform (tiktok/youtube/instagram) |
| `list_post_results` | Check per-platform posting results (success/failure with error details) |
| `list_media` | List uploaded media files with IDs and URLs |
| `delete_media` | Delete an uploaded media file |

MCP tools accept `media_urls` (public URLs) — the server downloads and uploads them automatically. No need to manually upload media when using MCP.
```

--------------------------------

### List Connected Social Accounts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Retrieve a list of all connected social media accounts, including their IDs, platforms, and usernames. Account IDs are necessary for creating posts.

```bash
# CLI command
./scripts/post-bridge.js accounts
```

```bash
# curl equivalent
curl -X GET "https://api.post-bridge.com/v1/social-accounts" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

```json
{
  "data": [
    { "id": 1, "platform": "instagram", "username": "myaccount" },
    { "id": 2, "platform": "tiktok", "username": "myaccount" },
    { "id": 3, "platform": "youtube", "username": "My Channel" },
    { "id": 4, "platform": "twitter", "username": "myhandle" }
  ]
}
```

--------------------------------

### Check Post Results

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/README.md

Retrieve status and error details for a specific post ID.

```bash
./scripts/post-bridge.js results --post-id <id>
```

--------------------------------

### Extract Frame with FFmpeg

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Use this FFmpeg command to extract a single frame from a video at a specific timestamp. This is useful for generating thumbnails or analyzing video content.

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

--------------------------------

### List Analytics for Posts

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Fetch analytics data such as views, likes, comments, and shares for posts. You can filter by platform and timeframe, and paginate the results.

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

--------------------------------

### DELETE /v1/media/{id}

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Remove uploaded media files that are no longer needed.

```APIDOC
## DELETE /v1/media/{id}

### Description
Remove uploaded media files that are no longer needed.

### Method
DELETE

### Endpoint
/v1/media/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The ID of the media file to delete.

### Response
#### Success Response (200)
- **deleted** (boolean) - Status of the deletion.
- **id** (string) - The ID of the deleted media.

#### Response Example
{
  "deleted": true,
  "id": "mid_xyz789"
}
```

--------------------------------

### Delete Media via API

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Use this curl command to remove uploaded media files by their ID.

```bash
curl -X DELETE "https://api.post-bridge.com/v1/media/mid_xyz789" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### Delete Posts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Remove scheduled or draft posts from the system.

```bash
./scripts/post-bridge.js posts:delete --id post_abc123
```

```bash
curl -X DELETE "https://api.post-bridge.com/v1/posts/post_abc123" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

--------------------------------

### List Connected Social Accounts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Retrieve all connected social media accounts with their IDs, platforms, and usernames. Account IDs are required for creating posts.

```APIDOC
## List Connected Social Accounts

Retrieve all connected social media accounts with their IDs, platforms, and usernames. Account IDs are required for creating posts.

### CLI Command

```bash
./scripts/post-bridge.js accounts
```

### cURL Equivalent

```bash
curl -X GET "https://api.post-bridge.com/v1/social-accounts" \
  -H "Authorization: Bearer pb_live_xxxxx"
```

### Response Example

```json
{
  "data": [
    { "id": 1, "platform": "instagram", "username": "myaccount" },
    { "id": 2, "platform": "tiktok", "username": "myaccount" },
    { "id": 3, "platform": "youtube", "username": "My Channel" },
    { "id": 4, "platform": "twitter", "username": "myhandle" }
  ]
}
```
```

--------------------------------

### DELETE /v1/media/<media_id>

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Deletes a specific uploaded media file.

```APIDOC
## DELETE /v1/media/<media_id>

### Description
Removes an uploaded media file from the system.

### Method
DELETE

### Endpoint
/v1/media/<media_id>

### Parameters
#### Path Parameters
- **media_id** (string) - Required - The unique identifier of the media to delete
```

--------------------------------

### Authenticate API Requests

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

All API requests require a Bearer token in the Authorization header.

```http
Authorization: Bearer <POST_BRIDGE_API_KEY>
```

--------------------------------

### Retrieve Social Accounts

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Fetch a list of connected social accounts to obtain IDs required for posting.

```http
GET /v1/social-accounts
```

--------------------------------

### Analytics Sync Trigger Response

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Response indicating which analytics syncs have been triggered, including a run ID for each platform.

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

--------------------------------

### Sync Analytics Data

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Trigger a background synchronization of analytics data from connected platforms. You can specify a single platform or sync all tracked platforms.

```http
POST /v1/analytics/sync?platform=tiktok
```

--------------------------------

### Update Scheduled Posts

Source: https://context7.com/post-bridge-hq/agent-mode/llms.txt

Modify post attributes for scheduled or draft posts via the API.

```bash
curl -X PATCH "https://api.post-bridge.com/v1/posts/post_abc123" \
  -H "Authorization: Bearer pb_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Updated caption! #edited",
    "scheduled_at": "2026-03-06T09:00:00Z",
    "social_accounts": [1, 2]
  }'
```

--------------------------------

### Update a Post

Source: https://github.com/post-bridge-hq/agent-mode/blob/main/skills/post-bridge/SKILL.md

Modify an existing scheduled or draft post. You can update fields such as caption, schedule, associated accounts, media, platform configurations, or draft status.

```http
PATCH /v1/posts/<post_id>
Body: { "caption": "new caption", "scheduled_at": "...", "social_accounts": [...] }
```