Social Media Assistant (通过 post-bridge.com)

通过 [Post Bridge](https://post-bridge.com) API 自动化管理社交媒体发布。

设置

1. 在 [post-bridge.com](https://post-bridge.com) 创建 Post Bridge 账户
2. 连接您的社交账号（TikTok、Instagram、YouTube、Twitter 等）
3. 启用 API 访问权限（设置 → API）
4. 将您的 API 密钥存储在工作区的 .env 文件中：

POST_BRIDGE_API_KEY=pb_live_xxxxx

1. 下载 API 文档：https://api.post-bridge.com/reference → 保存到工作区，命名为 post-bridge-api.json

认证

所有请求使用 Bearer Token：

Authorization: Bearer <POST_BRIDGE_API_KEY>

基础 URL：https://api.post-bridge.com

核心流程

1. 获取社交账号

GET /v1/social-accounts

返回已连接账号列表，包含 id、platform、username。请保存这些 ID —— 每次发布都需要。

2. 上传媒体

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

返回 media_id 和 upload_url。随后执行：

PUT <upload_url>
Content-Type: video/mp4
Body: <二进制文件>

3. 创建帖子

POST /v1/posts
Body: {
  "caption": "您的文案 #标签",
  "media": ["<media_id>"],
  "social_accounts": [<account_id_1>, <account_id_2>],
  "scheduled_at": "2026-01-01T14:00:00Z",  // 省略则立即发布
  "platform_configurations": { ... }  // 可选，详见下文
}

创建时的额外选项：

• media_urls: 公开可访问的 URL 数组（若不使用 media ID，则替代 media 字段）。示例：["https://example.com/video.mp4"]
• is_draft: 若为 true，则创建草稿但不立即处理，需后续更新发布时间或手动发布。
• processing_enabled: 若为 false，跳过视频处理。默认值为 true。
• use_queue: 自动安排至您下一个可用队列时段（需在 Post Bridge 控制台中配置）。不能与 scheduled_at 一起使用。传入 true 使用保存的时区，或 { "timezone": "America/New_York" } 覆盖时区。

**use_queue 示例：**

{
  "caption": "已排队发布的帖子！",
  "media": ["<media_id>"],
  "social_accounts": [44029],
  "use_queue": true
}

系统将自动查找队列中的下一个空闲时段并设置 scheduled_at。您必须先在控制台中配置好队列计划。

4. 更新或删除已排期帖子

PATCH /v1/posts/<post_id>

更新已排期的帖子（如文案、发布时间等）。仅适用于状态为 scheduled 的帖子。

DELETE /v1/posts/<post_id>

删除已排期的帖子。仅适用于状态为 scheduled 的帖子。

5. 检查结果

GET /v1/posts/<post_id>

返回状态：processing（处理中）、scheduled（已排期）、posted（已发布）、failed（失败）。

GET /v1/post-results

列出跨平台的所有发布结果（分页，支持 offset 和 limit）。

6. 数据分析

GET /v1/analytics

获取帖子表现数据（播放量、点赞数、分享数、评论数等）。

查询参数：

• platform —— 按平台筛选（如 tiktok、youtube、instagram）
• post_result_id[] —— 按特定发布结果 ID 筛选（多个值表示“或”逻辑）
• timeframe —— 7d、30d、90d 或 all（默认：all）
• offset / limit —— 分页控制

返回字段包括：view_count、like_count、comment_count、share_count、cover_image_url、share_url、duration 等。

POST /v1/analytics/sync

手动触发从各平台同步分析数据。可选地添加 ?platform=tiktok 仅同步指定平台。每 5 分钟限一次。

平台配置

在发布时将配置放在 platform_configurations 对象中。关键提示： 必须使用正确的平台键包裹配置，确保仅作用于目标平台，避免影响其他平台。

**TikTok (tiktok)：**

• draft: true —— 保存为草稿（可在 TikTok 上手动发布并添加热门音效）
• video_cover_timestamp_ms: 3000 —— 视频封面时间戳（毫秒）
• is_aigc: true —— 声明为 AI 生成内容

多平台配置正确示例：

{
  "caption": "通用文案",
  "social_accounts": [44029, 44030],
  "platform_configurations": {
    "tiktok": {
      "draft": true,
      "is_aigc": false
    },
    "instagram": {
      "is_trial_reel": false
    }
  }
}

**Instagram (instagram)：**

• video_cover_timestamp_ms: 3000 —— 视频封面时间戳（毫秒）
• is_trial_reel: true —— 试用短视频模式（需至少 1000 名粉丝）
• trial_graduation: "SS_PERFORMANCE" —— 根据表现自动升级

YouTube：

• video_cover_timestamp_ms: 3000 —— 视频封面时间戳（毫秒）
• title: "我的短标题" —— 覆盖默认标题

Twitter/X：

• caption: "覆盖文案" —— 平台专属文案

所有平台均支持 caption 和 media 的按平台覆盖，用于个性化定制。

视频内容推荐工作流

1. 将视频存放在本地文件夹中
2. 使用 ffmpeg 提取一帧以读取画面中的文字叠加：

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

1. 根据视频内容撰写文案并添加标签
2. 上传 → 创建帖子 → 排期或立即发布（也可使用 use_queue 自动排期）
3. 将已发布的视频移至 posted/ 子文件夹，防止重复发布
4. 设置定时任务，在预计发布时间后 5 分钟检查发布状态
5. 使用 GET /v1/analytics 或浏览平台页面追踪表现

小贴士

• 可同时向多个平台发布，只需在 social_accounts 中包含多个账号 ID
• 分时段发布（如上午 9 点 + 下午 3 点）可提升曝光效果
• 使用 scheduled_at 预排批量内容 —— Post Bridge 会自动处理发布时间
• 使用 use_queue 可自动填充队列计划，无需手动计算时间
• TikTok 草稿模式允许您在发布前手动添加热门音效
• 每个帖子建议保留 4–5 个标签以获得最佳互动
• 监控哪些内容表现良好，并持续优化文案和格式