keepa-api

# Keepa API 客户端

基于 Keepa API 的亚马逊产品价格历史追踪工具。

## 依赖

- curl (HTTP 请求)
- jq (JSON 解析)

安装依赖:
```bash
# macOS
brew install curl jq

# Ubuntu/Debian
apt-get install curl jq
```

## Usage

```bash
# ASIN 查询 - 获取产品详情和价格历史
/keepa-api asin B08XYZ123

# 批量 ASIN 查询
/keepa-api batch-asin B08XYZ123,B09ABC456,B07DEF789

# 查询价格历史
/keepa-api price-history B08XYZ123 --days 90

# 关键词搜索产品
/keepa-api search "wireless earbuds" --category Electronics

# 查询 Best Sellers
/keepa-api bestsellers --category Electronics --page 1

# 指定亚马逊站点
/keepa-api asin B08XYZ123 --domain JP

# 直接输入 ASIN
/keepa-api
[paste ASIN or product URL]
```

## Options

| Option | Description |
|--------|-------------|
| `--domain <US\|UK\|DE\|...>` | 亚马逊站点 (默认：US) |
| `--days <number>` | 历史数据天数：30, 90, 180 (默认：90) |
| `--category <name>` | 商品类目 (Electronics, Home, Beauty 等) |
| `--output <table\|json>` | 输出格式 (默认：table) |
| `--page <number>` | 分页页码 (用于搜索和 Best Sellers) |

## Core Tools

### 1. Product Query (产品查询)

查询单个 ASIN 的详细信息，包括价格历史、销售排名、评论等。

```bash
/keepa-api asin <ASIN> [--marketplace US] [--days 90]
```

**返回数据**:
- 产品基础信息 (标题、品牌、类目、图片)
- 当前价格 (Amazon 价格、第三方价格)
- 价格历史记录
- 销售排名 (BSR)
- 评论数量和评分
- 库存状态

### 2. Price History (价格历史)

获取产品历史价格数据，支持自定义时间范围。

```bash
/keepa-api price-history <ASIN> [--days 30|90|180|365]
```

**返回数据**:
- 每日价格点
- 价格变化时间线
- 历史最低价/最高价
- 平均价格

### 3. Sales Rank History (销售排名历史)

追踪产品销售排名变化趋势，与 asin 命令一起返回。

```bash
/keepa-api asin <ASIN> --days 90
```

**返回数据**:
- 每日 BSR 排名
- 排名变化趋势
- 类目前 100 记录

### 4. Product Search (产品搜索)

通过关键词搜索亚马逊产品。

```bash
/keepa-api search "<keyword>" [--category <category>] [--page <n>]
```

**返回数据**:
- 匹配产品列表
- ASIN、标题、价格
- 评分和评...