用途
本技能用于查询和分析亚马逊商品的历史时序数据，帮助卖家追踪单个 ASIN 的价格走势、BSR（畅销排名）趋势、评分变化、卖家数量和月销量等关键指标随时间的变化。数据由 Keepa 提供。
主要能力
可返回以下数据序列（均为 {time, value} 对象数组）：
- Buy Box 价格（始终返回）
- 最低新品价（showPrice=1）
- 标价/划线价（showPriceList=1）
- 秒杀价（showPriceDeal=1）
- Prime 专享价（showPricePrime=1）
- 第三方 FBA 新品价（showPriceFba=1）
- 第三方 FBM 新品价（showPriceFbm=1）
- 优惠券后 Buy Box 价格（showPriceCoupon=1）
- 主类目 BSR（showBsrMain=1）
- 卖家数量（showSellerCount=1）
- 评分（始终返回）
- 评分数（始终返回）
- 月销量（始终返回）
- 子类目 BSR（始终返回）
BSR 逻辑：数值越小排名越好，排名 1 为类目销量第一。用户说“BSR 提升”指数值下降，“BSR 下降”指数值上升。
支持站点（domain ID）：1 美国、2 英国、3 德国、4 法国、5 日本、6 加拿大、8 意大利、9 西班牙、10 印度、11 墨西哥、12 巴西。默认站点为 1（美国）。
使用方式
调用方式：
- API 端点：POST /keepa/productSeries（完整参数/响应/错误码见 references/api.md）
- Python 脚本：python scripts/keepa_product_history.py '<JSON 参数>' [--inline]
必填参数：
- asin：要查询的亚马逊 ASIN，每次仅支持一个
- domain：亚马逊站点数字 ID
可选参数：
- days：历史天数（1-365，默认 90）
- show* 标志：设为 1 以包含对应数据序列；默认仅返回核心序列（Buy Box 价格、评分、评分数、月销量、子类目 BSR）
参数选择建议：价格分析启用 showPrice、showPriceList、showPriceDeal、showPriceCoupon；FBA 与 FBM 对比同时启用 showPriceFba 和 showPriceFbm；BSR 深入分析启用 showBsrMain；竞争格局启用 showSellerCount；全面概览启用全部 show 标志。
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-keepa-product-series-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）
- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
- 加 --inline 强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
算力消耗规则：按动态规则计费，消耗算力 = 0.045 × 本次历史趋势查询消耗的 Keepa token。本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。
认证与算力问题：未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401 或 402、或提示算力/余额不足时，按 references/onboarding.md 引导解决。
适用场景
适用于亚马逊商品级历史数据查询：价格走势分析、BSR 追踪、降价/秒杀检测、卖家数量趋势、评分与评论数追踪、FBA 与 FBM 价格对比、月销量趋势、竞争定价分析，以及用户明确要求查看 Keepa 数据或图表。
不适用于：搜索词/关键词分析（应使用 ABA 数据）、广告/PPC 活动数据、Listing 文案或内容优化、类目级或市场级聚合趋势、实时库存检查、评论文本或情感分析。
边界判断：当用户说“选品”或“竞品分析”，若实质是查看特定 ASIN 的历史价格、BSR 或销量数据，则适用本技能；若需要关键词数据、市场级趋势或广告指标，则不适用。
限制
- 每次查询仅支持一个 ASIN，多 ASIN 对比需分别发起多次请求
- 历史数据最多回溯 365 天
- 数据点间隔不规则，取决于 Keepa 抓取变化的时间，并非固定每日间隔
- 展示数据时应使用与站点匹配的货币符号，时间戳以可读日期格式呈现；展示 BSR 时需提醒数值越小排名越好
- 查询失败时应说明原因并建议修正（如验证 ASIN 是否有效、检查站点 domain ID）