linkfox-sorftime-amazon-product-detail

Sorftime 产品详情

此技能指导你如何通过 Sorftime 按 ASIN 查询 Amazon 产品详情和历史趋势数据，帮助 Amazon 卖家分析产品表现、定价策略和竞争定位。

核心概念

Sorftime 产品详情按 ASIN 提供全面的产品级数据，历史趋势数据可追溯至 2021 年。数据涵盖销量和营收趋势、价格与促销跟踪、多层级 BSR 排名历史，以及包含 FBA 费用明细的实时利润分析。

主要区别：此工具返回单个产品的趋势/时间序列数据。如果你需要按类目、品牌或卖家搜索/筛选产品，请改用 Sorftime 产品搜索技能。

数据字段

响应数据涵盖以下类别（完整字段说明见 references/api.md）：

• 基本信息：标题、品牌、ASIN、商品详情页 URL、图片（主图 + A+）、店铺名称、要点、产品徽章、停售状态、最后更新日期、重量、尺寸
• 变体：父 ASIN、变体数量、子 ASIN、变体属性
• 价格与利润：售价、优惠券、平台费用、FBA 费用（含详细明细）、FBM 配送成本、利润金额和利润率
• 销量：官方月销量（由 Amazon 发布）
• 排名：BSR 排名、类目树、子类目排名、上架日期、在线天数
• 评分：评分、评分数量、星级分布（1–5 星占比）
• 卖家：Buybox 卖家名称/ID/国家、FBA 状态、卖家数量
• 商品详情页特征：A+ 内容、视频、品牌店铺、特征评分、商品信息、属性
• 促销：品牌促销、促销类型、额外优惠
• 趋势（时间序列）：BSR 排名、子 BSR 排名、日/月销量、日/月营收、价格、标价、促销状态

支持的商城

US（美国）、GB（英国）、DE（德国）、FR（法国）、IN（印度）、CA（加拿大）、JP（日本）、ES（西班牙）、IT（意大利）、MX（墨西哥）、AE（阿联酋）、AU（澳大利亚）、BR（巴西）、SA（沙特阿拉伯）

默认商城为 US。用户未指定商城时使用 us。

注意：Sorftime 使用小写代码（例如 us、gb、de），英国的代码为 gb（不是 uk）。

调用方式

• API 端点：POST /sorftime/amazon/productDetail（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/sorftime_product_detail.py '<JSON 参数>' [--inline]
• 成本约束：此工具会消耗算力；同一会话中相同参数组合默认只调用一次，脚本带有 24h 本地缓存。失败/结果为空时不得自动更换关键词、翻页或更改邮编连续试探；需要继续检索时，先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <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 放入上下文。

解决认证和算力问题

发生以下异常情况时，参照 references/onboarding.md 的指引解决问题：

异常情况

• 未配置 API Key：未配置环境变量 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示算力或余额不足：消息中包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。

如何构建查询

关键参数为 asin 和 marketplace（均为必填），另可选趋势日期范围控制参数。

构建查询的原则

1. 始终指定商城：使用小写站点代码，例如 us、de、jp
2. 谨慎选择是否包含趋势数据：默认包含趋势数据（最近 15 天）。如果只需要基本产品信息，请设置 includeTrend: 2，这样可以节省成本并加快响应
3. 进行历史分析时指定日期范围：当用户需要查询超出默认 15 天的趋势数据时，使用 queryTrendStartDate 和 queryTrendEndDate（yyyy-MM-dd）。请注意，这会使成本翻倍
4. 比较时批量查询 ASIN：一次最多可查询 10 个 ASIN，以逗号分隔。进行竞品比较时应使用此方式，而不是逐个查询

常见场景的查询示例

1. 快速查看产品（默认 15 天趋势）

asin: B00FLYWNYQ, marketplace: us

2. 长期趋势分析（指定日期）

asin: B00FLYWNYQ, marketplace: us
queryTrendStartDate: 2025-01-01, queryTrendEndDate: 2025-03-31

3. 批量比较 ASIN

asin: B0088PUEPK,B00U26V4VQ,B0CVM8TXHP, marketplace: us

4. 仅查询产品信息，不包含趋势

asin: B0088PUEPK, marketplace: us, includeTrend: 2

5. BSR 排名历史（德国市场）

asin: B00FLYWNYQ, marketplace: de
queryTrendStartDate: 2024-06-01, queryTrendEndDate: 2025-01-01

趋势数据解读

趋势数组采用交错格式：偶数索引为日期，奇数索引为数值。

[20250101, 150, 20250102, 180, 20250103, 165, ...]
 ^date     ^val ^date     ^val ^date     ^val

• 销量／销售额趋势：数值 -1 表示“无法估算”（例如，类别变更为 Amazon Renewed）
• 价格趋势：单位为当地货币的最小单位（USD 的单位为美分）；-1 表示当天没有可用价格
• BSR 排名趋势：对于 bsrRankTrend，每个子类别的格式为 [{NodeId: xxx, Rank: [date, rank, ...]}]
• Deal 趋势：数值 1 = 当天有有效 Deal，0 = 当天没有 Deal

展示规则

1. 仅呈现数据：以清晰的表格展示查询结果，不提供主观的商业建议
2. 说明排名含义：展示排名数据时，提醒用户数值越低，排名越好
3. 注意价格单位：趋势数据使用货币的最小单位（USD 的单位为美分）。向用户展示时，请换算为标准货币单位
4. 说明销量估算限制：销量／销售额字段中的 -1 表示“无法估算”，应向用户解释，而不是直接显示 -1
5. 可视化趋势：展示趋势数据时，将关键数据点整理成易读的表格，而不是直接输出原始数组
6. 处理停售情况：当 offSale 为 true 时，明确告知用户该产品目前无货／已停售
7. 错误处理：查询失败时，根据 msg 字段说明原因，并建议调整查询条件

重要限制

• 每次查询最多 10 个 ASIN
• 趋势数据成本：默认返回最近 15 天的数据；查询超过 15 天的数据，成本翻倍
• 非结构化数据：结果不支持通过 _dataQuery_executeDynamicQuery 进行二次分析
• 销量估算：Amazon Renewed 等非标准类别中的产品，其销量字段可能返回 -1

用户表达与场景速查

适用 - 按 ASIN 查询产品详情和趋势：

用户说法	场景
“查一下这个 ASIN 的销量走势”	销量趋势
“这个产品最近价格变化如何”	价格历史
“帮我看看这个产品的利润空间”	利润分析
“这个 ASIN 的 BSR 排名趋势”	排名历史
“对比一下这几个 ASIN 的数据”	多 ASIN 比较
“这个产品的 FBA 费用是多少”	FBA 费用明细
“产品上架多久了，评分怎么样”	基本产品信息
“这个产品还在售吗”	停售状态检查
“这个产品有没有 Deal 促销记录”	Deal 历史
“看看这个产品的变体信息”	变体详情

不适用 - 需求超出单个产品的详情查询：

• 在某个类别或品牌下搜索／筛选产品（使用 Sorftime Product Search）
• ABA 搜索词排名数据（使用 ABA Data Explorer）
• 广告／PPC 策略
• 产品评论内容分析
• 专利或商标检查

边界判断：当用户提到“产品分析”或“竞品比较”时，如果最终是查看特定 ASIN 的详情数据和趋势曲线，则适用此技能。如果用户想要在某个市场中发现或筛选产品，则不适用。

算力消耗规则

按动态规则计费：消耗算力 = Sorftime 内部查询次数 × 6。Sorftime 内部查询次数：不同查询条件需要的查询次数可能不同，该次数由 Sorftime 决定。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

反馈：

在以下任一情况下，通过 Feedback API 自动检测并提交反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 本技能的结果与用户意图不符
3. 用户表达了对本技能的不满或赞赏
4. 你认为有任何可以改进的地方

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

如需了解更多高品质、专业的跨境电商技能，请访问 LinkFox Skills。