publora/tiktok-post

TikTok 发帖

使用 Publora MCP 服务器将视频上传并计划发布到 TikTok。支持隐私控制、互动设置（评论、合拍、拼接）和商业内容披露。

前提条件

套餐： 免费 Starter 套餐即可使用。当前限制和定价请访问 publora.com/pricing。

快速开始

1. 在 publora.com/register 创建账号（免费）
2. 在 Publora 仪表盘 通过 OAuth 连接 TikTok
3. 在 app.publora.com/dashboard/api 获取 API 密钥
4. 将你的 AI 代理连接到 MCP 服务器，地址为 https://mcp.publora.com，使用 Authorization: Bearer sk_YOUR_API_KEY 进行认证。在 Claude Code 中：

claude mcp add publora --transport http https://mcp.publora.com \
  --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）：

# 获取已连接的平台
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# 创建帖子
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": "视频描述文字在这里 #话题标签",
    "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 vs 原生应用）

与 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 日期时间。可选：省略则帖子以草稿形式创建。传入未来时间可安排发布。如果时间早于当前时间五分钟或以上，将返回 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	观众是否可以拼接视频

商业内容设置

设置	默认值	描述
commercialContent	false	是否为商业内容？
brandOrganic	false	有机品牌推广
brandedContent	false	付费合作/赞助

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

注意：platformSettings 可通过 MCP 的 create_post 和 update_post 工具以及 REST API 接收。该模式 是严格的：拼写错误的平台或键将被拒绝并返回验证错误，而不会静默丢弃。

关键限制

1. 未审核应用 = 仅限私密

关键： 如果你的 TikTok 应用尚未通过 TikTok 的审核流程，你 只能发布仅自己可见的私密视频（SELF_ONLY）。所有其他 viewerSetting 值将被覆盖为 SELF_ONLY。

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

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

TikTok 不支持纯文本帖子：每个帖子都需要媒体。

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

3. 最低 23 FPS

低于 23 帧每秒的视频将被 TikTok 拒绝。

示例

基本视频帖子

将此视频发布到 TikTok：
"我们如何在 60 秒内建立了我们的创业公司 #创业 #科技 #编程"

私密草稿（测试）

将此视频作为私密草稿上传到 TikTok（仅我可见）：
"测试新内容形式"

在公开发布前，使用 viewerSetting: "SELF_ONLY" 进行测试。

品牌内容

将此赞助视频发布到 TikTok，并附带适当的披露信息：
"喜欢 @brand 的这个新产品！#广告 #赞助"

对于付费合作，设置 commercialContent: true 和 brandedContent: true。

计划发布

将此 TikTok 视频安排在明天下午 6 点发布：
"周末氛围来袭！#周末 #快乐"

支持的视频格式

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

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

最佳实践

内容

1. 前三秒抓住眼球：立即吸引注意力
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