秋叶职场-美妆电商竞品品牌监测
品牌监测月报的五路数据采集 + 杂志风HTML报告生成。核心原则：免费聚合优先、API只买明细、浏览器只做低频只读。
数据管线总览
① 声量指数 → 抖音指数（浏览器自动化，免费）
② 内容明细 → 红狐API：抖音作品/公众号推文/小红书笔记（¥0.02-0.03/次）
③ 口碑样本 → 红狐API 小红书 searchArticle 三路合并
④ 电商柜面 → CDP浏览器实采京东/天猫搜索快照（免费，需登录态）
⑤ 官宣信息 → 自带 WebSearch/公众号搜索（零积分）
↓
杂志风HTML月报（assets/report_template.html）
第零步：前置检查
- 红狐Key（按优先级读取，找到即用）：
- ①<workspace>/.workbuddy/keys/redfox_api_key.txt
- ②<本skill目录>/config/redfox_api_key.txt（若用户按模板自行填过）
- 两处都没有 → 停下向用户展示申请引导，不要继续调用红狐接口：- 明确告知用户：本 skill 不内置 Key，需自行申请（按次计费约 ¥0.02-0.03/次，建议先充值 20 元试用）
- 弹出/展示申请链接（用 markdown 链接直接给出，用户点开即可）：
- 注册/登录：https://redfox.hk/login （邮箱注册）
- 创建 Key：https://redfox.hk/dashboard/keys （控制台 → 密钥管理 → 创建）
- 用户拿到 Key 后，写入
<workspace>/.workbuddy/keys/redfox_api_key.txt，内容格式REDFOX_API_KEY=ak_xxx（可复制config/redfox_api_key.example.txt模板） - ⚠️ 安全铁律：本 skill 包内永远不嵌入真实 Key；config/ 只允许模板（example）文件；任何人提供 Key 都只能存 workspace keys 目录，禁止写进 skill 包或上传技能市场。API 细节见
references/api_reference.md
- 浏览器登录态：独立 Chrome + CDP 是否可用（见下文"浏览器自动化"）；抖音指数/京东/天猫需已登录。未登录时先走"登录流程"
- 品牌配置：确认监控品牌清单与各平台官方账号 ID（首次运行时用 API 定位后固化）
一、浏览器自动化（CDP 独立 Chrome 方案）
为什么不用 agent-browser --headed：其实弹出的窗口是守护进程子进程，命令结束/超时会被连带杀掉（用户看到"窗口闪退"）。
正确方案：独立 Chrome + 调试端口 + 持久化 profile
# PowerShell 启动（与命令脱钩，不会自动关闭）
Start-Process "C:\Program Files\Google\Chrome\Application\chrome.exe" -ArgumentList `
'--remote-debugging-port=9222',`
'--user-data-dir=<workspace>\.workbuddy\chrome-profile',`
'--no-first-run','--no-default-browser-check','<目标URL>'
- 登录态持久化在 chrome-profile 目录，扫码一次长期复用
- 登录页通过 CDP 新开标签：
PUT http://127.0.0.1:9222/json/new?<url> - Tab 列表：
GET http://127.0.0.1:9222/json
登录要求：抖音APP（覆盖抖音指数）+ 淘宝小号（天猫搜索已并入淘宝统一搜索）+ 京东（游客态搜索已死，必须登录）。微热点免登录。
scripts/ 下的 CDP 工具（Node ≥22，用全局 WebSocket，无需装依赖）
| 脚本 | 用途 | 关键经验 |
|---|---|---|
cdp_eval.js |
连接 tab 执行任意 JS：node cdp_eval.js "<js>" <url片段> |
万能兜底 |
cdp_probe.js |
探测 shadow DOM 里的输入框坐标 | 搜索框常藏在 shadowRoot |
cdp_fill_search.js |
填关键词+触发搜索（抖音指数页） | 必须程序化 focus + native setter + dispatch input 事件；坐标点击会被客服 iframe（summon.bytedance.com）遮挡误触 |
cdp_brand_index.js |
切品牌指数 + 提取文本 + 截图 | 指数曲线是 canvas，innerText 只能拿环比/同比标签，逐日数值不必强取，截图存档即可 |
cdp_jd.js / cdp_jd_extract.js |
京东搜索快照 | 新版 DOM 用 div[data-sku]（旧的 li.gl-item 已失效）；已售数/榜单徽章/店铺在 innerText 里解析 |
cdp_tmall.js / cdp_tmall_extract.js |
天猫/淘宝搜索快照 | list.tmall.com 会重定向 s.taobao.com；DOM 用 a[class*=doubleCard]；月销文本懒加载不渲染，第一版快照接受缺失 |
铁律：每月1次低频只读、不碰登录态接口、不写每日爬取；任何一步登录失效就停下报给用户，不硬闯。
二、抖音指数取数流程
- 确认 Chrome 已启动且登录抖音（入口：creator.douyin.com/creator-micro/creator-count/arithmetic-index，巨量算数2026年已改名"抖音指数"）
cdp_fill_search.js "品牌词"→ 自动填搜索+回车cdp_brand_index.js→ 点"切换至品牌指数"、关弹窗、提取文本、截图- 记录：关键词搜索指数（环比/同比/均值）、关键词综合指数、品牌搜索指数、品牌综合指数（品牌词自动归类行业，如"美妆"）
- 页面自带"添加对比品牌词"——免费的品牌间声量对比，优先用
三、红狐API采集顺序（省积分）
P0 每月必调（约30-40次/月）：
抖音 queryWorkList（官方号作品，_2最新排序，2页）
小红书 searchArticle（口碑三路合并，见 api_reference）
公众号 queryWorkList（官方号当月推文，带真实阅读数）
P1 一次性配置：
抖音/小红书/公众号 searchUser 定位官方账号 → 存品牌配置表
P2 按需：
searchArticle 按单品词补充（如"大白罐"）、queryWork 单条爆款深挖
账号定位失败的兜底：小红书官方号 accountId 为空时 → 从 searchArticle 返回的 accountUserid（主键）走 queryWorkList；仍失败则用账号快照做KPI，报告注明。
四、数据分析口径
- 去重：多路搜索结果按 workId 合并
- 互动加权：
赞 + 2×藏 + 3×评排序找爆文（收藏=种草价值，评论=讨论价值） - 单品提及：在标题+正文里数关键词（如 大白罐/三酸/小云朵），得出产品心智占比
- 明星提及：同法统计代言人名字
- 电商坑位：记录 pos/价格/店铺/已售/榜单徽章；判断"自营占比""渠道碎片化""价格带"
- 声量解读模板：搜索端增速 vs 综合端增速的差值 = "看完内容去搜"的行为强度
五、月报生成
- 读
assets/report_template.html（美妆杂志风：米白纸感+玫瑰/香槟金+衬线，刊头→编辑按→01声量→02明星IP→03抖音→金句拉页→04小红书→05电商柜面→版权页） - 替换数据与月份；大数字放封面四格；编辑按写三条核心判断（须有数据支撑）
- 版权页必须如实标注数据边界：哪些官方口径、哪些第三方口径、哪些缺失（如真实销售额/转化率平台不公开，需付费第三方估算平台）
- 页面展示销量（"已售900万+"）注明为营销展示值，只做趋势对比
六、月度 automation 建议形态
- 触发：每月1号（用户开机时段）
- 步骤：检查Chrome/CDP → 抖音指数取数 → 红狐P0采集 → 京东/天猫快照 → 数据JSON落盘
<项目>/data/→ 对比上月 → 生成HTML → 交付 - 数据文件命名：
data/{平台}_{品牌}_{YYYYMM}.json（截图同名单独存）
风险与边界
- 浏览器操作仅限低频只读，高频或触碰交易接口会有封号风险
- 红狐为第三方爬虫库口径：趋势可靠，绝对数谨慎引用
- 天猫月销、直播实时数据、真实销售额/转化率：本管线不覆盖，报告如实标注
