tiktok-post

TikTok 帖子

使用 Publora MCP 服务上传和安排 TikTok 视频。支持隐私控制、互动设置（评论、合拍、拼接）以及商业内容披露。

前提条件

**套餐：**免费 Starter 套餐即可使用。当前限制和价格：publora.com/pricing。

开始使用

1. 创建账户：访问 publora.com/register（免费）
2. 连接 TikTok：在 Publora Dashboard 中通过 OAuth 连接
3. 获取 API 密钥：访问 app.publora.com/dashboard/api，仅当你的 Agent 无法通过 OAuth 登录，或你要使用下方的 REST API 后备方案时才需要
4. 将 Agent 连接到 MCP 服务：地址为 https://mcp.publora.com/mcp：
   • **升级不带 /mcp 的手动连接：**Claude 会将 https://mcp.publora.com 视为与捆绑连接不同的服务。请在当前作用域中，将现有连接改为 https://mcp.publora.com/mcp，并保留其身份验证信息和已选账户；如有提示，请重新登录。或者，先确认捆绑连接使用的是目标账户，然后仅移除旧的手动条目。不要添加第二个条目，也不要自动删除凭据。
   • 已可使用 Publora 工具（publora-skills 插件或 Claude 中的 Publora 连接器）：无需设置。Claude 会在首次运行工具时提示你登录 Publora。
   • 支持 OAuth 的 Agent（Claude Code、Cursor，以及 Claude 和 ChatGPT 应用）：按 URL 添加服务并登录，无需 API 密钥。在 Claude Code 中，添加服务后运行 /mcp 登录：

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp

• **不支持 OAuth 的 Agent：**将 API 密钥作为 Authorization: Bearer sk_YOUR_API_KEY 发送：

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop、Cursor、Codex、OpenClaw 和 claude.ai 连接器各自需要不同的配置文件或流程：请参阅客户端设置，获取准确的路径和代码片段。

REST API 后备方案

如果 MCP 服务不可用或返回错误，请直接使用 REST API：

基础 URL： https://api.publora.com/api/v1

**身份验证：**使用 x-publora-key 标头（而不是 Authorization: Bearer）：

# Get your connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Create a post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok-99887766"],
    "content": "Video caption here #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z",
    "platformSettings": {
      "tiktok": {
        "viewerSetting": "PUBLIC_TO_EVERYONE",
        "allowComments": true
      }
    }
  }'

平台 ID 格式：tiktok-{id}，其中 {id} 来自 /platform-connections 响应。

ID 示例：tiktok-99887766、tiktok-123456789

📖 完整 API 文档：docs.publora.com

平台限制（API 与原生应用）

与 TikTok 原生应用不同的重要 API 限制：

视频要求

规格	API 限制	原生应用
最长时长	10 分钟	60 分钟
最短时长	3 秒	3 秒
最大文件大小	4 GB	4 GB
最低帧率	23 FPS	23 FPS
格式	MP4、MOV、WebM	MP4、MOV、WebM

字幕限制

项目	API 限制	原生应用
字幕长度	2,200 个字符	4,000 个字符
话题标签	计入字幕字符数	计入字幕字符数

速率限制

限制	数值
每日帖子数	15-20
每分钟视频数	最多 2 个

可用工具

create_post

创建新的 TikTok 帖子。

参数：

• platforms：包含你的 TikTok 连接 ID 的数组（例如，["tiktok-99887766"]）
• content：视频说明（最多 2,200 个字符）
• scheduledTime：ISO 8601 UTC 日期时间。可选：省略此参数即可将帖子创建为草稿。传入未来时间即可安排发布。若时间比当前时间早 5 分钟或更久，则会被拒绝并返回 SCHEDULED_TIME_IN_PAST；如需立即发布，请使用当前时间加一分钟。
• mediaUrls：最多 10 个公开的 https 图片或视频 URL。Publora 会在服务器端下载这些文件，并在验证之前附加它们，因此媒体处理和排期可在一次调用中完成。这是「先创建草稿，再调用 get_upload_url，然后调用 complete_media」流程的一步式替代方案。每小时最多接收 60 个 URL。

get_upload_url

获取用于上传视频的预签名 URL。

参数：

• postGroupId：要附加视频的帖子 ID
• fileName：视频文件名（例如，"video.mp4"）
• contentType：video/mp4、video/quicktime 或 video/webm
• type："video"

complete_media

在预签名 PUT 成功后，完成通过 get_upload_url 上传的文件。此步骤为可选操作，因为排期时也会完成待处理媒体，但提前调用可在发布前显示格式和探测错误。通过 mediaUrls 附加的媒体无需调用此工具。

参数：

• mediaId：get_upload_url 返回的 ID

list_connections

列出已连接的账号及其平台 ID。请先调用此工具并原样复制 ID；这些 ID 无法猜测。

list_posts / get_post / update_post / delete_post

管理已安排和草稿帖子。update_post 也可以修改草稿或已安排帖子的 content 和 platforms，因此修正错别字或更改发布目标时，无需再删除并重新创建。delete_media 和 prune_media_reference 用于清理已上传的文件。

平台设置（通过 REST API）

TikTok 有 7 项由 platformSettings 控制的平台专属设置：

{
  "platformSettings": {
    "tiktok": {
      "viewerSetting": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "allowDuet": false,
      "allowStitch": false,
      "commercialContent": false,
      "brandOrganic": false,
      "brandedContent": false
    }
  }
}

观众设置（必需）

值	说明
PUBLIC_TO_EVERYONE	任何人都可以观看（默认）
MUTUAL_FOLLOW_FRIENDS	仅互相关注者可见
FOLLOWER_OF_CREATOR	仅你的关注者可见
SELF_ONLY	仅你可见（类似草稿）

互动设置

设置	默认值	说明
allowComments	true	观众是否可以评论
allowDuet	false	观众是否可以创作合拍视频
allowStitch	false	观众是否可以进行 Stitch

商业内容设置

设置	默认值	说明
commercialContent	false	是否为商业内容？
brandOrganic	false	自然品牌推广
brandedContent	false	付费合作／赞助内容

**注意：**如果 commercialContent 为 true，则 brandOrganic 或 brandedContent 至少有一个也必须为 true。

注意：MCP 的 create_post 和 update_post 工具以及 REST API 均接受 platformSettings。该架构采用严格校验：拼错平台名或键名会导致校验错误，而不会被静默忽略。

关键限制

1. 未审核的应用只能发布私密视频

重要：如果你的 TikTok 应用尚未通过 TikTok 的审核流程，则只能发布私密视频（SELF_ONLY）。所有其他 viewerSetting 值都会被覆盖为 SELF_ONLY。

如需发布公开视频，你的应用必须通过 TikTok 审核。

2. 必须包含媒体：视频或图片轮播

TikTok 不支持纯文本帖子：每个帖子都必须包含媒体。

不过，TikTok 支持图片轮播：最多 35 张图片，格式为 JPEG、PNG 或 WebP，每张不超过 20 MB。一个帖子只能是图片轮播或单个视频，不能同时包含两者。

3. 最低帧率为 23 FPS

帧率低于 23 的视频会被 TikTok 拒绝。

示例

基本视频帖子

Post this video to TikTok:
"How we built our startup in 60 seconds #startup #tech #coding"

私密草稿（测试）

Upload this video as a private draft to TikTok (only I can see it):
"Testing new content format"

测试时请使用 viewerSetting: "SELF_ONLY"，之后再设为公开。

品牌内容

Post this sponsored video to TikTok with proper disclosure:
"Loving this new product from @brand! #ad #sponsored"

对于付费合作，请将 commercialContent: true 和 brandedContent: true 设为启用。

定时发布

Schedule this TikTok video for tomorrow at 6 PM:
"Weekend vibes incoming! #weekend #fun"

支持的视频格式

格式	推荐使用	备注
MP4	是	最可靠
MOV	是	Apple 格式
WebM	是	Web 格式
AVI	Publora 接受	TikTok 可能会拒绝
MKV	Publora 接受	TikTok 可能会拒绝

建议： 使用 MP4 以获得最佳兼容性。

最佳实践

内容

1. 前 3 秒抓住注意力：立即吸引观众
2. 最佳时长：15-60 秒可获得最佳互动效果
3. 热门音效：尽可能使用热门音频
4. 话题标签策略：使用 3-5 个相关话题标签

技术

1. 竖屏视频：9:16 的宽高比效果最佳
2. 高画质：分辨率至少为 720p
3. 23+ FPS：确保播放流畅
4. MP4 格式：最可靠的格式

发布时机

• 最佳时段：目标时区的上午 7-9 点、中午 12-3 点、晚上 7-11 点
• 发布频率：每天发布 1-3 条有助于增长
• 保持稳定：定期发布有助于算法推荐

故障排除

错误	原因	解决方案
unaudited_client_can_only_post_to_private_accounts	应用尚未获批	提交应用以接受 TikTok 审核，或使用 SELF_ONLY
spam_risk_too_many_posts	已达到每日上限	等待 24 小时
duration_check_failed	视频过长或过短	确保时长为 3 秒至 10 分钟
file_format_check_failed	视频格式不正确	使用 MP4、MOV 或 WebM
"23 FPS required"	帧率过低	将视频重新编码为 23+ FPS
"TikTok requires selecting who can view"	缺少 viewerSetting	始终在 platformSettings 中包含 viewerSetting