mcpField
L
linkfox-amazon-opportunity-report-by-keyword

linkfox-amazon-opportunity-report-by-keyword

github.com/linkfox-ai营销与增长113242 次安装2 周前更新
代码仓库

关于 linkfox-amazon-opportunity-report-by-keyword

LinkFox 技能可为卖家生成 Amazon 关键词市场报告，辅助选品和评估市场进入机会。报告覆盖六个维度，目前仅支持美国站，反映生成时的数据快照。

主要功能

  1. 01六维关键词市场分析
  2. 02搜索需求与趋势梳理
  3. 03产品与客户洞察
  4. 04评论情绪与价格分析
  5. 05生成 Markdown 报告

适用场景

  1. 01评估关键词的美国站市场机会
  2. 02了解客户需求和产品特征
  3. 03查看价格与竞争情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-report-by-keyword

安装后在 Claude Code 中输入/linkfox-amazon-opportunity-report-by-keyword确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
scripts/
amazon_opportunity_report.py
onboarding.py

详细介绍

Amazon 市场机会报告

此技能将指导你如何为 Amazon 关键词生成全面的 AI 驱动市场洞察报告，帮助卖家基于数据做出选品和市场进入决策。

核心概念

此工具通过分析 Amazon 关键词的六个核心维度，生成全面的商业洞察报告：

  1. 市场潜力 - 搜索量、需求趋势和增长机会
  2. 产品特征 - 常见的产品属性、材料和功能
  3. 用户评论 - 客户情绪、痛点和满意度驱动因素
  4. 客户画像 - 买家人口统计特征、偏好和行为模式
  5. 搜索趋势 - 关键词热度走势和季节性
  6. 定价分析 - 价格分布和竞争定价格局

报告由 AI 基于 Amazon 实时数据生成，并以结构化 Markdown 文档的形式提供。这是用于辅助决策的快照分析，不是实时监控工具。

参数

参数类型必填描述默认值
sitestring是Amazon 市场代码（目前仅支持 US）US
keywordstring是要分析的搜索关键词-

支持的市场

目前仅支持 US（美国）。请始终将 site 设为 US。如果用户请求其他市场，请告知他们此工具目前仅覆盖美国市场。

调用方式

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

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

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

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

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

使用示例

1. 基础市场机会报告

帮我搜索美国站，关键词是 hair mousse travel size 的商业洞察报告

2. 利基产品调研

帮我生成美国站关键词 magnetic shelves for whiteboard 的商业洞察报告

3. 基于趋势的选品

我想了解美国站 solar power ac unit 这个关键词的商业洞察，帮我生成报告

展示规则

  • 不提供主观建议：呈现 AI 生成的分析，不添加自己的商业建议
  • 明确范围：提醒用户，报告基于某一时间点的快照，仅供决策参考
  • 错误处理：查询失败时，根据 msg 字段说明原因，并建议检查关键词或重试
  • 不进行二次分析：此工具的输出不能传入数据查询工具进行进一步处理——如果用户尝试这样做，请告知他们

重要限制

  • 仅限 US：目前仅支持美国市场（site = US）
  • 非结构化输出：返回 Markdown 报告，而非结构化 JSON 数据。不能与数据查询工具配合进行二次聚合或分析
  • 处理时间：报告生成涉及 AI 分析，可能比简单的数据查询耗时更长
  • 快照数据：报告反映生成时的数据，不会持续更新

用户表达与场景快速参考

适用 - 全面的关键词级市场分析：

用户表达场景
"帮我分析这个关键词的市场机会"市场机会评估
"为 XX 生成一份市场洞察报告"完整洞察报告
"XX 的竞争格局如何"竞争与定价分析
"XX 产品的消费者画像"客户行为洞察
"XX 关键词值得进入吗"市场进入评估
"选品报告", "商业洞察"中文市场研究请求

不适用 - 需求超出综合报告生成范围：

  • 实时关键词排名追踪（使用 ABA 或 SIF 工具）
  • 单个商品详情查询（使用商品详情工具）
  • 历史价格追踪（使用 Keepa）
  • 针对特定 ASIN 的评论级分析（使用评论工具）
  • 广告 / PPC 策略

边界判断：当用户说“市场分析”或“产品研究”时，如果他们想全面、多维地了解某个关键词的市场机会，则适用此技能。如果他们需要具体数据点（确切的销量、单个商品详情、随时间变化的关键词排名），请引导他们使用相应的专用工具。

算力消耗规则

按动态规则计费：消耗算力 = 输入消耗的算力 + 7.5 × 输出消耗的算力。

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

反馈：

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

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

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

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

评论

支持 Markdown