秋叶职场-UGC内容监控及生成
> 红狐 API 驱动的竞品社媒采集 → 爆款框架提炼 → UGC 文案生成 全流程技能。
> 用户需自行注册红狐（redfox.hk）并申请 API Key。
适用场景
用户说"采集某竞品/品牌的小红书数据""提炼爆款框架""生成UGC种草文案""竞品内容监测"等，且数据来源限定红狐 API 时，使用本技能。
流程总览（四阶段，每阶段需用户确认后才进入下一阶段）
Stage 0 Key检查 → Stage 1 采集+笔记明细Excel →【用户确认】
→ Stage 2 爆款框架提炼HTML →【用户确认】
→ Stage 3 邀请用户填入产品信息 → UGC文案+封面参考图+Excel
铁律：绝不跳过确认门。 每阶段交付物 present 给用户，明确说"确认无误请回复，我进入下一阶段"。
Stage 0：Key 检查
- 按顺序查找 Key：① 本技能
config/redfox_api_key.txt②<工作目录>/.workbuddy/keys/redfox_api_key.txt。均为空或含"请填入"字样 → 引导用户：
- 访问 https://redfox.hk 注册账号并申请 API Key（注册 https://redfox.hk/login → 创建Key https://redfox.hk/dashboard/keys，按次计费约 ¥0.02-0.03/次，建议先充 20 元）
- 将 Key 粘贴到上述任一位置（单独一行，支持KEY=xxx或裸 Key 格式）
- 提醒成本：单品牌全流程采集约 20-40 次调用，约 ¥0.5-1.2 - 安全铁律：包内/日志/回复中永不回显 Key 明文。
- Key 存在 → 继续。
Stage 1：自动采集 + 笔记明细
# 采集（品牌名必填，可选：YYYYMM、工作目录，默认当前目录）
node "<本技能>/scripts/collect.js" 丝芙兰 202609 "<工作目录>"
# 生成笔记明细 Excel（嵌入高清封面图）
python "<本技能>/scripts/build_excel.py" 丝芙兰 202609 "<工作目录>"
- 采集范围：小红书 UGC（三路合并去重）+ PGC 尝试、抖音官方号、公众号官方号，落盘
<工作目录>/data/{xhs,dy,gzh}_{品牌}_{YYYYMM}.json - Excel 四 sheet：小红书UGC笔记（按赞+2藏+3评降序，封面图嵌入）/ 公众号推文 / 账号快照 / 数据说明
- 数据边界必须如实标注在 Excel 数据说明 sheet 和回复里，已知边界见
references/api_reference.md - 采集完成 → present Excel → 停下等用户确认
Stage 2：爆款框架提炼
按 references/viral_framework.md 的方法论执行：
- 导出全部笔记标题+正文通读（互动加权排序）
- 用 Read 工具目检互动 Top 8-12 的封面原图，拆解视觉公式
- 产出 HTML 报告：《{品牌}爆款框架提炼_{YYYYMM}.html》，内含：标题公式（真实例证+互动数）、封面视觉模板（嵌原图+逐张标注）、正文结构、情绪触发词频、反面教材
- 所有结论必须来自真实数据通读/目检，禁止泛泛套方法论
- present HTML → 停下等用户确认
Stage 3：UGC 内容生成（需用户填入产品信息）
用户确认框架后，用以下固定清单邀请用户填入待推广产品的基本信息：
请提供待推广产品的基本信息：
1. 产品名称与规格
2. 核心卖点（2-4个，按优先级）
3. 可引用的功效数据（官方口径，无则留空）
4. 目标人群与场景
5. 话术禁区/合规边界（如"不得表述为医疗功效"）
6. 期望条数（默认12条）与发布平台（默认小红书）
收到信息后：
- 按框架逐条套用公式生成 UGC 文案，写入
<工作目录>/data/ugc_{品牌}_{YYYYMM}.json（schema 见 viral_framework.md） - 生成封面骨架参考图（每条一张，3:4 竖版）：
- 首选：内置 ImageGen 工具（APIMart 当前网络不可达，见 references/api_reference.md 网络坑）
- 可选：node "<本技能>/scripts/cover_gen.js" <品牌> <YYYYMM> <工作目录>（走 APIMart，支持断点续跑，需环境变量 APIMART_KEY）
- 图片统一命名cover_01.png ~ cover_NN.png，存<工作目录>/data/covers_ugc_{品牌}_{YYYYMM}/ - 生成文案库 Excel：
python "<本技能>/scripts/build_ugc_excel.py" <品牌> <YYYYMM> <工作目录> - 回复必须附合规提示：官方数据引用口径、医疗表述规避、敏感肌免责话术、"广告"标识义务
- present Excel + 封面图目录
已知坑（务必遵守，详见 references/api_reference.md）
- 小红书官方号 accountId 可能为空 → 用 searchArticle 返回的 accountUserid 走 queryWorkList；再失败用账号快照做 KPI 并注明
- 抖音优质库 3203"未收录" → 换广域库（参数是 userId 不是 accountId）；广域库仅收热门数据
- 公众号广域库是历史热门沉淀，不保证近 30 天 → 客户端按时间过滤并在 JSON 标注
_note - 封面图有防盗链：小红书带 Referer
https://www.xiaohongshu.com/，公众号带https://mp.weixin.qq.com/ - API 返回 data 可能为 null、list 含 None 条目 → 脚本已兜底，新增逻辑需同样处理
- 浏览器兜底路线（CDP）：登录失效就停下报给用户，不硬闯
- api.apimart.ai 从中国大陆网络通常不可达（DNS污染+IP封锁），生图默认走内置 ImageGen
