竞品批量对比

基于用户上传的 CSV 导出或已授权 API 快照进行批量竞品对比分析。ClawHub / OpenClaw 云端模式 — Harness comp_scrape 在 Yufluent 服务端执行；本机只需 TOKENAPI_KEY（tk-*）与 requests。

⚠️ 非未授权爬虫 — 本技能仅分析你手动导出或授权的数据，不抓取平台页面。

OpenClaw 与 Yufluent（必读）

OpenClaw 对话与技能调用共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw。

Agent 硬性规则：

1. 禁止用对话模型自行撰写完整批量竞品对比报告。
2. 必须通过 python scripts/run.py ...（或 POST /v1/skills/comp-scrape/run）获取输出。
3. 对话模型仅用于：帮助整理竞品 CSV 格式、确认平台与语言、解释报告、建议下一步。
4. 只需 TOKENAPI_KEY，不要要求用户另配厂商 LLM Key。

Instructions（Agent 工作流）

1. 确认数据来源：--source-type 为 csv_export（默认）或 api_snapshot。
2. 收集输入：
   • --our-product（必填）：我方产品名
   • --competitor-data（必填）：CSV 内容或 .csv/.txt 文件路径
   • --platform：amazon | shopify | tiktok
3. 调用（必须 — 云端）：

   python scripts/run.py \
     --our-product "蓝牙耳机" \
     --competitor-data "title,price\
   

Comp A,29.99
Comp B,35.00"
--platform amazon
--lang zh

- 文件模式：`--competitor-data ./competitors.csv`
- API：`POST {TOKENAPI_BASE_URL}/skills/comp-scrape/run`
4. **计费**：402 余额不足；401 密钥无效。

## 与其他技能联动

| 需求 | 技能 |
|------|------|
| 单条竞品快照对比 | `yufluentcn-comp-track` |
| 批量对比 → Listing 优化 | `yufluentcn-ecommerce-listing` |
| 竞品关键词提取 → SEO | `yufluentcn-seo-pro` |

## 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| `TOKENAPI_KEY` | 是 | `tk-*`，[Yufluent 控制台](https://claw.changzhiai.com) 获取 |
| `TOKENAPI_BASE_URL` | 否 | 默认 `http://localhost:8080/v1` |

## 触发词

- "竞品批量对比"
- "CSV 导入竞品分析"
- "批量对标"
- "这些竞品帮我分析"
- "competitor batch"

## Examples

**CSV 内联**

```bash
python scripts/run.py \
--our-product "蓝牙耳机" \
--competitor-data "title,price,rating\
Comp A,29.99,4.2\
Comp B,35.00,4.5" \
--platform amazon \
--lang zh

从 CSV 文件读取

python scripts/run.py \
  --our-product "USB-C Hub" \
  --competitor-data ./competitors.csv \
  --platform amazon \
  --lang en

授权 API 快照模式

python scripts/run.py \
  --our-product "瑜伽垫" \
  --competitor-data ./api-export.json \
  --source-type api_snapshot \
  --platform shopify \
  --lang zh

合规声明

• 仅分析用户自行导出或已授权的数据，不抓取平台页面
• 不抓取竞品评论、不代写虚假对比
• 对比结论仅供参考，不构成流量承诺

版本记录