amazon-competitor-analyzer

使用 browseract.com 自动化 API 从 ASIN 中抓取亚马逊产品数据，并执行外科手术竞争分析。比较规格、定价、审查质量和视觉策略，以识别竞争对手的护城河和漏洞。

# Amazon Competitor Analyzer

This skill scrapes Amazon product data from user-provided ASINs using browseract.com's browser automation API and performs deep competitive analysis.

## When to Use This Skill

- Competitive research: Input multiple ASINs to understand market landscape
- Pricing strategy analysis: Compare price bands across similar products
- Specification benchmarking: Deep dive into technical specs and feature differences
- Review insights: Analyze review quality, quantity, and sentiment patterns
- Market opportunity discovery: Identify gaps and potential threats

## What This Skill Does

1. **ASIN Data Collection**: Extract product title, price, rating, review count, images
2. **Specification Extraction**: Deep extraction of technical specs, features, and materials
3. **Review Quality Analysis**: Analyze review patterns, keywords, and sentiment
4. **Multi-Dimensional Comparison**: Side-by-side comparison of key metrics
5. **Moat Identification**: Identify core competitive advantages and barriers
6. **Vulnerability Discovery**: Find competitor weaknesses and market opportunities

## Features

1. **Stable and accurate data extraction**: Pre-set workflows ensure consistent results.
2. **Browser automation**: Uses BrowserAct's automated browser instances for reliable data collection.
3. **Global accessibility**: BrowserAct provides servers in multiple regions.
4. **Fast execution**: Optimized workflow templates complete tasks quickly.
5. **Cost efficient**: Reduces manual research time and associated costs.

## Prerequisites

### BrowserAct.com Account Setup

You need a BrowserAct.com account and API key:

1. Visit [browseract.com](https://browseract.com)
2. Sign up for an account
3. Navigate to [API Settings](https://www.browseract.com/reception/integrations)
4. Generate an API key

### Environment Configuration

Copy the `.env.example` file to `.env` and add your API key:

```bash
cp .env.example .env
# Edit .env and replace YOUR_API_KEY_HERE with your actual API key
```

Or set as environment variable:

```bash
export BROWSERACT_API_KEY="your-api-key-here"
```

## Usage

### Basic Analysis

```bash
python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG
```

### Multiple Products

```bash
python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG B07ABC11111 B08N5WRWNW
```

### With Output Directory

```bash
python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG -o ./output
```

### Output Formats

- **CSV**: Structured data table
- **Markdown**: Comprehensive report
- **JSON**: Raw data with analysis

## Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| asins | string | - | One or more Amazon ASINs to analyze |
| --output, -o | string | ./output | Output directory |
| --format | string | all | Output format (csv/markdown/json/all) |
| --api-key | string | env | BrowserAct API key |

## Dependencies

This skill requires the following Python packages:

```bash
pip install requests
```

Optional (for automatic .env loading):
```bash
pip install python-dotenv
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| BROWSERACT_API_KEY | Yes | Your BrowserAct API key. Get it from [BrowserAct Console](https://www.browseract.com/reception/integrations) |

## Error Handling

- **Invalid API Key**: Check BROWSERACT_API_KEY environment variable
- **Network Error**: Verify internet connection
- **Rate Limit**: Wait and retry with exponential backoff
- **Invalid ASIN**: Verify ASIN format (10 alphanumeric characters)

---

**Version**: 1.0.0  
**Updated**: 2026-02-09  
**Template ID**: `77814333389670716`

---

## 中文说明

# Amazon Competitor Analyzer

本技能使用 browseract.com 的浏览器自动化 API，从用户提供的 ASIN 抓取亚马逊产品数据，并执行深度竞争分析。

## When to Use This Skill（何时使用本技能）

- 竞争研究：输入多个 ASIN 以了解市场格局
- 定价策略分析：比较同类产品的价格区间
- 规格基准对比：深入分析技术规格和功能差异
- 评论洞察：分析评论质量、数量和情感模式
- 市场机会发掘：识别差距和潜在威胁

## What This Skill Does（本技能的功能）

1. **ASIN 数据采集**：提取产品标题、价格、评分、评论数、图片
2. **规格提取**：深度提取技术规格、功能和材质
3. **评论质量分析**：分析评论模式、关键词和情感
4. **多维度比较**：对关键指标进行并排比较
5. **护城河识别**：识别核心竞争优势和壁垒
6. **漏洞发掘**：找出竞争对手的弱点和市场机会

## Features（特性）

1. **稳定且准确的数据提取**：预设工作流确保结果一致。
2. **浏览器自动化**：使用 BrowserAct 的自动化浏览器实例以可靠地采集数据。
3. **全球可访问性**：BrowserAct 在多个地区提供服务器。
4. **快速执行**：优化的工作流模板能快速完成任务。
5. **成本高效**：减少人工研究时间和相关成本。

## Prerequisites（前置条件）

### BrowserAct.com Account Setup（BrowserAct.com 帐户设置）

你需要一个 BrowserAct.com 帐户和 API 密钥：

1. 访问 [browseract.com](https://browseract.com)
2. 注册一个帐户
3. 进入 [API Settings](https://www.browseract.com/reception/integrations)
4. 生成 API 密钥

### Environment Configuration（环境配置）

将 `.env.example` 文件复制为 `.env` 并添加你的 API 密钥：

```bash
cp .env.example .env
# Edit .env and replace YOUR_API_KEY_HERE with your actual API key
```

或设置为环境变量：

```bash
export BROWSERACT_API_KEY="your-api-key-here"
```

## Usage（用法）

### Basic Analysis（基本分析）

```bash
python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG
```

### Multiple Products（多个产品）

```bash
python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG B07ABC11111 B08N5WRWNW
```

### With Output Directory（指定输出目录）

```bash
python amazon-competitor-analyzer/amazon_competitor_analyzer.py B09G9GB4MG -o ./output
```

### Output Formats（输出格式）

- **CSV**：结构化数据表
- **Markdown**：综合报告
- **JSON**：带分析的原始数据

## Parameters（参数）

| 参数 | 类型 | 默认值 | 说明 |
|-----------|------|---------|-------------|
| asins | string | - | 一个或多个要分析的亚马逊 ASIN |
| --output, -o | string | ./output | 输出目录 |
| --format | string | all | 输出格式（csv/markdown/json/all） |
| --api-key | string | env | BrowserAct API 密钥 |

## Dependencies（依赖）

本技能需要以下 Python 包：

```bash
pip install requests
```

可选（用于自动加载 .env）：
```bash
pip install python-dotenv
```

## Environment Variables（环境变量）

| 变量 | 必填 | 说明 |
|----------|----------|-------------|
| BROWSERACT_API_KEY | 是 | 你的 BrowserAct API 密钥。从 [BrowserAct Console](https://www.browseract.com/reception/integrations) 获取 |

## Error Handling（错误处理）

- **Invalid API Key（无效 API 密钥）**：检查 BROWSERACT_API_KEY 环境变量
- **Network Error（网络错误）**：验证互联网连接
- **Rate Limit（速率限制）**：等待后以指数退避重试
- **Invalid ASIN（无效 ASIN）**：验证 ASIN 格式（10 个字母数字字符）

---

**Version**: 1.0.0  
**Updated**: 2026-02-09  
**Template ID**: `77814333389670716`