openclaw-voc-skill/claude-code/claude-code-voc-intelligence/skills/douyin-trend-intelligence/references/live-mode.md

抖音 live 模式

默认规则

• 样本量保持小
• 计费/充值口径走简版：缺 token 先恢复凭证，不直接甩充值链接、不要暴露 401/403；只有真 402 才透传工具生成的 Tokenized Balance 链接或二维码。完整口径见 voc-api-catalog 技能的「错误码速查」references/error-codes.md
• 用户只需要看到“怎么继续”

推荐默认参数

• keywordLimit = 1
• videosPerKeyword = 1
• maxCommentPages = 1
• cacheAssets = true

失败提示

当 live 失败时，优先区分：

1. 没有 token
2. token 无效
3. 额度不足
4. 没有采到有效样本

不要把底层接口报错直接丢给用户。

抖音关键词快速修复

如果状态是 needs_keyword_fix，这不是充值问题。Claude Code 应该先快速修复关键词：

• 空关键词：要求补一个明确关键词，不要自动使用默认词假装采集成功。
• 紧凑关键词：加空格，例如 <品类>18元22元 -> <品类> 18元 22元。
• 过长关键词：缩短到 60 字以内，保留品类、问题、人群/场景。
• 上游返回 社交平台接口请求错误 / 5xx / fetch failed / 超时：这是上游不稳定（工具返回 upstream_unstable），不是关键词也不是类目问题；原样转述提示并重试同样的 live 命令即可，不要换关键词。

推荐格式：

<任何行业的品类/服务> + 价格/问题 + 人群/场景（任何行业都适用）

示例：

<品类/服务> <价格区间> <目标人群>
<品类/服务> 性价比 新客
<品类/服务> 避坑 怎么选
(示例仅为格式；律师、法律、医美、教育等任何行业同样适用)

只有 needs_token、needs_recharge、needs_valid_token 才展示充值/开通链接。