核心用法
TikTok Publisher 是一款面向内容创作者和营销团队的自动化发布工具，通过 MyBrandMetrics 中间层 API 封装 TikTok 官方接口，实现视频上传、发布、状态监控和定时任务管理。
主要功能模块：
1. 即时发布：支持本地视频文件（multipart 上传）和远程 HTTPS 视频 URL 两种来源，可设置标题、隐私级别（SELF_ONLY/PUBLIC）
2. 状态轮询：通过 publish_id 实时查询发布进度，支持自定义轮询间隔和超时时间
3. 定时任务：基于 Google Sheets 数据创建一次性定时发布任务，适合批量内容排期
4. 对话式交互：安装后支持自然语言指令直接触发发布流程
使用流程：用户需在 MyBrandMetrics 平台用 Google 账号登录 → 连接 TikTok 数据源完成授权 → 获取 API Key 配置到本地 config.json → 即可通过 CLI 或对话方式调用。
显著优点
- 零开发者账户成本：无需申请 TikTok Developer App，规避 client ID/secret 管理和 token 刷新逻辑
- 简化认证链：单点 Google OAuth 替代复杂的 TikTok OAuth 2.0 流程，降低接入门槛
- 灵活部署：支持纯远程 URL 场景（无需本地存储），也支持本地大文件直传
- 自动化就绪：内置轮询机制和错误重试，适合 CI/CD 内容管道集成
- 批量调度能力：Google Sheets 驱动的一次性任务，满足营销日历批量排期需求
潜在局限
- 中间层依赖：核心功能绑定 MyBrandMetrics 服务可用性，存在供应商锁定风险
- 功能边界：当前仅支持视频发布，TikTok 原生草稿箱、合拍、直播等功能未覆盖
- 图片轮播限制：需手动处理 1080x1920 尺寸规范，大尺寸生成图可能触发审核失败
- 定时任务一次性：不支持周期性循环任务，需人工维护 Sheets 数据
- 地域合规：MyBrandMetrics 服务的数据驻留和 TikTok 区域策略可能影响跨国内容发布
适合人群
- 中小品牌社媒运营团队：需快速上线 TikTok 内容管道，无专职 API 开发资源
- 内容自动化从业者：希望将 TikTok 发布集成到现有工作流（如 RSS→视频→发布）
- 多账号管理者：通过单一 MyBrandMetrics 面板切换不同 TikTok 数据源
- 测试/预演场景：利用 SELF_ONLY 隐私级别进行内容预审核
常规风险
| 风险类别 | 具体表现 | 缓释建议 |
|---------|---------|---------|
| 认证安全 | API Key 以明文存储于本地 `config.json` | 限制文件权限 600，避免提交至版本控制 |
| 中间人攻击 | 远程 URL 下载环节缺乏完整性校验 | 优先使用 HTTPS + 可信 CDN，验证文件哈希 |
| 内容合规 | 自动化发布可能绕过人工审核，触发平台处罚 | 强制 SELF_ONLY 预发布流程，建立人工抽检机制 |
| 数据隐私 | Google Sheets 共享范围过宽导致内容泄露 | 严格限定 Sheets 访问权限至服务账号，定期审计共享列表 |
| 服务中断 | MyBrandMetrics API 变更或下线导致功能失效 | 关注官方变更日志，保留原生 TikTok API 降级方案 |
技术备注
CLI 工具基于 Python 3 实现，核心入口为 scripts/publish_tiktok.py 和 scripts/check_status.py。错误码映射已覆盖常见 TikTok 审核失败场景（时长、尺寸、参数格式），便于快速定位问题。