技能名称：global-price-comparison

详细描述：

全球价格对比

使用此技能运行全球同产品价格扫描，并输出以美元归一化的对比结果。

快速开始

bash

1) 创建初始CSV模板

python scripts/globalpricecompare.py template --out /tmp/offers.csv

2) （可选）按国家/来源类型发现候选链接

在可用时使用Brave和Tavily（BRAVEAPIKEY / TAVILYAPIKEY）

python scripts/globalpricecompare.py discover \ --product iPhone 16 Pro 256GB \ --countries US,JP,DE,UK \ --source-types officialstore,marketplace,electronicsretailer \ --engine all \ --out /tmp/discover.json

3) 用已验证的报价填充/tmp/offers.csv，然后进行对比

python scripts/globalpricecompare.py compare \ --input /tmp/offers.csv \ --format markdown

工作流程

1. 1. 定义精确的产品型号（型号/存储/规格）。
2. 运行discover获取按市场和来源类型划分的候选URL。
3. 将已验证的报价添加到CSV（product,country,currency,sourcetype,sourcename,price,url）。
4. 运行compare将所有价格归一化为美元，并排序最佳/最差。
5. 分享markdown/JSON/CSV格式的输出。

命令

模板

bash
python scripts/globalpricecompare.py template --out /tmp/offers.csv

发现候选链接

bash
python scripts/globalpricecompare.py discover \
--product PlayStation 5 Slim \
--countries US,JP,DE \
--source-types officialstore,marketplace,electronicsretailer \
--engine all \
--count 3 \
--format markdown

注意：

• - discover支持--engine brave|tavily|all（默认all）。
• 对于all，它优先使用Brave，仅在Brave失败或未返回结果时回退到Tavily。
• 根据需要设置一个或两个密钥：BRAVEAPIKEY、TAVILYAPIKEY。
• 来源类型有意保持通用（非特定本地商店）。

以美元对比报价

bash
python scripts/globalpricecompare.py compare \
--input /tmp/offers.csv \
--format markdown \
--out /tmp/comparison.csv

输出包括：

• - 按美元价格排序的报价
• 与最佳报价的差异
• 美元和百分比价差

默认设置

默认国家集合：

• - US, UK, JP, DE, FR, CA, AU, SG, HK, TW

默认来源类型：

• - officialstore
• marketplace
• electronicsretailer
• general_retailer

数据/质量保障

在最终确定推荐之前：

• - 确认相同型号/版本
• 确认税费/运费基准一致性
• 区分全新与翻新/二手
• 保留URL+时间戳证据

详细模式+保障：

• - references/data-shape-and-source-types.md

资源

• - 脚本：scripts/globalpricecompare.py
• 参考：references/data-shape-and-source-types.md