tiktok

TikTok

通过符合 TikTok 内容分享指南的互动发布表单，将内容端到端发布到 TikTok。

不在本技能范围内 — 请转交给其他技能

请求	转交给
TikTok 广告活动、Spark Ads、付费推广	tiktok-ads
Instagram 帖子 / Reel / 限时动态	instagram
LinkedIn 文档或轮播帖子	linkedin

要求

• 已安装并连接 Hyper MCP。 https://app.hyperfx.ai/mcp
• 已连接 TikTok 集成，地址为 https://app.hyperfx.ai/apps — 本技能使用 TikTok Login Kit / Content Posting API（而非 TikTok Marketing API）。

如果 search("tiktok_post_form_open") 未找到 tiktok_post_form_open，请停止并告知用户启用 Hyper MCP 并连接 TikTok。

如何运行本技能中的工具

本技能中的每个工具都以其规范工具名称命名。使用你所用界面提供的调用方式运行：

界面	查找工具	运行工具
MCP 客户端（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")，然后运行 describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"，然后运行 hyperai describe <name>	hyperai call <name> --json '{...}'

如果找不到某个工具，说明其集成尚未连接或未为工作区启用：请停止并告知用户需要连接哪个集成。

工具界面

工具	用途
tiktok_post_form_open	用户想要发布内容时唯一的入口。 打开合规表单。
tiktok_videos_send_from_url、tiktok_post_video_from_file、tiktok_photos_send	最终发布工具——仅在用户提交表单后调用。
tiktok_current_user_get	已认证的用户个人资料（无需表单）。
tiktok_creator_info_get	检查发布能力和限制。
tiktok_videos_list、tiktok_videos_query	浏览用户已发布的视频。
tiktok_posts_status_get	检查先前提交的帖子的状态。
tiktok_videos_upload_from_url、tiktok_videos_upload_from_file、tiktok_photos_upload	将内容发送到收件箱，作为草稿保存（用户在 TikTok 应用中手动发布——有意绕过表单）。

关键规则

重要：用户想要在 TikTok 发布内容时，始终使用 tiktok_post_form_open。响应用户请求时，绝不可直接调用 tiktok_videos_send_from_url、tiktok_photos_send 或 tiktok_post_video_from_file。为符合 TikTok 规范，必须使用发布表单。

重要：打开表单前，不要询问用户关于隐私、政策、说明文字或品牌内容设置的问题。表单会通过交互流程处理所有这些事项。

重要：用户想要发布内容时，立即调用 tiktok_post_form_open。不要先收集信息。

用户想要发布内容时

如果用户说了以下任意内容：

• “把这段视频 / 照片发布到 TikTok”
• “把这个分享到 TikTok”
• “上传到 TikTok”
• “把这个发到我的 TikTok 上”

立即调用 tiktok_post_form_open：

tiktok_post_form_open(
    media_type="video",            # or "photo"
    media_url="<url>",             # single video / single photo URL
    media_urls=["<url>", ...]      # for photo carousels (max 35)
)

不要：

• 打开表单前询问隐私设置。
• 打开表单前询问说明文字 / 标题。
• 打开表单前询问政策确认事项。
• 索要任何元数据——只需打开表单。
• 直接调用 tiktok_videos_send_from_url 或 tiktok_photos_send。

表单处理的内容

交互式发布表单符合 TikTok 内容分享指南，可处理以下内容：

• 创作者身份展示（用户名、头像）。
• 媒体预览（视频播放器或照片网格）。
• 标题输入，并限制字符数（支持 #hashtags 和 @mentions）。
• 隐私级别选择（仅显示账号符合条件的选项）。
• 互动设置（评论、合拍、拼接）。
• AI 生成内容标记。
• 商业内容披露（品牌推广 / 促销）。
• 音乐使用确认。
• 品牌内容政策确认。
• 发布限制 / 封禁检测。
• 视频时长验证。

预填参数

调用 tiktok_post_form_open 时，请提供你已知的信息：

参数	适用情况
media_type	始终提供（"video" 或 "photo"）。
media_url	单个视频或单张照片。
media_urls	照片轮播（URL 列表，最多 35 个）。
video_duration_sec	若已知则提供，以启用时长验证。
title	用户提到标题时提供。
is_aigc	如果你生成了媒体（Veo、Seedance、图像生成等），则提供。

表单提交后

用户填写并提交表单后，你会收到一条包含其所有选定设置的消息。此时，调用相应的发布工具，并使用用户提交的准确参数：

• 通过 URL 发布视频：tiktok_videos_send_from_url
• 通过文件发布视频：tiktok_post_video_from_file
• 发布照片：tiktok_photos_send

发布工具会自动轮询状态并返回完成消息。

媒体格式要求

视频：

• 格式：推荐使用 MP4 + H.264。
• 分辨率：最低 720p，最高 4K。
• 宽高比：9:16、16:9 或 1:1。
• 时长：最低 3s；最长时长因账号而异（由表单检查）。

照片：

• 格式：仅支持 WebP 或 JPEG（不支持 PNG）。
• 分辨率：最高 1080p。
• 大小：每张照片最大 20MB。
• 轮播：最多 35 张照片。

域名验证：

• 所有媒体 URL 都必须来自 TikTok Developer Portal 中已验证的域名。
• 未验证的域名会导致身份验证错误。

示例流程

1. 用户：“将这个视频发布到 TikTok”。
2. 你：调用 tiktok_post_form_open(media_type="video", media_url="<url>")。
3. 发布表单会在 artifact 面板中打开。
4. 用户设置隐私、标题、政策等。
5. 用户点击“发布到 TikTok”。
6. 你会收到一条包含用户设置的消息。
7. 你：使用提交的参数调用 tiktok_videos_send_from_url(...)。
8. 工具会自动轮询并返回状态（已完成、失败或超时）。

收件箱 / 草稿路径（无需表单）

这些工具会有意绕过表单，将内容发送到用户的 TikTok 应用，以便手动发布：

• tiktok_videos_upload_from_url — 将视频作为草稿发送到收件箱。
• tiktok_videos_upload_from_file — 将文件作为草稿上传到收件箱。
• tiktok_photos_upload — 将照片发送到收件箱作为草稿。

仅当用户明确要求“发送到我的 TikTok 草稿”或“我想在应用中手动发布”时才使用这些工具。否则，默认使用表单路径。