品牌维价（价格监控）技能
功能概述
电商品牌维价（价格维护）的完整工作流。监控各平台商品价格是否低于品牌设定底线，自动检测异常、生成报告并提供处理建议。
适用场景：品牌方运营人员日常监控授权店铺/非授权店铺价格合规性。
一、前置条件
必备工具
- maishou技能：用于跨平台商品搜索与价格获取（核心依赖）
- Python 3.8+：运行监控脚本
- YAML配置文件：管理监控商品和阈值
- WorkBuddy自动化：定时执行监控任务
文件清单
价格监控配置.yaml # 主配置文件
价格监控脚本.py # 核心监控脚本
价格监控数据/
├── history.csv # 价格历史记录
├── alerts.log # 警报日志
└── 价格监控报告/ # 每日维价报告
二、完整工作流程
配置商品 → 设置阈值 → maishou跨平台搜索 →
获取商品链接 → 检测价格 → 生成MD报告 →
记录历史 → 异常跟进处理
三、maishou跨平台搜索策略（核心）
3.1 基本搜索命令
# 跨全平台搜索（推荐先总搜）
cd ~/.workbuddy/skills/taobao
uv run scripts/main.py search --source=0 --keyword="鱼跃 YE670A"
# 按平台精搜
uv run scripts/main.py search --source=1 --keyword="鱼跃 YE670A" # 天猫
uv run scripts/main.py search --source=2 --keyword="鱼跃 YE670A" # 京东
uv run scripts/main.py search --source=3 --keyword="鱼跃 YE670A" # 拼多多
uv run scripts/main.py search --source=7 --keyword="鱼跃 YE670A" # 抖音
# 获取商品详情和购买链接
uv run scripts/main.py detail --source={source} --id="{goodsId}"
3.2 天猫店铺逐一搜索（重要！）
搜索天猫时必须逐一搜索以下11家店铺，不能遗漏任何一家：
品牌自营（3家）
1. 鱼跃官方旗舰店
2. 鱼跃健康之家旗舰店
3. 鱼跃健康监测旗舰店
授权专卖店（5家）
4. 鱼跃康复护理旗舰店
5. 鱼跃亦乐专卖店
6. 鱼跃保健品旗舰店
7. 鱼跃氧康专卖店
8. 鱼跃苏州专卖店
平台自营/渠道（3家）
9. 阿里健康大药房
10. 天猫超市
11. 百亿补贴品牌优选
> 搜索方式："店铺名 + 产品型号"，如 "鱼跃官方旗舰店 YE670A"
3.3 京东搜索
- 鱼跃京东自营旗舰店
- 其他鱼跃授权京东店铺
3.4 抖音搜索
- 鱼跃医疗旗舰店
- 亦乐专营店
- 注意：抖音链接为App深链接，无法直接在浏览器中打开跳转
3.5 拼多多搜索
- 鱼跃品牌店
- 鱼跃官方旗舰店
- 注意：百亿补贴频道容易出现低价
3.6 关键规则
| 规则 | 说明 |
|---|---|
| 跨平台全覆盖 | 不遗漏天猫、京东、抖音、拼多多任一平台 |
| 全店铺覆盖 | 不仅限于已知店铺，其他有目标商品的店铺也要查 |
| 逐店搜索 | 每家店铺逐一搜索，不可跳过 |
| 未找到注明 | 某店未找到产品时，报告明确写"该店铺未找到此产品" |
| 不可虚构 | 搜索不到就是搜不到，如实汇报，不要编造 |
四、价格配置管理
4.1 YAML配置模板
schedule:
daily: "09:00" # 日常监控时间
custom: "0 */6 * * *" # 大促期间加密监控
notifications:
- type: "workbuddy_message"
- type: "report_file"
format: "markdown"
location: "价格监控报告/"
- type: "excel_export"
products:
- name: "鱼跃YE670A血压计"
brand: "鱼跃"
category: "血压计"
model: "YE670A"
threshold_price: 110.00 # 价格底线（低于此值=高风险）
platforms:
- name: "天猫"
url: "https://商品链接"
store: "店铺名称"
expected_price: 114.00 # 正常预期价
- name: "京东"
url: "https://商品链接"
store: "鱼跃京东自营旗舰店"
expected_price: 119.00
- name: "拼多多"
url: "https://商品链接"
store: "店铺名称"
expected_price: 125.00
rules:
- name: "价格低于阈值"
condition: "current_price < threshold_price"
severity: "high" # 高风险，立即处理
- name: "大幅降价"
condition: "current_price < expected_price * 0.9"
severity: "medium" # 中风险，调查原因
- name: "平台价差过大"
condition: "max_price > min_price * 1.3"
severity: "low" # 低风险，市场分析
4.2 价格阈值示例（鱼跃品牌）
| 商品 | 阈值 | 说明 |
|---|---|---|
| 鱼跃YE670A血压计 | ¥110 | 基础款，拼多多曾低至¥92 |
| 鱼跃670CR血压计 | ¥140 | 升级款 |
| 鱼跃血糖仪921 | ¥150 | 含试纸套装 |
| 鱼跃隐形眼镜 | 建议¥89(30片) | 待正式设定 |
五、运行监控脚本
# 手动执行
python 价格监控脚本.py
# 脚本自动完成：
# 1. 加载YAML配置
# 2. 尝试maishou API获取真实价格（失败回退模拟数据）
# 3. 比较当前价 vs 阈值
# 4. 检测3类异常（低于阈值/大幅降价/价差过大）
# 5. 记录价格历史到CSV
# 6. 生成Markdown报告
脚本核心类 PriceMonitor
| 方法 | 功能 |
|---|---|
load_config() |
加载YAML配置 |
get_price_from_url(url, platform) |
获取价格（maishou优先，模拟回退） |
check_price_threshold(product) |
检查商品在各平台价格 |
detect_price_anomaly(...) |
检测价格异常 |
record_price_history(...) |
记录历史到CSV |
generate_report(alerts, time) |
生成MD报告 |
run_monitoring() |
执行完整监控流程 |
六、报告生成规范
6.1 报告文件名
价格监控报告_YYYYMMDD_HHMMSS.md # 日常监控报告
{产品名}_商品链接_YYYYMMDD.md # 查询商品链接的交付物
6.2 报告内容必须包含
- 检查时间和数据来源
- 异常商品列表（高风险/中风险/低风险分级）
- 商品详情页直达链接（可直接在浏览器打开）
- 当前价格 vs 阈值 vs 历史价格对比
- 紧急处理建议（按优先级排列）
- 持续监控的商品和价格变化趋势
6.3 报告示例格式
# 鱼跃品牌价格监控报告
## ⚠️ 高风险警报（价格低于阈值）
| 商品 | 平台 | 店铺 | 当前价 | 阈值 | 偏低幅度 | 链接 |
|------|------|------|--------|------|----------|------|
## 🔶 中风险警报（大幅降价）
## ✅ 正常价格明细
## 📈 历史对比
## 🚨 紧急处理建议
### 优先级一（立即处理）
### 优先级二（近期跟进）
### 优先级三（持续监控）
七、自动化任务配置
在WorkBuddy中设置定时自动化任务：
# 日常监控（推荐）
schedule:
daily: "09:00"
# 大促期间改为每6小时
# 自动化任务Triggers
- 每天9:00自动运行价格监控脚本.py
- 异常检测后自动生成报告
- 记录价格历史到CSV
> ⚠️ 已知问题：WorkBuddy重连后自动化任务可能需要重新激活。配置文件中的URL若为"待搜索"占位符，需要补全真实链接。
八、历史错误与解决方案
问题1：maishou搜索不全
现象：搜索天猫只找到11家/38家店铺
解决：必须按"店铺名+产品型号"逐一搜索，不能只用通用关键词
问题2：Playwright反爬虫拦截
现象：天猫/淘宝反爬虫机制强，截图验证仅完成3家即被拦截
解决：改用maishou+浏览器+API多渠道交叉验证，不用单一手段
问题3：CSV文件写入失败
现象：价格历史记录CSV文件找不到
解决：使用 os.makedirs 确保目录存在后再写入，配合 file_exists 判断表头
问题4：URL占位符
现象：配置中的URL为"待搜索"，脚本直接跳过
解决：搜索时先获取真实链接，填充后再运行监控
问题5：抖音链接不可跳转
现象：maishou返回的抖音链接是App深链接，无法在浏览器打开
解决：提供搜索关键词和商品ID作为替代方案
问题6：模拟价格不准确
现象：脚本回退到模拟价格时数据偏差大
解决：优先走maishou API；无API数据时标注"模拟数据仅供参考"
问题7：虚构内容（重要）
现象：搜索引擎没找到的商品AI编造了链接
解决：绝对禁止——搜不到就如实写"未找到"，不准编造
九、最佳实践
9.1 阈值设置建议
- 品牌底线价：参考公司定价政策
- 促销允许价：促销活动期间可适当放宽
- 渠道差异价：不同平台合理价差5%-15%
9.2 监控频率优化
- 日常：每天1次（上午9:00）
- 大促期间：每4-6小时（双11、618、百亿补贴活动）
- 新品上市：前2周加密监控
9.3 异常处理流程
发现异常 → 确认真实性 → 联系平台/店铺 →
跟踪处理 → 记录结果 → 优化阈值
9.4 数据记录
- 每次监控写入CSV历史记录
- 保留至少30天数据用于趋势分析
- 异常触发时立即生成警报日志
十、技能依赖
- maishou技能 — 跨平台搜索和比价
- Python — 运行监控脚本
- WorkBuddy Automation — 定时执行
- YAML — 配置文件管理
十一、交付物规范
- 查询商品链接后必须生成MD文件保存到工作区
- 文件名格式：
{产品名}_商品链接_YYYYMMDD.md - 报告必须包含完整的商品信息、价格对比、直达链接
版本: v2.1（完整版）
最后更新: 2026-05-13
适用品牌：鱼跃（Yuwell）及同类医疗器械品牌
数据来源：maishou 全网实时比价 + 平台API
