mcpField
L
linkfox-amazon-opportunity-report

linkfox-amazon-opportunity-report

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

关于 linkfox-amazon-opportunity-report

面向 Amazon 卖家的关键词市场报告 Skill,帮助评估选品与市场进入机会。它从六个维度分析关键词并生成 Markdown 快照报告,目前仅支持美国站。

主要功能

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

适用场景

  1. 01评估关键词市场机会
  2. 02了解竞争格局与价格
  3. 03探索客户画像和评论主题

安装

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

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

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

包含的文件

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

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

详细介绍

Amazon 市场机会报告

此技能可指导你生成针对 Amazon 关键词的全面 AI 市场洞察报告,帮助卖家基于数据做出选品和市场进入决策。

核心概念

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

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

报告由 AI 根据 Amazon 实时数据生成,并以结构化 Markdown 文档的形式交付。这是用于辅助决策的快照分析,并非实时监控工具。

参数

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

支持的市场

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

API 用法

此工具会调用 LinkFox 工具网关 API。有关调用约定、请求参数和响应结构,请参阅 references/api.md。你也可以直接运行 scripts/amazon_opportunity_report.py 执行查询。

使用示例

1. 基础市场机会报告

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

2. 利基产品调研

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

3. 基于趋势的选品

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

展示规则

  1. 直接展示报告:API 会在 stdout 字段中返回 Markdown 格式的报告,请原样展示给用户
  2. 不提供主观建议:展示 AI 生成的分析,不要添加你自己的商业建议
  3. 说明范围:提醒用户,报告基于某一时间点的快照,可作为决策参考
  4. 错误处理:查询失败时,根据 msg 字段说明原因,并建议检查关键词或重试
  5. 不进行二次分析:此工具的输出无法传入数据查询工具进行进一步处理;如果用户尝试这样做,请告知他们这一点

重要限制

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

用户表达与场景速查

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

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

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

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

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

反馈:

出现以下任一情况时,通过 Feedback API 自动检测并提交反馈:

  1. 此技能所描述的功能或用途与实际行为不符
  2. 此技能的结果与用户意图不符
  3. 用户表达了对这项技能的不满或赞扬
  4. 你认为有任何可以改进之处

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

处理大型响应

为避免超出 Agent 上下文,将响应保存到磁盘,并仅提取所需字段:

python scripts/response_io.py run --script scripts/amazon_opportunity_report.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

将 --out-dir 指定到任何 Git 工作树之外的位置(例如 Unix 系统上的 /tmp/...,Windows 系统上的 %TEMP%/...)。保存的响应可能包含个人身份信息、定价或身份验证敏感数据——请勿提交这些文件。文件不会自动删除;任务完成后请清理。

run 会将完整响应写入文件,并仅输出模式预览和文件路径。read 会筛选指定字段;可使用 --limit/--offset 切片,并使用 --format json|jsonl|csv|table 指定输出格式。

优先采用此模式的情况——根据响应特征自行判断,例如:

  • 每条记录的字段较多,或包含不需要的字段
  • 批量 / 分页结果(每次调用返回多个项目)
  • 长文本字段(描述、评论、HTML、时间序列)
  • 输出会在后续步骤中重复使用,而非立即使用

对于规模较小且只使用一次的响应,直接调用主脚本即可。

⚠️ 预览是截断后的模式和示例,并非完整数据。任何字段级决策都必须通过 read 从已保存的文件中读取。


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

评论

支持 Markdown