post-bridge

Post Bridge 社交媒体技能

此技能会对你的系统和账号执行什么操作。 安装前请阅读。

• 会发布到你的真实社交账号。 发布的内容都会公开。除非用户明确表示不需要确认，否则在创建或安排帖子前请先征求确认；如果用户意图不明确，优先使用 draft: true。
• 会将你的媒体文件和说明文字发送给第三方。 文件、说明文字、账号 ID 和计划发布时间等元数据会通过你的 API 密钥发送到 api.post-bridge.com。
• 会使用 POST_BRIDGE_API_KEY、./.post-bridge/config.json 或 ~/.config/post-bridge/config.json 中的 API 密钥。请仅使用你愿意让 Agent 代为发布的密钥。
• 在执行以下可选的视频工作流时会运行本地命令， 包括使用 ffmpeg 处理你的文件。
• 如果你采用可选的 posted/ 约定，可能会移动本地文件； 如果你执行可选的 cron 步骤，可能会创建计划任务。这两项都是建议，并非必需。除非你提出要求，否则都不会发生。

通过 Post Bridge API 自主管理社交媒体发布。通过一条命令或一次 API 调用即可发布到 9 个平台。

CLI 已发布到 npm，包名为 postbridge-cli——运行 npx postbridge-cli <command> 即可（无需安装；npx 会在首次使用时获取它）。需要 Node.js 18+。如果由于任何原因无法使用 npx postbridge-cli，请改用附带的脚本 <skill-path>/scripts/post-bridge.js（命令和标志相同）。

新鲜度检查：如果距离上方的 last-updated 日期已超过 30 天，请告知用户此技能可能已过时，并指引他们查看下方的更新选项。

保持此技能为最新版本

源代码：github.com/post-bridge-hq/agent-mode API 文档：api.post-bridge.com/reference

根据安装类型选择更新方式：

安装方式	更新方法
CLI（npx skills）	npx skills update
Claude Code 插件	/plugin marketplace update
Cursor	远程规则会从 GitHub 自动同步
手动安装	从仓库拉取最新版本，或重新复制 skills/post-bridge/

设置

1. 在 post-bridge.com 创建 Post Bridge 账号
2. 连接你的社交账号（TikTok、Instagram、YouTube、Twitter 等）
3. 启用 API 访问权限（Settings > API）
4. 将 API 密钥存储在工作区 .env 中：

   POST_BRIDGE_API_KEY=pb_live_xxxxx
   

或运行设置命令：

npx postbridge-cli setup --key pb_live_xxxxx

身份验证

所有请求都使用 Bearer 令牌：

Authorization: Bearer <POST_BRIDGE_API_KEY>

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

配置优先级（从高到低）：

1. POST_BRIDGE_API_KEY 环境变量
2. ./.post-bridge/config.json（项目本地）
3. ~/.config/post-bridge/config.json（用户全局）

处理“找不到 API 密钥”错误

当你从 CLI 收到“找不到 API 密钥”错误时：

1. 告知用户运行设置命令——设置需要用户输入，因此你不能代替他们运行：

   npx postbridge-cli setup --key pb_live_xxxxx
   

2. 停止并等待——不要继续执行任务。没有有效的 API 密钥，你无法创建帖子或执行任何 API 操作。
3. 切勿在环境文件、钥匙串或其他位置搜索 API 密钥。

获取 API 密钥：https://www.post-bridge.com/dashboard/api-keys

给 Agent 的说明：优先使用 npx postbridge-cli（已发布的 npm CLI）。如果技能已在本地安装，且你想改用附带版本的脚本，该脚本位于 <skill-path>/scripts/post-bridge.js——命令和标志相同。

CLI 命令

命令	描述
npx postbridge-cli setup --key <key>	配置 API 密钥
npx postbridge-cli accounts	列出已连接的社交账号
npx postbridge-cli post --caption "..." --accounts 1,2,3	创建帖子
npx postbridge-cli post --caption "..." --accounts 1,2,3 --schedule "2026-06-20T09:00:00Z"	安排在指定时间（UTC）发布帖子
npx postbridge-cli post --caption "..." --accounts 1,2 --use-queue	自动安排在下一个队列时段发布（使用已保存的时区）
npx postbridge-cli post --caption "..." --accounts 1,2 --use-queue --queue-timezone "America/New_York"	自动安排在指定时区的下一个队列时段发布
npx postbridge-cli post --caption "..." --accounts 1,2 --draft	保存为草稿，而非发布
npx postbridge-cli post --caption "..." --accounts 1,2 --platform-config '{"tiktok":{"draft":true}}'	发布帖子并设置各平台选项
npx postbridge-cli post --caption "..." --accounts 1,2 --media mid_x --platform-config '{"youtube":{"title":"...","tags":["a","b"]}}'	设置 YouTube 标题和每个视频的标签
npx postbridge-cli upload-link	为用户设备上的文件创建有效期为 24 小时的上传页面；然后运行 media（按时间从新到旧）获取 media_id
npx postbridge-cli upload --file ./image.jpg	上传媒体，返回 media_id
npx postbridge-cli post --caption "..." --accounts 1,2,3 --media mid_xxx	发布包含已上传媒体的帖子
npx postbridge-cli posts	列出近期帖子（筛选项：--status、--platform、--limit、--offset）
npx postbridge-cli posts:get --id <post_id>	获取帖子详情和状态
npx postbridge-cli posts:update --id <post_id> --caption "..."	更新已安排发布或草稿帖子（说明文字、发布时间、账号、媒体、草稿状态）
npx postbridge-cli posts:delete --id <post_id>	删除已安排发布或草稿帖子
npx postbridge-cli analytics	查看分析数据（筛选项：--platform、--timeframe 7d|30d|90d|all）
npx postbridge-cli analytics:daily --id <analytics_id>	查看单个帖子的每日快照和变化量（ID 来自 analytics）
npx postbridge-cli analytics:sync	刷新分析数据（可选：--platform tiktok|youtube|instagram）
npx postbridge-cli help	以 JSON 格式列出所有命令、标志和 platform-config 键
npx postbridge-cli results --post-id <post_id>	查看各平台的发布结果
npx postbridge-cli media	列出已上传的媒体
npx postbridge-cli media:delete --id <media_id>	删除已上传的媒体

API 参考

如果你更倾向于直接调用原始 API，而不是使用 CLI，请使用以下端点。

社交账号

GET /v1/social-accounts

返回已连接账号的数组，包含 id、platform、username。请保存这些 ID——每次发布帖子都需要用到。

上传媒体

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: <binary file>

上传链接（文件位于用户设备上，没有公开 URL）

当 Agent 无法读取文件本身时（文件位于用户的手机或 笔记本电脑上，或者文件过大，无法通过 Agent 传输），请创建一个上传链接并 发送给用户：

POST /v1/media/upload-link

返回 { "url": "https://www.post-bridge.com/u/<token>", "expires_at": ... }。 用户打开链接，拖放文件（最大 500MB，支持图片、视频和 PDF），文件 便会出现在其媒体库中。然后运行 GET /v1/media（按时间从新到旧）以获取 media_id，并将其传给创建帖子接口。链接有效期为 24 小时，且可接收 多个文件。

列出媒体：

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

删除媒体：

DELETE /v1/media/<media_id>

创建帖子

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）：

• 传入 true，使用用户在控制面板设置中保存的时区自动排期
• 传入 { "timezone": "America/New_York" }，使用指定的 IANA 时区覆盖默认时区
• 不能与 scheduled_at 同时使用——二选一
• 时区优先级：显式指定的时区 > 已保存的个人资料/工作区时区 > UTC
• 队列时段适用于所选社交账号所属的工作区
• 队列排期由用户在 Post Bridge 控制面板中配置
• 如果启用了 randomize_queue_time，时段时间将偏移最多 ±10 分钟，让发帖模式更自然
• 如果未配置队列排期，或未来 90 天内没有可用时段，则返回错误

列出帖子

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

参数：limit、offset、status（scheduled/published/failed/draft）、platform。

获取帖子

GET /v1/posts/<post_id>

返回完整帖子详情，包括状态：processing、scheduled、posted、failed。

更新帖子

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

可更新说明文字、排期、账号、媒体、平台配置或草稿状态。仅适用于已排期或草稿帖子。

删除帖子

DELETE /v1/posts/<post_id>

仅适用于已排期或草稿帖子（无法删除已发布的帖子）。

发帖结果

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

返回各平台的结果，显示每个平台的帖子是否发布成功或失败，并提供错误详情。

分析数据

列出分析数据——每篇帖子的浏览量、点赞数、评论数和分享数：

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

参数：

• platform（可选）：tiktok、youtube、instagram
• timeframe（可选）：7d、30d、90d、all（默认：all）
• limit、offset 用于分页

返回：

{
  "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

触发分析数据的后台同步。支持所有已跟踪的平台：TikTok、YouTube 和 Instagram。

参数：

• platform（可选）：tiktok、youtube 或 instagram——仅同步一个平台。不填则同步所有平台。

返回：

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

获取单条分析记录：

GET /v1/analytics/<analytics_id>

MCP 集成

Post Bridge 内置 MCP（Model Context Protocol）服务。如果你使用 Claude Desktop、ChatGPT、Cursor 或任何兼容 MCP 的客户端，无需此技能即可直接连接。

Claude Desktop：在 post-bridge.com/mcp 一键连接

Claude Code / Cursor / 其他 MCP 客户端——添加到 MCP 配置中：

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

可用的 MCP 工具（11 个）：

工具	描述
list_social_accounts	列出所有已连接的账号，包括 ID、平台、用户名和 needs_reconnect（true = 因令牌持续失效而暂停向该账号发帖；请跳过该账号，并告知用户在控制面板中重新连接，这会自动解除暂停）
create_post	创建/排期帖子。接受说明文字、账号、media_urls、排期、use_queue（true 或 {timezone}）和平台配置
list_posts	列出帖子并应用筛选条件（平台、状态、limit、offset）
get_post	按 ID 获取完整帖子详情
update_post	更新已排期或草稿帖子的说明文字、排期、账号或媒体
delete_post	删除已排期或草稿帖子
list_analytics	获取分析数据（浏览量、点赞数、评论数、分享数），支持按平台/时间范围筛选
sync_analytics	触发分析数据的后台刷新。可选的 platform 参数用于同步指定平台（tiktok/youtube/instagram）
list_post_results	查看各平台的发帖结果（成功/失败及错误详情）
list_media	列出已上传的媒体文件及其 ID 和 URL
delete_media	删除已上传的媒体文件

MCP 工具接受 media_urls（公开 URL）——服务会自动下载并上传媒体。使用 MCP 时无需手动上传媒体。

平台配置

可选的平台级覆盖项，可在创建/更新帖子时通过 platform_configurations 对象传入，也可通过 CLI 中的 --platform-config '<json>' 传入。这是最容易出错的地方，请仔细阅读：

规则

1. 按平台名称设置键。 每项覆盖都必须放在平台键下：pinterest、instagram、tiktok、twitter、youtube、facebook、linkedin、bluesky、threads、google_business。字段放在错误层级（或错误的平台下）会被静默忽略。
2. 只包含你实际要发帖的平台。 如果 social_accounts 中没有 TikTok 账号，就不要添加 tiktok 块。
3. 只包含你想覆盖的字段。 未指定的内容都会回退到顶层的 caption / media。所有平台键下都接受 caption 和 media；其他字段则因平台而异，详见下文。
4. 严格使用接受的值。 枚举（placement、trial_graduation、cta_action_type、location 等）只接受所示值；其他值会报错或被丢弃。

每个平台都接受：

• caption（字符串）——仅覆盖该平台的文案
• media（媒体 ID 数组）——仅覆盖该平台的媒体

平台专属字段：

平台（key）	字段	类型 / 可接受值	作用
Pinterest（pinterest）	board_ids	字符串 ID 数组	要发布 Pin 的看板（填写 ID，而非名称）。省略 → 账号默认看板。
	link	字符串（完整 URL）	Pin 链接到的目标 URL。
	title	字符串（≤100 个字符）	显示在说明文字上方的 Pin 标题。
	video_cover_timestamp_ms	数字（毫秒）	视频封面帧，例如 3000 = 视频开始后 3 秒。
Instagram（instagram）	placement	"story"	以快拍形式发布（单张图片/视频，无说明文字/轮播/封面/试投）。省略 → Reels/动态。
	video_cover_timestamp_ms	数字（毫秒）	Reel/视频的封面帧。若设置了 cover_image，则忽略此项。
	cover_image	字符串（媒体 ID）	上传的图片，用作 Reel 封面。请先上传，再传入其 ID。
	is_trial_reel	布尔值	试投 Reel（优先展示给非粉丝）。需要 Pro/Creator 账号、1,000 名以上粉丝及公开个人主页。每天最多 5 条。不能与 placement:"story" 同时使用。
	trial_graduation	"MANUAL" | "SS_PERFORMANCE"	试投 Reel 转为正式 Reel 的方式。MANUAL（默认）= 由你决定；SS_PERFORMANCE = 根据 72 小时内的表现自动转为正式 Reel。
	user_tags	用户名数组	标记用户账号（对方会收到通知）。@ 可选。仅适用于动态/轮播/Reels；快拍会忽略此项。最多 20 个。
	collaborators	用户名数组	邀请共同创作者：帖子也会显示在对方个人主页，并共享点赞/评论。@ 可选。最多 3 人，且仅限公开账号——私密账号或错误的用户名会导致发布失败。仅适用于动态/轮播/Reels；快拍会忽略此项。帖子立即发布；对方接受邀请后，帖子会显示在其个人主页上。
	first_comment	字符串（≤2200）	帖子发布后立即发布的评论——适合放置链接或标签。快拍会忽略此项。评论发布失败不会导致帖子发布失败。
TikTok（tiktok）	title	字符串	覆盖帖子标题。
	video_cover_timestamp_ms	数字（毫秒）	封面帧，例如 3000 = 视频开始后 3 秒。
	draft	布尔值	作为原生 TikTok 草稿发送（在应用中手动完成/发布，例如添加热门音频）。这与顶层的 is_draft 不同（后者只会保存在 Post Bridge 中）。
	is_aigc	布尔值	标记为 AI 生成内容。
	privacy_status	"public" | "private"	private 表示仅你自己可见。默认为公开。
	auto_add_music	布尔值	仅适用于图片帖子——视频会忽略此项。 TikTok 会为轮播选择配乐。默认为 true；设为 false 可静音发布。
	allow_comment	布尔值	允许评论。默认为 true。
	allow_duet	布尔值	允许合拍。默认为 true。仅适用于视频帖子。
	allow_stitch	布尔值	允许合拍拼接。默认为 true。仅适用于视频帖子。
	disclose_branded_content	布尔值	声明为付费合作/品牌内容。默认为 false。
	disclose_your_brand	布尔值	声明为推广自己的品牌。默认为 false。
Twitter/X（twitter）	first_comment	字符串（≤280，Premium 账号为 2200）	推文发布后立即发布的回复。请在此处放置链接——主推文会移除 URL，以避开 X 的附加费用。回复发布失败不会导致帖子发布失败。
YouTube（youtube）	title	字符串（≤100 个字符）	覆盖视频标题。
	tags	string[]	视频标签，按视频设置（YouTube snippet.tags）。总字符数上限为 500；超出部分会被丢弃，帖子仍会发布。
	contains_synthetic_media	布尔值	声明包含逼真的篡改/AI 内容（标记为“篡改或合成内容”）。
	thumbnail	字符串（媒体 ID）	自定义缩略图。仅适用于长视频——Shorts 会忽略此项。频道必须通过验证；格式为 JPEG/PNG，尺寸为 1280×720，且小于 2MB。
Facebook（facebook）	placement	"story"	以主页快拍形式发布（单张图片/视频，无说明文字/轮播）。省略 → 动态帖子。
	first_comment	字符串（≤2200）	帖子发布后立即发布的评论——适合放置链接/CTA。快拍会忽略此项。评论发布失败不会导致帖子发布失败。
LinkedIn（linkedin）	document_title	字符串	PDF（文档/轮播）帖子的标题。仅当媒体为 PDF 时适用。默认为文件名。
	first_comment	字符串（≤1250）	帖子发布后，由同一个人员资料或主页发布的评论。适合放置链接。评论发布失败不会导致帖子发布失败。
Bluesky（bluesky）	—	—	仅支持覆盖 caption / media。
Threads（threads）	location	"timeline" | "reels"	内容的显示位置。timeline（默认）或 reels（仅视频）。
	first_comment	字符串（≤500）	主题发布后立即发布的回复——适合放置链接。回复发布失败不会导致帖子发布失败。
Google Business（google_business）	media	数组（单张图片）	仅限一张图片——GMB 会丢弃多余图片（其他平台会保留全部图片）。不支持视频。
	cta_action_type	BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL	CTA 按钮。需与 cta_url 配合使用（CALL 除外，使用地点电话号码）。
	cta_url	字符串（完整 URL）	CTA 目标地址。设置 cta_action_type 时必须填写（CALL 除外）。
	language_code	字符串（BCP-47）	例如 "en-US"、"es"、"fr-CA"。默认为 "en-US"。
示例 — 正确的多平台配置（CLI）

将一条内容发布到 TikTok、Instagram、X 和 Google Business，并针对各平台进行调整：

npx postbridge-cli post --caption "New drop is live 🎉" --accounts 44029,44030,44031,44032 \
  --platform-config '{
    "tiktok":   { "draft": true, "is_aigc": false },
    "instagram": { "caption": "New drop is live 🎉 tap the link in bio", "video_cover_timestamp_ms": 2000 },
    "twitter":  { "first_comment": "Grab it here: https://example.com/drop" },
    "google_business": { "cta_action_type": "SHOP", "cta_url": "https://example.com/drop" }
  }'

注意，X 的链接放在 twitter.first_comment 中（而不是说明文字中），TikTok 使用原生草稿，并且只有要发布到的四个平台会作为键出现。

平台注意事项（对 Agent 很重要）

这些行为很容易被忽略，并导致静默或令人困惑的失败。发布前请考虑这些情况。

• 有些平台要求媒体，其他平台接受纯文本。 以下平台在没有媒体时会导致发布失败：youtube（必须恰好有 1 个视频）、tiktok（1 个视频，或照片帖包含 1 张或多张图片）、instagram（1–10 张图片／视频；快拍必须恰好有 1 个；PDF 会被丢弃）、pinterest（1–5 张图片——2 张及以上会发布为轮播图钉，且所有图片必须具有相同的宽高比，否则 Pinterest 会拒绝——或 1 个视频）。以下平台接受纯文本：twitter／X（最多 4 张图片，或 1 个视频）、facebook、linkedin（最多 20 张图片，或 1 个视频，或 1 个 PDF 文档）、threads（最多 20 张图片／视频）、bluesky（最多 4 张图片，或 1 个视频）、google_business（文本或单张图片；不支持视频）。可以在不添加媒体的情况下创建帖子，然后通过 posts:update 添加媒体，但在媒体添加之前，帖子无法发布到要求媒体的平台。如果一条帖子面向多个平台，每个平台会使用自己支持的媒体，并跳过不支持的媒体（例如，视频可用于 YouTube；X 也会使用该视频）。
• X（Twitter）会从说明文字中移除 URL。 发布前，X 会从说明文字中移除链接（http://、https://、www.）。这是有意为之（在 X 上发布带链接的帖子，每条成本约高出 13 倍）。如果 X 帖子必须包含链接，请将链接放在 twitter.first_comment 中（这里允许链接——系统会在推文发布后立即以回复形式发布），而不是说明文字中，并告知用户该链接不会显示在 X 帖子本身中。
• 媒体必须上传，不能粘贴原始链接。 不要将 Google Drive／Dropbox 或任意外部 URL 放入 media。media 字段只接受 Post Bridge 的 media_id。请先通过 CLI／API upload 文件，或者使用 media_urls（CLI 的 --media-urls，或 MCP 的 media_urls 字段），并提供服务器可以下载的直接公开文件 URL。非直接分享链接会导致通用错误，且不会返回各平台的结果。
• 超大视频（约 300MB 以上）可能会静默导致 YouTube、LinkedIn 和 X 发布失败。 这三个平台会在服务端缓冲整个文件，处理超大上传时可能超时或出现内存不足，从而不返回它们的结果行，而 Instagram／TikTok／Facebook／Threads 却能发布成功。如果 results 显示的平台数量少于你发布到的平台数量，请怀疑文件大小问题——重新编码以缩小文件或缩短视频。视频大小应保持在合理范围内。
• 每个平台独立发布。 一个平台失败不会阻止其他平台发布。每次发布后都要检查 results --post-id <id>，确认各平台是否成功，并查看任何错误详情。
• TikTok／Instagram 对说明文字和声音的限制各不相同。 说明文字要简洁；使用热门声音的工作流中，请将 TikTok 的 draft: true 设为启用草稿，让用户添加声音并手动发布。

实际失败情况：根据截至 2026-08-31 的 30 天内，来自 7,158 个账号的 302,000 条帖子测得。 每个平台都有一种主要失败方式，正确的应对方式也各不相同：

• TikTok：75% 的失败是垃圾信息限制。 平台因发布过于频繁而对该账号采取的限制。会在 24 至 48 小时内自动解除。重新连接没有用。如果等待后限制仍未解除，用户应在接下来的几天里手动通过手机从该账号发布内容。
• YouTube：84% 是每日上传配额问题，配额按频道计算，新频道的配额更低。请将上传安排到不同频道和日期。
• X：92% 是 403 垃圾信息拦截，原因是发布过快、内容重复度过高或包含链接。
• Instagram：50% 是令牌失效，41% 是 Meta 的临时 500 错误。 尽管报告失败，发生 500 错误时内容往往仍已发布，因此请在重新发布前检查，否则会重复发布。
• Threads 和 LinkedIn：几乎全是令牌失效。 重新连接。
• Pinterest：46% 是未附加有效媒体。
• Bluesky：速率限制、内容下架和电子邮件未确认，这些情况会悄无声息地阻止视频上传。

预期成功率：应根据账号所在平台来评估，而不是一律以 100% 为基准：LinkedIn 97%、X 88%、YouTube 88%、Instagram 87%、Facebook 84%、TikTok 82%、Threads 81%、Pinterest 76%、Bluesky 71%。

重要区别： 平台限制无法由任何人解除，只会自行消失；而令牌失效或缺少媒体则可以采取措施解决。如果账号只是受到限制，却让用户重新连接，就会白白耽误数天。

视频内容的推荐工作流

可选步骤。步骤 2、5 和 6 会操作用户的设备，因此每一步都应先与用户确认，而不是默认用户已同意。

1. 将视频存储在本地文件夹中
2. (运行本地命令) 使用 ffmpeg 提取一帧，以读取画面上的文字叠加内容。请告知用户你即将运行此操作，以及要处理的文件：

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

   如果 ffmpeg 不可用，或用户希望改为描述视频内容，则跳过此步骤。
3. 根据视频内容撰写说明文案并添加话题标签
4. 上传、创建帖子，然后安排发布时间或立即发布
5. (修改本地文件) 可选择将已发布的视频移至 posted/ 子文件夹，以避免重复发布。请指出确切的源路径和目标路径，并先征得同意。绝不要删除任何内容。
6. (创建后台任务) 可选择设置 cron，在预定时间 5 分钟后检查帖子状态。添加前请向用户展示确切的 crontab 行以及如何将其移除。未经用户提示，不要添加。
7. 查看帖子结果或分析数据以跟踪表现

自动化准则

自动发布内容时，请遵循以下规则，以维护账号的良好状态：

• 不要在同一平台的多个账号间发布重复内容
• 不要自动发送未经请求的回复——仅发布原创内容，或在收到明确请求时发布
• 不要操纵趋势——不要在多个账号上大量发布关于热门话题的内容
• 不要伪造互动——不要自动点赞、关注或评论
• 遵守速率限制——API 有速率限制，不要发送垃圾请求
• 使用草稿模式供用户审核——如有疑问，请使用 is_draft: true 或 TikTok 的 draft: true，以便用户在发布前审核

发布确认： 除非用户明确要求“立即发帖”或“立即发布”，否则发布前务必确认。创建草稿是安全的；发布不可撤销，而且会立即上线。

平台名称

筛选平台和配置时，请使用以下确切名称：

• instagram — Instagram（Reels、Stories、Feed）
• tiktok — TikTok
• youtube — YouTube（Shorts）
• twitter — X（原 Twitter）
• linkedin — LinkedIn
• facebook — Facebook
• pinterest — Pinterest
• threads — Threads
• bluesky — Bluesky

提示

• 包含多个账户 ID，即可同时发布到多个平台
• 将帖子分散在一天中的不同时段发布（例如上午 9 点和下午 3 点），以扩大覆盖面
• 使用 scheduled_at 提前安排批量发布——Post Bridge 会处理发布时间
• 使用 use_queue: true，即可根据用户保存的时区，将帖子自动安排到下一个可用的队列时段——无需手动选择时间
• TikTok 草稿模式支持在发布前手动添加热门音频
• 每篇帖子使用 4-5 个标签，以获得最佳互动效果
• 发布后检查 results，查看各平台的成功或失败情况
• 检查分析数据前，使用 analytics:sync 刷新数据
• 关注哪些内容效果好，并不断调整文案和格式
• 测试时使用 --draft 标志，避免意外发布
• 各平台的字符限制不同——X 的文案请保持简洁（280 个字符）