ecommerce-competitor-analyzer

用途

E-commerce Competitor Analyzer 是一个多平台电商竞品分析技能，用于自动抓取商品数据并生成综合分析。当用户要求分析、研究或提取电商商品（Amazon、Temu、Shopee）的洞察时使用。当前版本为 Phase 1 MVP，实际支持的平台为 Amazon（仅美国站），输入方式为对话式（ASIN 或 URL）。

主要能力

技能的处理流程分为四步：

提取商品标识：从用户输入中提取所有 ASIN 和/或 URL。支持混合输入，例如从 URL 中提取 ASIN。
批量抓取商品数据：对每个商品标识检测平台，调用对应抓取脚本（Amazon 使用 scripts/scrape-amazon.js），通过 Olostep API 抓取，并使用 Promise.allSettled 并行处理。
批量 AI 分析：对每个成功抓取的商品，读取 prompts/analysis-prompt-base.md 中的分析提示模板，替换商品数据占位符，调用 Gemini API（模型 gemini-3-flash-preview）生成结构化分析结果。
生成双格式输出：同时输出 Google Sheets 表格与 Markdown 报告。

分析框架包含四个维度：

文案构建逻辑与词频分析（The Brain）：文案策略与关键词
视觉资产设计思路（The Face）：视觉设计方法论
评论定量与定性分析（The Voice）：评论情感分析
市场维态与盲区扫描（The Pulse）：市场定位与盲区

使用方式

输入示例：

"Analyze B0C4YT8S6H"
"Analyze these products: B0C4YT8S6H, B08N5WRQ1Y, B0CLFH7CCV"
"Research this competitor: https://amazon.com/dp/B0C4YT8S6H"

输出要求：

Google Sheets 表格，列为：ASIN、产品标题、价格、评分、文案分析摘要、视觉分析摘要、评论分析摘要、市场分析摘要
Markdown 报告，文件名为竞品分析-YYYY-MM-DD.md，包含详细四维分析

Sheet 选择优先级：用户明确指定的 Sheet ID/名称/URL → .env 中的默认值（GOOGLE_SHEETS_ID）→ 请用户提供 Sheet ID。

配置

使用前需检查 .env 文件是否存在并包含所需密钥：

OLOSTEP_API_KEY=your_olostep_api_key_here
GEMINI_API_KEY=your_gemini_api_key_here
GOOGLE_SHEETS_ID=YOUR_GOOGLE_SHEETS_ID_HERE

platforms.yaml 包含平台配置：平台检测的 URL 模式、ASIN 提取正则、抓取 API 端点、数据提取模式。

文件结构

ecommerce-competitor-analyzer.skill/
├── SKILL.md
├── platforms.yaml
├── .env.example
├── prompts/
│   └── analysis-prompt-base.md
├── scripts/
│   ├── detect-platform.js
│   ├── scrape-amazon.js
│   └── batch-processor.js
└── references/
    └── n8n-workflow-analysis.md

适用场景

分析单个或多个 Amazon 商品的竞品情报
从 ASIN 或商品 URL 批量提取商品数据并生成结构化分析
需要将分析结果同时导出到 Google Sheets 与 Markdown 报告的场景

限制

当前版本仅支持 Amazon 美国站；Temu 与 Shopee 平台、跨平台对比、历史追踪与价格提醒均在路线图中，暂未提供。
依赖 Olostep API、Google Gemini API 和 Google Sheets API，需自行配置密钥。
分析提示模板需按 prompts/analysis-prompt-base.md 原样使用，不做修改。
使用前必须验证 .env 存在；若缺少 Google Sheets ID，需向用户索取。

错误处理

采用错误隔离模式：单个商品失败不会中断整批处理，始终报告成功与失败数量，并提供详细错误信息用于调试。常见错误包括：缺少 .env 文件、ASIN 格式无效、抓取超时、Gemini 速率限制。

性能参考

单商品抓取：约 30 秒，约 $0.002（Olostep）
单商品分析：约 45 秒，约 $0.001（Gemini）
单商品总计：约 1-2 分钟，约 $0.003
10 个商品批量：约 10-15 分钟（并行），约 $0.03

以上费用与时间为资料中提供的参考值。