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

live 模式接入说明

原则

P0 阶段先用 sample 模式跑通流程。

当用户明确要真实采集时，再切 live 模式。

采集默认值

live 模式默认保持小规模：

• keywordLimit = 1
• notesPerKeyword = 1
• maxCommentPages = 1

这样可以先验证流程，不会一上来就把运行成本拉高。

token 处理

请求入参仍然保持简单：

• xiaohongshuToken
• vocToken

系统也会尝试从本机环境读取 token。

如果没有 token，或者余额不足，不要直接把底层报错甩给用户，应该返回：

• 充值链接
• 下一步操作

不要把 403、授权失败文案、原始响应体直接暴露给用户。

可访问链接

小红书原帖链接优先使用：

1. mini_program_info.webpage_url
2. share_info.link

保留 xsec_token，否则网页端可能打不开。

充值入口

常见充值入口示例：

https://app.fmode.cn/dev/apig-pay/#/workshop
https://app.fmode.cn/dev/apig-pay/#/workshop/19-9
https://app.fmode.cn/dev/apig-pay/#/workshop/99
https://app.fmode.cn/dev/apig-pay/#/workshop/299
https://app.fmode.cn/dev/apig-pay/#/workshop/699

如果只是 VOC 数据服务余额，也可以用：

https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF

结论

live 模式不是为了替代 sample，而是为了在 sample 已经校准过后，接上真实数据继续迭代。