工具参考总览

通用约定

国家/站点参数

所有工具的 country 都是下面枚举之一：

值	站点	Keepa domainId
us	Amazon.com	1
uk	Amazon.co.uk	2
de	Amazon.de	3
fr	Amazon.fr	4
jp	Amazon.co.jp	5
ca	Amazon.ca	6
it	Amazon.it	8
es	Amazon.es	9
in	Amazon.in	10
mx	Amazon.com.mx	11
br	Amazon.com.br	12

detailLevel（仅产品类工具）

• summary —— 仅摘要字段（ASIN/标题/价格/评分/排名）
• lite —— 去除 csv / variationCSV / salesRanks 等大字段（默认）
• full —— 完整原始数据

为避免上下文爆炸，AI 场景强烈建议用 summary 或 lite。

价格单位

Keepa 返回的价格单位是分（cents），如 1000 表示 10.00 美元/英镑/欧元。评分字段是 评分 × 10（如 45 = 4.5 星）。

时间单位

Keepa 内部时间是从 Unix 纪元 1970-01-01 UTC 起以分钟计的整数，并减去 21564000 作为偏移。换算公式：

unixMs = (keepaTime + 21564000) * 60000
keepaTime = floor(unixMs / 60000) - 21564000

懒得算的话直接用 keepa_time_convert 工具。

工具索引

每行末尾标注计费与典型场景，方便快速挑工具。

产品类

• keepa_get_product —— 按 ASIN 批量拉详情 · 1 unit/ASIN · 最高频工具，拿详情 / 价格历史 / 评分 / Buy Box 都用它
• keepa_product_search —— 按关键词搜索 · 5 units/次 · 关键词选品起点，单页最多 100 条，最多翻 10 页
• keepa_product_finder —— 按数百字段筛选（选品） · 1 + 每 100 结果 1 unit · 按价格 / 排名 / 评分 / 历史新低等多维度联合选品

榜单与分类

• keepa_get_best_sellers —— 类目畅销榜 · 10 units/次 · 拉某类目热销 ASIN 排名；category=0 时返回站点根分类
• keepa_category_lookup —— 按 ID 查类目详情 · 1 unit/次 · 拿子分类、类目树结构
• keepa_category_search —— 按关键词搜类目 · 1 unit/次 · Product Finder 前的入口，先定位 catId

卖家

• keepa_get_seller —— 卖家信息 / 店铺 ASIN · 1 × N 或 10（storefront） · 查卖家评分 / 反馈数，或拉单卖家的 storefront ASIN 列表
• keepa_get_top_sellers —— Most Rated Sellers · 50 units/次 · 找站点评价数最多的头部卖家做竞品调研

Deals

• keepa_get_lightning_deals —— Lightning Deals · 1（单 ASIN）/ 500（全量） · 查 ASIN 是否在秒杀，或拉站点全量秒杀
• keepa_browse_deals —— Browse Deals · 5 units/次 · Keepa 综合打折追踪：历史新低、降价幅度、跌价趋势

可视化与工具

• keepa_graph_image —— 价格历史图 PNG · 1 unit/次 · 在对话 / 报告中直接展示某 ASIN 的价格走势图
• keepa_time_convert（免费） —— Keepa 时间 ↔ Unix 互转 · 0 units · 处理 csv 数组里的 KeepaTime 字段
• keepa_get_quota（免费） —— 查询当前额度 · 0 units · 调用前自检余量 / 后台监控
• amazon_get_product_url（免费） —— 拼接 Amazon 商品页链接 · 0 units
• keepa_get_chart_url（免费） —— 拼接 Keepamore 站内 Keepa 图表页链接 · 0 units

ABA 关键词（Amazon Brand Analytics）

ABA 数据来自 Amazon Brand Analytics 周榜单，覆盖 us/uk/de/fr/it/jp/ca/es/mx 共 9 站点。数据来自自有数据库，不消耗 Keepa API token。

• aba_get_countries（免费） —— 获取 ABA 站点列表与最新报告日期 · 0 units · 前置查询，确认数据可用性
• aba_get_rank_list —— 周榜单关键词排名查询 · ceil(limit/1000) units · 多维筛选（品牌/类目/排名变化/点击/转化）+ Keyset 分页
• aba_search_keywords —— 关键词字典全文搜索 · 1 unit/次 · 英文 FULLTEXT + 中文 LIKE，获取 word_id 入口
• aba_get_word_detail —— 关键词详情 + 排名历史 + Top3 ASIN · 1 unit/次 · 深入分析单个关键词
• aba_reverse_asin —— ASIN 反查关键词 · 1 unit/ASIN · 竞品流量来源分析