TikTok Agent Skills

通过 Codex + KSS MCP，用自然语言完成 TikTok Shop 商品运营、公开账号增长研究、内容驱动的私域获客和 TikTok 付费广告运营，并把可追溯的数据证据转成行动方案。

作者：X / Twitter @aronhouyu

这个项目把 TikTok 运营中反复进行的数据查询、账号诊断和策略规划，整理成可被 Agent 直接执行的 Skills。你不需要记住 MCP 工具名和参数，只需要描述业务目标；Agent 会选择合适的 Skill、组织查询、标记数据限制并给出下一步建议。

四条完整运营闭环

商品运营：选品 → 店铺 → 视频 → 达人 → 字幕 → 行动方案
账号增长：账号链接 → 账号诊断 → 类目研究 → 差距匹配 → 30 天计划
内容获客：业务简报 → 从零建号或账号诊断 → 内容实验 → 单一 CTA → 私域承接 → 线索复盘
付费广告：账户审计 → 投放方案 → 参数与归因核验 → 变更预览 → 批准执行 → 效果优化

四条闭环可以独立使用。增长计划可以串联公开账号诊断与类目研究；商品运营服务 TikTok Shop 站内商品销售，内容获客则服务咨询、预约、表单提交或进入指定私域渠道等线索目标；付费广告闭环服务广告账户审计、投放规划和经批准的账户变更。Shop 交易、公开自然增长、私域线索和付费广告路径始终分别规划、分别测量。

例如，当你提供一个商品或选品方向后，Agent 可以：

1. 筛选符合地区、价格、评分、销量和增长率要求的商品。
2. 补充店铺规模、评分、销售表现和服务指标。
3. 查找关联的带货视频，并按销量或销售额排序。
4. 从视频中识别达人，进一步分析粉丝、播放、互动和带货能力。
5. 提取重点视频字幕，拆解开头钩子、卖点、证明方式和 CTA。
6. 汇总数据证据，形成选品、内容和达人合作行动方案。

Skill 目录

tiktok-shop-operator

面向 TikTok Shop 卖家、运营人员和内容团队，覆盖商品趋势与选品研究、店铺和竞品分析、爆款带货视频发现、达人匹配、字幕提取，以及商品、店铺、视频和达人的关联分析。

它不会自行购买套餐、联系达人或发布内容。它负责研究、分析、生成建议和执行方案，真实的外部动作仍需要用户单独确认。

tiktok-lead-generation-operator

面向以内容获客而非 TikTok Shop 成交为主要目标的团队。它先依次确认目标市场、产品或服务、目标客户、期望私域动作及渠道，再选择从零模式或复用公开账号诊断，设计内容、单一 CTA、渠道承接、资格判断、跟进草稿和可追溯漏斗。

它支持 TikTok 私信、WhatsApp、微信、Telegram、email、表单和预约链接，但只交付规划与可审核草稿，不抓取联系人、不自动外联，也不改动外部账号。若同时存在 Shop 销售和线索目标，两个路径会保持独立，并在影响取舍时先确认主要业务结果。

tiktok-ads-operator

面向 TikTok 付费广告账户。它以 provider-neutral 的方式完成账户审计、新 Campaign 规划、既有账户优化，以及经明确批准后的执行；会先检查当前可用工具、权限和实时 schema，不会假定某个广告 API、字段、枚举或限额存在。

它会把 Paid、Organic、Shop GMV、App 和私域线索的事件、币种、统计窗口与归因口径分开。没有兼容的写入能力时，交付可核验的参数草案或 Ads Manager 手工清单；写入前必须给出完整变更预览，Campaign、Ad Group 和 Ad 默认以暂停/禁用状态创建，启用投放、增加预算、删除、上传客户数据或创建受众均需再次明确批准。

数据来源、层级与限制

简单来说：

MCP 给 Agent 数据和工具，Skill 给 Agent TikTok Shop 的运营方法。

账号和类目相关 Skills 采用以下数据层级：

1. MCP 优先。 先读取已连接 KSS MCP 的实时 schema，并使用其实际提供的工具和字段；实时 schema 始终优先于仓库参考。
2. 浏览器降级。 当账号 MCP 工具不可用、失败、为空或关键字段不足时，只读取浏览器中可见的公开 TikTok 主页和视频页。遇到登录、验证码、反爬、地域或访问限制即停止，并记录原因。
3. 公开数据边界。 只分析公开可访问的信息，不绕过访问控制，也不把搜索摘要、记忆或缺失字段当作已获取的 TikTok 数据。

creator_profile 和 creator_videos 不是仓库承诺一定可用的固定接口：它们是否实际可调用、有哪些参数和返回字段，取决于当前连接的 KSS MCP schema。Agent 会先检查可用性；不可用时按上述规则降级或明确报告限制，不会猜测工具 schema。

上述账号和类目分析结果会按证据完整性标注 A/B/C 可信度：A 表示关键结论有完整、可比且可追溯的多层证据；B 表示证据可用但存在披露的覆盖或字段限制；C 表示只能给出范围有限的初步观察或部分报告。缺少会改变账号类型、进入判断、定位或首要行动的信息时，Agent 会在完成允许的重试、分页和公开浏览器降级后，一次只问一个最关键的问题，并说明该缺失会影响什么。

没有 MCP，商品和店铺 Skills 无法获得真实的 KSS 数据；没有 Skill，Agent 仍可调用 MCP，但复杂任务的流程、排序、核验、数据完整性和输出稳定性会下降。

核心能力

商品选品

按地区、类目、关键词、价格、评分、销量、销售额、增长率和上架时间筛选商品。

店铺分析

查询店铺评分、商品数、平均价格、近 30 天销量和销售额、达人数量、视频数量以及服务指标。

爆款视频

按商品、店铺、关键词、发布时间、播放量、互动率、销量和销售额查找带货视频。

达人匹配

按地区、粉丝数、平均播放、互动率、增长率、带货类目、销量和 GPM 筛选达人，并通过 ID 交叉确认关联关系。

字幕与内容拆解

提取指定 TikTok 视频字幕，分析开头钩子、核心卖点、证明与演示、异议处理和 CTA。

数据完整性

自动处理分页、去重、统计周期、币种和缺失字段。查询被额度或限流中断时，明确标记为“非完整结果”，不会把第一页称为全部结果。

付费广告审计与执行

审计 Campaign、Ad Group、Ad、创意、身份、Pixel、Events API、App Event、Shop 归因和报表；围绕 Web、App、Lead、Reach、Video、Shop Ads 与 GMV Max 分别规划和优化。所有可能改变外部状态的动作先停留在可审核预览，只有与该批次完全一致的明确批准后才会执行。

可以直接执行的任务

安装并连接 KSS MCP 后，可以直接向 Codex 提问：

使用 $tiktok-shop-operator 查找美国区评分 4.5 以上、价格 30–50 美元、近 7 天销量增长较快的美妆商品，并按销售额降序输出。

使用 $tiktok-shop-operator 查找美国区评分 4.5 以上、近 30 天销量较高的美妆店铺，并给出店铺地址。

使用 $tiktok-shop-operator 分析 PolyLemon 自动磁力搅拌杯的带货视频和达人，按销售额排序，并筛选值得合作的达人。

使用 $tiktok-shop-operator 提取这个 TikTok 视频的字幕，分析开头钩子、卖点、演示方式和 CTA。

使用 $tiktok-shop-operator 从选品开始，完成店铺、爆款视频、达人和字幕分析，最后生成一份 TikTok Shop 运营行动方案。

账号与增长：可直接复制

分析这个公开 TikTok 竞争对手账号，找出它的内容支柱、爆款公式和未来 7 天可以改进的动作：

研究美国区宠物用品类目，分析商品、店铺、爆款视频和达人，并生成 30 天运营方案。

分析这个账号是否适合做美国区家居类目，并生成从定位到选品、内容和达人合作的 30 天计划：

第二个示例会触发 $tiktok-category-strategy；第三个示例会触发 $tiktok-growth-plan。增长计划还需要明确商业目标；如果示例中尚未说明，Agent 会先只追问这一项。

内容获客：可直接复制

从零搭建：

使用 $tiktok-lead-generation-operator 从零设计一个美国 TikTok 内容获客账号：服务是 Shopify 运营咨询，目标客户是年销售额 50–500 万美元的 DTC 品牌创始人，期望客户通过主页 Calendly 链接预约诊断。请给出主页架构、内容实验、单一 CTA、资格判断、承接草稿和 30 天测量计划。

改造现有账号：

使用 $tiktok-lead-generation-operator 改造这个公开 TikTok 账号：。目标市场是新加坡，服务是企业 AI 培训，目标客户是 100–500 人公司的运营负责人，期望客户填写主页表单申请咨询。请复用公开账号诊断，区分公开证据与私域数据缺口，并设计内容、CTA、线索承接和 KPI。

当任务实际执行数据查询时，Agent 会在结果中说明查询地区、统计周期、筛选条件、排序方式、分页范围、结果数量和完整性。

付费广告：可直接复制

账户审计：

使用 $tiktok-ads-operator 审计这个 TikTok Ads 账户近 30 天的 Campaign、Ad Group、Ad、Pixel 和归因健康度。请先读取当前可用能力与报表 schema；把事实、分析、缺口和下一步分开，并不要改动账户。

投放规划：

使用 $tiktok-ads-operator 规划美国区美元账户的 Web Conversion 投放：推广 Shopify 运营咨询落地页，目标是已验证的 Purchase 事件，日预算 100 美元，Broad 受众，已有三个视频创意。请核验实时 schema 后给出 Campaign、Ad Group、Ad、归因、测量和 Ads Manager 执行清单；没有写入批准前不要创建任何对象。

已批准执行前的预览：

使用 $tiktok-ads-operator：我已确认美国区、美元账户、Web Conversion、日预算 100 美元、Pixel Purchase 事件、Broad 受众和三个视频；当前工具 schema 支持创建 Campaign、Ad Group 和 Ad。先给出这一个批次的写入预览，包括目标账户、层级、字段、预算、排期、归因、创意、暂停状态和回滚路径。未经我对该预览明确批准，不要创建或启用。

快速开始

1. 安装 Skill

克隆仓库：

git clone https://github.com/aronhy/tiktok-agent-skills.git
cd tiktok-agent-skills

复制全部六个 Skill 到 Codex Skills 目录：

mkdir -p ~/.codex/skills
cp -R skills/tiktok-shop-operator skills/tiktok-account-audit skills/tiktok-category-strategy skills/tiktok-growth-plan skills/tiktok-lead-generation-operator skills/tiktok-ads-operator ~/.codex/skills/

如果只需要内容获客能力（同时支持从零和已有账号模式），请一并安装内容获客 Skill 及其用于已有账号公开证据诊断的 tiktok-account-audit：

mkdir -p ~/.codex/skills
cp -R skills/tiktok-lead-generation-operator skills/tiktok-account-audit ~/.codex/skills/

如果只需要 TikTok 付费广告审计、规划、优化和经批准执行能力：

mkdir -p ~/.codex/skills
cp -R skills/tiktok-ads-operator ~/.codex/skills/

重新启动或刷新 Codex，使 Skill 被发现。

2. 配置 KSS MCP

复制 mcp.example.json 中的配置到本地 MCP 配置文件。

示例中的 ${KSS_MCP_KEY} 是占位符。请只在本地副本中替换为管理员发放的真实 MCP Key，不要修改并提交仓库中的示例文件。

认证 Header 名必须是 secret-key。

注意：KSS MCP Key 与普通 API Key 是不同凭证，不能混用。

3. 开始使用

显式调用 Skill：

使用 $tiktok-shop-operator 分析美国 TikTok Shop 最近增长较快的美妆商品。

也可以直接描述完整业务目标，Agent 会自动判断需要调用哪些工具和工作流。

项目文件

安全与额度

• 不要把真实 MCP Key 写入 README、Skill、示例或 Git 提交。
• 不要提交 mcp.local.json、.env、客户数据或本地查询结果。
• 真实查询会消耗用户自己的 KSS MCP 套餐额度。
• 收到 ERROR_API_MINUTE_MAX 或 ERROR_API_MONTH_MAX 时，Agent 会停止继续调用并说明已完成和未完成部分。
• MCP 没有返回的字段统一标记为“未提供”，不推测或补造。
• MCP 未连接或返回 401 时，Agent 会明确报告，不使用普通网络搜索冒充 KSS 数据。
• Skill 只提供研究、草稿和行动建议，不自动联系达人、购买额度或发布 TikTok 内容。
• TikTok Ads 的真实写入会产生广告花费；必须先显示完整变更预览并取得与该批次一致的明确批准。启用投放、增加预算、删除、上传客户数据或创建受众还需要再次明确批准。

License

本项目使用 MIT License。

TikTok Ads Operator 的工具覆盖与目标参数关系参考了 HyperFX 的 hyperfx-ai/marketing-skills 在提交 8b5012e4811ad04def471076c4fa378251cb8e86 的 MIT 许可研究材料；本仓库已按本项目结构和安全边界改写，完整上游许可证见来源说明。