品牌维价（价格监控）技能

功能概述

电商品牌维价（价格维护）的完整工作流。监控各平台商品价格是否低于品牌设定底线，自动检测异常、生成报告并提供处理建议。

适用场景：品牌方运营人员日常监控授权店铺/非授权店铺价格合规性。

一、前置条件

必备工具

• 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家）

1. 鱼跃康复护理旗舰店
2. 鱼跃亦乐专卖店
3. 鱼跃保健品旗舰店
4. 鱼跃氧康专卖店
5. 鱼跃苏州专卖店

平台自营/渠道（3家）

1. 阿里健康大药房
2. 天猫超市
3. 百亿补贴品牌优选

> 搜索方式："店铺名 + 产品型号"，如 "鱼跃官方旗舰店 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 价格阈值示例（鱼跃品牌）

五、运行监控脚本

# 手动执行
python 价格监控脚本.py

# 脚本自动完成：
# 1. 加载YAML配置
# 2. 尝试maishou API获取真实价格（失败回退模拟数据）
# 3. 比较当前价 vs 阈值
# 4. 检测3类异常（低于阈值/大幅降价/价差过大）
# 5. 记录价格历史到CSV
# 6. 生成Markdown报告

脚本核心类 PriceMonitor

六、报告生成规范

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