Keepa API 客户端

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

依赖

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

安装依赖:
CODEBLOCK0

Usage

CODEBLOCK1

Options

Option	Description
INLINECODE0	亚马逊站点 (默认：US)
INLINECODE1

Core Tools

1. Product Query (产品查询)

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

CODEBLOCK2

返回数据:

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

2. Price History (价格历史)

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

CODEBLOCK3

返回数据:

- 每日价格点
价格变化时间线
历史最低价/最高价
平均价格

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

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

CODEBLOCK4

返回数据:

- 每日 BSR 排名
排名变化趋势
类目前 100 记录

4. Product Search (产品搜索)

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

CODEBLOCK5

返回数据:

- 匹配产品列表
ASIN、标题、价格
评分和评论数
图片链接

5. Best Sellers (热销榜)

获取类目热销榜产品。

CODEBLOCK6

返回数据:

- 热销产品排名
产品 ASIN 和信息
当前价格

Three Dimensions

Dimension	Controls	Options
Data Type	数据类型	product, price, rank, offers, search
Marketplace

Marketplace Reference

Marketplace	Code	Domain
美国	US	amazon.com
英国

UK | amazon.co.uk | | 德国 | DE | amazon.de | | 法国 | FR | amazon.fr | | 日本 | JP | amazon.co.jp | | 加拿大 | CA | amazon.ca | | 澳大利亚 | AU | amazon.com.au | | 印度 | IN | amazon.in |

Workflow

Progress Checklist

CODEBLOCK7

Flow

CODEBLOCK8

Step 0: Configuration Check ⛔ BLOCKING

Purpose: Check Keepa API configuration.

Configuration paths:

1. Project-level: INLINECODE5
User-level: INLINECODE6

Check command:
CODEBLOCK9

First-Time Setup (if config not found):

Use AskUserQuestion with questions:

1. Keepa API Key (required):

- Input your Keepa API key - Get key from: https://keepa.com/#!api

2. Default marketplace:

- US (amazon.com) - UK (amazon.co.uk) - DE (amazon.de) - JP (amazon.co.jp) - Other

3. Default history days:

- 30 days - 90 days (default) - 180 days - 365 days

4. Output format:

- Table (default, readable) - JSON (for integration)

Configuration file format (CONFIG.md):
CODEBLOCK10

Step 1: Understand Data Requirement

Analyze user request:

- Data type needed (product/price/rank/offers/search)
Target ASIN(s) or keyword(s)
Marketplace
Time period

Step 2: Confirm Query Parameters ⚠️

Display confirmation:

- Query type
Target (ASIN/keyword)
Marketplace
Days range
Output format

Step 3: Execute API Request

Execute curl request:
CODEBLOCK11

Step 4: Parse and Display Results

Output format:
CODEBLOCK12

API Endpoints

Product Endpoint

CODEBLOCK13

Search Endpoint

CODEBLOCK14

Best Sellers Endpoint

CODEBLOCK15

Category IDs

Category	ID
Electronics	172282
Computers

541966 | | Home & Kitchen | 1055398 | | Beauty & Personal Care | 3760911 | | Sports & Outdoors | 3375251 | | Toys & Games | 165793011 | | Clothing | 7141123011 | | Books | 283155 | | Office Products | 1064954 | | Garden & Outdoor | 2972638011 |

File Structure

CODEBLOCK16

Configuration

Get API Key

1. Visit Keepa API
Register or login
Go to Account → API Key
Copy your API key

Rate Limits

Plan	Tokens/Day	Cost per Request
Free	100	1-2 tokens
Basic (9€/mo)

Token Costs

Request Type	Token Cost
Product (single ASIN)	1-2 tokens
Product (batch 10 ASINs)

Output Examples

Product Query Result

CODEBLOCK17

Search Result

CODEBLOCK18

Best Practices

数据准确性

- 价格数据每 15 分钟更新
销售排名每小时更新
历史数据最多保留 2 年

API 优化

- 批量查询 ASIN 节省 tokens
仅请求需要的字段
缓存常用查询结果

价格追踪

- 设置价格提醒
关注历史低价
比较多个卖家

Troubleshooting

Issue	Solution
Invalid API Key	Verify key in Keepa dashboard
Token limit exceeded

References

Notes

- 需要有效的 Keepa API key
免费账户每日 100 tokens
数据更新频率：15 分钟
支持 8 个亚马逊站点

Keepa API 客户端

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

依赖

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

安装依赖:
bash

macOS

brew install curl jq

Ubuntu/Debian

apt-get install curl jq

使用方法

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]

选项

选项	描述
--domain <US\	UK\	DE\	...>	亚马逊站点 (默认：US)
--days <number>

核心工具

1. 产品查询

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

bash
/keepa-api asin [--marketplace US] [--days 90]

返回数据:

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

2. 价格历史

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

bash
/keepa-api price-history [--days 30|90|180|365]

返回数据:

- 每日价格点
价格变化时间线
历史最低价/最高价
平均价格

3. 销售排名历史

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

bash
/keepa-api asin --days 90

返回数据:

- 每日 BSR 排名
排名变化趋势
类目前 100 记录

4. 产品搜索

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

bash
/keepa-api search [--category ] [--page ]

返回数据:

- 匹配产品列表
ASIN、标题、价格
评分和评论数
图片链接

5. 热销榜

获取类目热销榜产品。

bash
/keepa-api bestsellers --category [--page ]

返回数据:

- 热销产品排名
产品 ASIN 和信息
当前价格

三个维度

维度	控制项	选项
数据类型	数据类型	product, price, rank, offers, search
市场

市场参考

市场	代码	域名
美国	US	amazon.com
英国

工作流程

进度检查清单

Keepa API 查询进度：

- [ ] 步骤 0：检查 API 配置 ⛔ 阻塞
[ ] 步骤 1：理解数据需求
[ ] 步骤 2：确认查询参数 ⚠️ 必需
[ ] 步骤 3：执行 API 请求
[ ] 步骤 4：解析并显示结果

流程

输入 → [步骤 0：配置检查] ─┬─ 已配置 → 继续
│
└─ 未配置 → 需要设置 ⛔ 阻塞
│
└─ 完成设置 → 保存配置 → 继续

步骤 0：配置检查 ⛔ 阻塞

目的：检查 Keepa API 配置。

配置路径：

1. 项目级别：.teamclaw-skills/keepa-api/CONFIG.md
用户级别：~/.teamclaw-skills/keepa-api/CONFIG.md

检查命令：
bash

先检查项目级别

test -f .teamclaw-skills/keepa-api/CONFIG.md && echo project

再检查用户级别

test -f $HOME/.teamclaw-skills/keepa-api/CONFIG.md && echo user

首次设置（如果未找到配置）：

使用 AskUserQuestion 提问：

1. Keepa API 密钥（必需）：

- 输入您的 Keepa API 密钥 - 获取密钥：https://keepa.com/#!api

2. 默认市场：

- 美国 (amazon.com) - 英国 (amazon.co.uk) - 德国 (amazon.de) - 日本 (amazon.co.jp) - 其他

3. 默认历史天数：

- 30 天 - 90 天（默认） - 180 天 - 365 天

4. 输出格式：

- 表格（默认，可读性强） - JSON（用于集成）

配置文件格式（CONFIG.md）：
yaml

api_key: your-keepa-api-key-here
marketplace: US
default_days: 90
output_format: table

步骤 1：理解数据需求

分析用户请求：

- 所需数据类型（product/price/rank/offers/search）
目标 ASIN 或关键词
市场
时间范围

步骤 2：确认查询参数 ⚠️

显示确认信息：

- 查询类型
目标（ASIN/关键词）
市场
天数范围
输出格式

步骤 3：执行 API 请求

执行 curl 请求：
bash
curl -s https://api.keepa.com/product?key=$API_KEY&domain=$DOMAIN&asin=$ASIN

步骤 4：解析并显示结果

输出格式：

═══ Keepa 产品报告 ═══

ASIN: B08XYZ123
标题：[产品标题]
品牌：[品牌名称]
类目：[类目]

当前价格：

- Amazon：$29.99
第三方新品：$27.99
第三方二手：$22.99

销售排名：#1,234 in Electronics
评分：4.5/5（2,847 条评论）

价格历史（90 天）：

- 最低：$24.99（2024-01-15）
最高：$34.99（2024-02-01）
平均：$29.50

API 端点

产品端点

GET /product
参数：

- key：API 密钥
domain：亚马逊域名（1=美国，3=英国，4=德国，5=法国，6=日本，7=加拿大，9=澳大利亚，10=印度）
asin：ASIN 或逗号分隔列表
history：包含价格历史（1/0）
rating：包含评分（1/0）

搜索端点

GET /search
参数：

- key：API 密钥
domain：亚马逊域名
query：搜索查询
category：类目 ID（可选）
page：页码（可选）

热销榜端点

GET /bestsellers
参数：

- key：API 密钥
domain：亚马逊域名
categoryId：类目 ID
page：页码（可选）

类目 ID

类目	ID
电子产品	172282
电脑

541966 | | 家居与厨房 | 1055398 | | 美容

Keepa API客户端