用途
本技能用于按 ASIN 查询亚马逊产品详情与历史趋势数据，帮助亚马逊卖家分析产品表现、定价策略与竞争定位。其核心特点是返回单个产品的时间序列/趋势数据；若需要按类目、品牌或卖家搜索和筛选产品，应改用 Sorftime Product Search 技能。
主要能力
数据字段覆盖以下类别（完整字段见 references/api.md）：
- 基础信息：标题、品牌、ASIN、Listing URL、图片（主图 + A+）、店铺名称、五点描述、产品徽章、下架状态、最后更新日期、重量、尺寸
- 变体：父 ASIN、变体数量、子 ASIN、变体属性
- 价格与利润：售价、优惠券、平台费、FBA 费用（含明细拆分）、FBM 运费、利润金额与利润率
- 销量：官方月销量（亚马逊公布）
- 排名：BSR 排名、类目树、子类目排名、上架日期、在线天数
- 评分：评分值、评分数、星级分布（1-5 星占比）
- 卖家：Buybox 卖家名称/ID/国家、FBA 状态、卖家数量
- Listing 特征：A+ 内容、视频、品牌店铺、特征评分、产品信息、属性
- 促销：品牌促销、Deal 类型、额外优惠
- 趋势（时间序列）：BSR 排名、子 BSR 排名、日/月销量、日/月销售额、价格、标价、Deal 状态
支持站点
美国（US）、英国（GB）、德国（DE）、法国（FR）、印度（IN）、加拿大（CA）、日本（JP）、西班牙（ES）、意大利（IT）、墨西哥（MX）、阿联酋（AE）、澳大利亚（AU）、巴西（BR）、沙特（SA）。默认站点为美国（us）。Sorftime 使用小写站点代码，英国编码为 gb（而非 uk）。
使用方式
调用方式：
- API 端点：POST /sorftime/amazon/productDetail（完整参数/响应/错误码见 references/api.md）
- Python 脚本：python scripts/sorftime_product_detail.py '<JSON 参数>' [--inline]
关键参数为 asin 和 marketplace（均为必填），另有可选的趋势日期范围控制。查询构建原则：
- 始终指定 marketplace，使用小写站点代码，如 us、de、jp
- 谨慎选择是否包含趋势：默认包含趋势（最近 15 天）；若只需基础产品信息，设置 includeTrend: 2 可节省成本并加快响应
- 历史分析指定日期范围：需要超过默认 15 天的趋势时，使用 queryTrendStartDate 和 queryTrendEndDate（yyyy-MM-dd），注意此操作成本翻倍
- 对比时批量查询 ASIN：一次最多可查询 10 个 ASIN，逗号分隔，用于竞品对比而非逐个调用
常见场景查询示例：
- 快速产品检查（默认 15 天趋势）：asin: B00FLYWNYQ, marketplace: us
- 长周期趋势分析（指定日期）：asin: B00FLYWNYQ, marketplace: us, queryTrendStartDate: 2025-01-01, queryTrendEndDate: 2025-03-31
- 批量 ASIN 对比：asin: B0088PUEPK,B00U26V4VQ,B0CVM8TXHP, marketplace: us
- 仅产品信息、不含趋势：asin: B0088PUEPK, marketplace: us, includeTrend: 2
- BSR 排名历史（德国站）：asin: B00FLYWNYQ, marketplace: de, queryTrendStartDate: 2024-06-01, queryTrendEndDate: 2025-01-01
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-amazon-product-detail-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
- 加 --inline 强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
趋势数据解读
趋势数组采用交错格式：偶数索引为日期，奇数索引为数值。
[20250101, 150, 20250102, 180, 20250103, 165, ...] ^date ^val ^date ^val ^date ^val
- 销量/销售额趋势：数值 -1 表示“无法估算”（例如类目变更为 Amazon Renewed）
- 价格趋势：单位为当地货币最小单位（美元为美分）；-1 表示当天无可用价格
- BSR 排名趋势：bsrRankTrend 格式为 [{NodeId: xxx, Rank: [date, rank, ...]}]，按子类目分组
- Deal 趋势：数值 1 表示当天有活跃 Deal，0 表示无 Deal
展示规则
- 仅呈现数据：以清晰表格展示查询结果，不提供主观商业建议
- 排名说明：展示排名数据时，提醒用户数值越小排名越好
- 价格单位意识：趋势数据使用货币最小单位（美元为美分），展示给用户时需换算为标准货币
- 销量估算提示：销量/销售额字段中的 -1 表示“无法估算”，应向用户解释而非直接显示 -1
- 趋势可视化：展示趋势数据时，以可读表格呈现关键数据点，而非直接倾倒原始数组
- 下架处理：当 offSale 为 true 时，明确告知用户该产品当前不可售/已下架
- 错误处理：查询失败时，根据 msg 字段解释原因并建议调整查询条件
适用场景
适用于按 ASIN 的产品详情与趋势查询，例如：
- “查一下这个 ASIN 的销量走势”（销量趋势）
- “这个产品最近价格变化如何”（价格历史）
- “帮我看看这个产品的利润空间”（利润分析）
- “这个 ASIN 的 BSR 排名趋势”（排名历史）
- “对比一下这几个 ASIN 的数据”（多 ASIN 对比）
- “这个产品的 FBA 费用是多少”（FBA 费用明细）
- “产品上架多久了，评分怎么样”（基础产品信息）
- “这个产品还在售吗”（下架状态检查）
- “这个产品有没有 Deal 促销记录”（Deal 历史）
- “看看这个产品的变体信息”（变体详情）
不适用场景：跨类目或品牌搜索/筛选产品（使用 Sorftime Product Search）、ABA 搜索词排名数据（使用 ABA Data Explorer）、广告/PPC 策略、产品评论内容分析、专利或商标查询。
边界判断：当用户说“产品分析”或“竞品对比”时，若归结为查看特定 ASIN 的详情数据与趋势曲线，则适用本技能；若是在整个市场中发现或筛选产品，则不适用。
限制
- 每次查询最多 10 个 ASIN
- 趋势成本：默认返回最近 15 天；查询超过 15 天成本翻倍
- 非结构化数据：结果不支持通过 _dataQuery_executeDynamicQuery 进行二次分析
- 销量估算：非标准类目（如 Amazon Renewed）的产品销量字段可能返回 -1
- 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗
- 算力消耗规则：按动态规则计费，消耗算力 = Sorftime 内部查询次数 × 6；Sorftime 内部查询次数由 Sorftime 决定，不同查询条件可能不同。本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续
认证与算力问题
发生以下异常情况时，采用 references/onboarding.md 引导解决：
- 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY
- 响应 401 或 402 状态码
- 响应提示算力或余额不足：消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容
反馈
当出现以下情况时，通过 Feedback API 自动检测并报告反馈：本技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞扬；任何你认为可以改进的地方。按 references/api.md 中的说明调用反馈 API，不要打断用户流程。