用途
本技能用于针对亚马逊某一关键词生成综合性的 AI 商业洞察报告，帮助卖家进行数据驱动的选品与市场进入决策。当用户提出亚马逊商业洞察、市场洞察报告、选品报告、市场机会分析、竞争格局、消费者画像、定价分析、细分市场调研等需求时适用。
主要能力
报告围绕关键词的六大核心维度展开分析：
- 市场潜力：搜索量、需求趋势与增长机会
- 产品特征：常见产品属性、材质与功能
- 用户评论：客户情绪、痛点与满意度驱动因素
- 客户画像：买家人口统计、偏好与行为模式
- 搜索趋势：关键词热度走势与季节性
- 定价分析：价格分布与竞争性定价格局
报告由 AI 基于实时亚马逊数据生成，以结构化 Markdown 文档交付，属于用于决策支持的快照分析，而非实时监控工具。
使用方式
参数：
- site（字符串，必填）：亚马逊市场代码，目前仅支持 US（美国），默认 US。若用户请求其他市场，需告知当前仅覆盖美国市场。
- keyword（字符串，必填）：要分析的关键词。
调用方式：
- API 端点：POST /amazon/opportunity/reportByKeyword（完整参数、响应与错误码见 references/api.md）
- Python 脚本：python scripts/amazon_opportunity_report.py '<JSON 参数>' [--inline]
成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时应先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-opportunity-report-by-keyword-<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 进入上下文。
认证与算力问题：出现未配置 API Key（环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY）、响应 401 或 402 状态码、响应提示算力或余额不足（消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"或类似含义内容）等异常时，采用 references/onboarding.md 引导解决。
算力消耗规则：按动态规则计费，消耗算力 = 输入消耗的算力 + 7.5 × 输出消耗的算力。本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。
适用场景
- 综合性的关键词级市场分析：评估某关键词的市场机会、生成完整洞察报告、了解竞争格局与定价、洞察消费者画像、判断某关键词是否值得进入，以及中文的"选品报告""商业洞察"等市场调研请求。
限制
- 仅支持美国站（site = US）。
- 输出为非结构化内容：返回 Markdown 报告而非结构化 JSON 数据，不能与数据查询工具配合进行二次聚合或分析。
- 处理时间：报告生成涉及 AI 分析，可能比简单数据查询耗时更长。
- 快照数据：报告反映生成时的数据，不会持续更新。
- 不适用于：实时关键词排名跟踪（使用 ABA 或 SIF 工具）、单个产品详情查询（使用产品详情工具）、历史价格跟踪（使用 Keepa）、特定 ASIN 的评论级分析（使用评论工具）、广告/PPC 策略。
- 边界判断：当用户说"市场分析"或"选品调研"，若其想要某关键词市场机会的整体、多维度概览，则适用本技能；若需要具体数据点（精确销量、单个产品详情、关键词随时间排名），应引导至相应的专用工具。
展示规则
- 不做主观建议：直接应用 AI 生成的分析，不额外添加自己的商业建议。
- 说明范围：提醒用户报告基于某一时点快照，仅作决策参考。
- 错误处理：查询失败时，根据 msg 字段说明原因，并建议检查关键词或重试。
- 不做二次分析：本工具输出不能输入数据查询工具进一步处理，用户尝试时应告知。
反馈
当出现以下情况时，通过 Feedback API 自动检测并上报反馈：技能描述的功能或用途与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞扬；任何你认为可改进之处。按 references/api.md 的说明调用反馈 API，不要打断用户流程。