Skill: liangdabiao/amazon-sorftime-research-mcp-skill (version 1.0.0)

--- name: "amazon-analyse" description: "对亚马逊竞品Listing进行全维度穿透分析，包括文案逻辑、评论分析、关键词分析、市场动态等。分析完成后自动保存为Markdown报告文档到reports/目录。Invoke when user uses /amazon-analyse command with a product ASIN." --- # 亚马逊竞品Listing全维度穿透分析 ## 快速参考 | 步骤 | 工具/操作 | 用途 | |------|----------|------| | 1. 验证ASIN | `product_search` | 确认产品存在 | | 2. 产品详情 | `product_detail` | 获取基础数据 | | 3. 流量关键词 | `product_traffic_terms` | 分析流量来源 | | 4. 竞品关键词 | `competitor_product_keywords` | 分析竞品布局 | | 5. 用户评论 | `product_reviews` | 评论情感分析 | | 6. 历史趋势 | `product_trend` | 销量趋势分析 | | 7. 生成报告 | 综合分析 | 输出完整报告 | | 8. 保存文档 | `Write` 工具 | 保存为 MD 文件 | **调用格式**: ```bash curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":N,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{"amzSite":"US","asin":"ASIN"}}}' ``` ## 触发条件 当用户使用 `/amazon-analyse` 命令并提供一个亚马逊竞品 ASIN 时，立即启动此分析流程。 ## 角色设定 你是一位拥有10年经验的"亚马逊顶级运营总监"和"品牌战略官"。你不仅精通A9和Rufus算法，更擅长解析品牌背后的营销心理学与竞争策略。你的任务是透过产品数据表面现象，还原对手的战略布局、运营套路和市场定位。 ## 数据来源 本分析使用 **Sorftime MCP** 服务获取亚马逊数据。 **Sorftime MCP 是一个流式 HTTP 服务**，使用 Server-Sent Events (SSE) 协议返回数据。 **可用工具**： | 工具名 | 功能 | |--------|------| | `product_search` | 产品搜索（验证ASIN用） | | `product_detail` | 产品详情 | | `product_reviews` | 用户评论（最多100条） | | `product_traffic_terms` | 流量关键词 | | `competitor_product_keywords` | 竞品关键词布局 | | `product_trend` | 历史趋势（销量/价格/排名） | | `keyword_detail` | 关键词详情 | | `category_tree` | 类目结构 | **重要提示**： - 所有数据需通过 curl POST 请求获取 - 返回格式为 SSE (event: message + data: JSON) - 中文内容使用 Unicode 转义，需要解码 - 大数据量会保存到临时文件 ## 分析流程 ### 第一步：信息收集与数据抓取 #### 预检查：ASIN 有效性验证 **重要**：在获取数据前，先验证 ASIN 是否存在于 Sorftime 数据库中。 ```bash # 验证 ASIN 是否存在 curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"product_detail","arguments":{"amzSite":"US","asin":"ASIN"}}}' ``` **如果返回 "未查询到对应产品"**： 1. 使用 product_search 工具搜索该 ASIN 或相关关键词 2. 提示用户确认 ASIN 是否正确 3. 检查是否是正确的亚马逊站点 #### 数据获取方式 Sorftime MCP 使用 **Server-Sent Events (SSE)** 协议，需要通过 curl POST 请求调用。 **通用调用格式**： ```bash curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":N,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{"amzSite":"US","asin":"ASIN"}}}' ``` **关键点**： - `id` 每次请求递增 (1, 2, 3...) - 返回格式为 SSE: `event: message\ndata: {...}\n\n` - 数据中的中文是 Unicode 转义格式，需要解码 - 大量数据会被保存到临时文件，需用 Read 工具读取 #### 1. 提取用户输入 - ASIN (必填) - 亚马逊站点 (默认 US，可选：US, GB, DE, FR, CA, JP, ES, IT, MX, AE, AU, BR, SA) - 用户的产品核心优势（用于生成针对性反击建议） #### 数据获取步骤 按照以下顺序获取数据（可并发执行以提高效率）： 1. **product_detail** - 产品详情 2. **product_reviews** - 用户评论 3. **product_traffic_terms** - 流量关键词 4. **competitor_product_keywords** - 竞品关键词布局 5. **product_trend** - 历史销量趋势 > 具体调用格式见下方 **Sorftime MCP 工具参考** 章节 ### 第二步：执行四大维度分析 #### 第一部分：文案构建逻辑与关键词分析 (The Brain) **构建逻辑与方法论：** - 拆解标题、五点描述的文本构建策略 - 分析是基于"痛点触发"、"场景驱动"还是"参数压制" - 识别使用的叙事模板 **关键词情报：** - 从 `product_traffic_terms` 提取产品的核心流量词 - 从 `competitor_product_keywords` 分析竞品在各核心词下的曝光位置 - 识别竞品的自然曝光能力和获流策略 **数据使用：** - 使用 `product_traffic_terms` 数据分析产品流量来源 - 使用 `competitor_product_keywords` 评估竞品关键词布局 - 使用 `keyword_detail` 深入分析核心词指标 #### 第二部分：产品表现与市场定位 (The Face) **产品基础数据：** - 价格、评分、评论数、类目排名 - 月销量、销售额估算 - FBA/FBM 配送方式 **市场表现：** - 使用 `product_trend` 分析历史销量/价格趋势 - 识别季节性波动和促销活动影响 - 评估产品生命周期阶段 **竞争力分析：** - 使用 `product_report` 评估产品在类目中的位置 - Top100排名变化趋势 - 与竞品的价格/功能对比 #### 第三部分：评论定量与定性分析 (The Voice) **量化数据概览：** - 明确分析样本量（最多100条评论） - 统计好评（4-5星）与差评（1-3星）分布 **定性穿透分析：** - **优势聚类：** 用户评论中反复提到的优点 - **差评穿透：** 差评主要体现的核心问题（产品缺陷、描述不符、体验问题） **核心总结 (Top 3)：** - 3条核心优势（用户为何购买） - 3条核心痛点（用户为何退货/差评） - 3条改进建议（我方产品优化方向） #### 第四部分：市场动态与盲区扫描 (The Pulse) **关键词布局分析：** - 从 `competitor_product_keywords` 识别竞品主要获流词 - 分析竞品在热搜词下的排名能力 - 发现竞品的长尾词布局策略 **市场机会识别：** - 识别竞品尚未覆盖的高价值关键词 - 发现评论中用户提到但产品未满足的需求 - 分析类目趋势和竞争格局 **盲区扫描：** - 识别潜在威胁（新品、价格战、品牌差异化） - 发现未被充分满足的用户痛点 ### 第三步：输出结构化报告 #### 报告输出方式 1. **终端输出**：直接在对话中展示完整报告 2. **文档保存**：将报告保存为 Markdown 文件供后续查阅 **报告文件命名规则**： ``` analysis_{ASIN}_{站点}_{日期}.md 例如: analysis_B07PQFT83F_US_20260302.md ``` **保存位置**： ``` 项目目录/reports/ ``` **保存命令**： ```bash # 1. 先检查/创建 reports 目录 mkdir -p reports/ # 2. 生成报告文件路径（使用当前日期） FILENAME="reports/analysis_${ASIN}_${站点}_$(date +%Y%m%d).md" # 3. 使用 Write 工具保存完整报告内容 Write $FILENAME ``` **报告保存最佳实践**： 1. 每次分析都保存独立文件，便于历史对比 2. 文件名包含日期，支持多次分析同一产品 3. 报告开头包含分析时间戳，确保数据时效性 4. 建议定期整理旧报告，归档到 `reports/archive/` 目录 #### 按照以下结构输出完整分析报告： ```markdown # 亚马逊竞品Listing全维度穿透分析报告 ## 分析对象 - ASIN: [ASIN] - 亚马逊站点: [站点] - 分析时间: [时间] - 数据来源: Sorftime MCP ## 第一部分：产品基础数据 ### 核心指标 - 产品标题: [标题] - 品牌: [品牌] - 价格: [价格] - 评分: [评分] / 5.0 - 评论数: [评论数] - 月销量估算: [销量] - 类目排名: [排名] - 配送方式: [FBA/FBM] ### 市场表现 - 历史销量趋势: [分析] - 价格波动规律: [分析] - 生命周期阶段: [判断] ## 第二部分：关键词布局分析 (The Brain) ### 流量关键词 - 核心流量词列表 - 流量来源分布 - 自然曝光能力 ### 竞品关键词布局 - 各热搜词下的排名位置 - 获流关键词数量 - 排名竞争力分析 ### 文案构建逻辑 - 标题策略分析 - 五点描述策略 - 关键词埋点策略 ## 第三部分：评论定性分析 (The Voice) ### 评论数据概览 - 总评分数: [评分] - 好评率: [百分比] - 分析样本: [评论数量] ### 核心优势 Top 3 1. [优势1] 2. [优势2] 3. [优势3] ### 核心痛点 Top 3 1. [痛点1] 2. [痛点2] 3. [痛点3] ### 改进建议 Top 3 1. [建议1] 2. [建议2] 3. [建议3] ## 第四部分：竞争策略分析 (The Pulse) ### 竞争优势 - [分析] ### 竞争劣势 - [分析] ### 市场机会 - [分析] ### 潜在威胁 - [分析] ## 战略反击建议 基于用户产品核心优势，提供针对性的竞争策略建议。 ### 关键词策略 - [建议] ### 定价策略 - [建议] ### 产品优化方向 - [建议] ### Listing优化建议 - [建议] ``` --- ## 参考文档 - [API 工具参考](references/api-tools-reference.md) - 完整的 curl 调用格式和故障排查 - [报告管理](references/report-management.md) - 报告生命周期管理和归档策略 - [Sorftime MCP API](references/sorftime-mcp-api.md) - 完整 API 接口文档 ### 快速工具参考 | 工具 | 用途 | 调用消耗 | |------|------|----------| | `product_detail` | 产品详情 | 1 | | `product_reviews` | 用户评论(最多100条) | 1 | | `product_traffic_terms` | 流量关键词反查 | 1 | | `competitor_product_keywords` | 竞品关键词布局 | 1 | | `product_trend` | 历史趋势 | 1 | | `keyword_detail` | 关键词详情 | 1 | ### 支持的站点 US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR, SA ### 注意事项 1. **ASIN格式**：确保ASIN格式正确，通常为10位字母数字组合 2. **站点选择**：默认使用US站点 3. **评论数据**：最多返回100条评论 4. **并发请求**：可以同时发起多个请求提高效率 5. **API Key安全**：不要在代码中硬编码API Key --- --- ## 参考资料 ### Sorftime MCP 完整 API 文档 详细的接口文档已保存在 `references/sorftime-mcp-api.md`，包含： #### 产品相关接口 (9个) | 接口 | 用途 | 调用消耗 | |------|------|----------| | `product_detail` | 产品详情 | 1 | | `product_variations` | 产品子体明细 | 1 | | `product_trend` | 历史(销量/价格/排名)趋势 | 1 | | `product_reviews` | 用户评论(最多100条) | 1 | | `product_traffic_terms` | 流量关键词反查 | 1 | | `competitor_product_keywords` | 竞品关键词布局 | 1 | | `product_keyword_rank_trend` | 关键词排名趋势 | 1 | | `product_search` | 产品搜索/筛选 | 1 | | `potential_product_search` | 潜力产品搜索 | 1 | #### 类目相关接口 (7个) | 接口 | 用途 | 调用消耗 | |------|------|----------| | `category_name_search` | 类目名称搜索(获取nodeid) | 1 | | `category_tree` | 类目树结构 | 5 | | `category_report` | 类目实时报告(Top100) | 1 | | `category_history_report` | 类目历史报告(最长40天) | 1 | | `category_trend` | 类目趋势(11种趋势类型) | 1 | | `category_market_search` | 类目市场搜索/筛选 | 1 | | `category_keywords` | 类目核心关键词 | 1 | #### 关键词相关接口 (4个) | 接口 | 用途 | 调用消耗 | |------|------|----------| | `keyword_detail` | 关键词详情 | 1 | | `keyword_search_result` | 关键词搜索结果自然位 | 1 | | `keyword_trend` | 关键词历史趋势 | 1 | | `keyword_related_words` | 关键词延伸词/长尾词 | 1 | #### 关键词词库管理 (5个) | 接口 | 用途 | 调用消耗 | |------|------|----------| | `add_keyword` | 添加关键词收藏 | 1 | | `move_keyword` | 移动到收藏夹 | 1 | | `remove_keyword` | 删除关键词 | 1 | | `query_keyword_dict_list` | 查询收藏夹列表 | 1 | | `query_keyword_dict` | 查询收藏的词 | 1 | #### 1688 供货平台 (1个) | 接口 | 用途 | 调用消耗 | |------|------|----------| | `products_1688` | 1688产品搜索/采购成本分析 | 1 | #### TikTok 电商平台 (8个) | 接口 | 用途 | 调用消耗 | |------|------|----------| | `tiktok_product_search` | TikTok产品搜索 | 1 | | `tiktok_product_detail` | TikTok产品详情 | 1 | | `tiktok_product_videos` | TikTok带货视频 | 1 | | `tiktok_product_influencers` | TikTok带货达人分析 | 1 | | `tiktok_product_trend` | TikTok产品趋势 | 1 | | `tiktok_influencer_search` | TikTok达人搜索 | 1 | | `tiktok_category_name_search` | TikTok类目搜索 | 1 | | `tiktok_category_report` | TikTok类目报告 | 1 | ### 调研维度与接口对照表 当用户需要调研特定维度时，使用以下接口： #### 亚马逊产品调研 | 调研维度 | 使用接口 | 关键参数 | |----------|----------|----------| | **产品基础信息** | `product_detail` | asin | | **销量/价格趋势** | `product_trend` | asin, productTrendType | | **用户评价** | `product_reviews` | asin, reviewType | | **流量来源** | `product_traffic_terms` | asin | | **竞品关键词布局** | `competitor_product_keywords` | asin | | **关键词排名监控** | `product_keyword_rank_trend` | asin, keyword | | **子体明细** | `product_variations` | asin | #### 亚马逊关键词调研 | 调研维度 | 使用接口 | 关键参数 | |----------|----------|----------| | **关键词数据分析** | `keyword_detail` | keyword | | **关键词搜索结果** | `keyword_search_result` | searchKeyword | | **关键词历史趋势** | `keyword_trend` | searchKeyword | | **长尾词挖掘** | `keyword_related_words` | searchKeyword | #### 亚马逊类目调研 | 调研维度 | 使用接口 | 关键参数 | |----------|----------|----------| | **类目搜索(获nodeid)** | `category_name_search` | searchName | | **类目分析** | `category_report` | nodeId | | **类目趋势** | `category_trend` | nodeId, trendIndex | | **类目关键词** | `category_keywords` | nodeId | | **类目市场筛选** | `category_market_search` | 多种筛选参数 | #### 亚马逊选品调研 | 调研维度 | 使用接口 | 关键参数 | |----------|----------|----------| | **产品搜索/筛选** | `product_search` | searchName + 筛选参数 | | **潜力产品挖掘** | `potential_product_search` | searchName, price_range等 | #### TikTok 跨平台调研 | 调研维度 | 使用接口 | 关键参数 | |----------|----------|----------| | **相似产品分析** | `tiktok_product_search` | site, searchName | | **TikTok产品详情** | `tiktok_product_detail` | site, productId | | **带货视频分析** | `tiktok_product_videos` | site, productId | | **带货达人分析** | `tiktok_product_influencers` | site, productId | | **产品趋势追踪** | `tiktok_product_trend` | site, productId | | **达人搜索** | `tiktok_influencer_search` | site, searchName | | **TikTok类目分析** | `tiktok_category_report` | site, nodeId | #### 供应链成本调研 | 调研维度 | 使用接口 | 关键参数 | |----------|----------|----------| | **1688采购成本** | `products_1688` | searchName | ### 支持的平台站点 | 平台 | 站点数量 | 支持站点 | |------|----------|----------| | **亚马逊** | 14个 | US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR, SA | | **TikTok** | 6个 | US, GB, MY, PH, VN, ID | | **1688** | - | 国内批发采购平台 | --- *本技能文档版本: v2.2 | 最后更新: 2026-03-03*

path: README.md
content: # Amazon Analyse Skill

> 亚马逊竞品Listing全维度穿透分析工具

对亚马逊竞品进行深度分析，包括文案逻辑、评论情感、关键词布局、市场动态等，生成专业竞品情报报告并自动保存为文档。

---

## 功能特性

| 功能模块 | 说明 |
|----------|------|
| **产品基础分析** | 价格、评分、排名、销量等核心指标 |
| **关键词布局** | 流量来源、自然曝光、竞品关键词分析 |
| **评论情感分析** | 优势聚类、痛点挖掘、改进建议 |
| **市场动态** | 销量趋势、季节性波动、竞争格局 |
| **战略建议** | 关键词策略、定价建议、Listing优化 |
| **报告保存** | 自动生成Markdown文档 |

---

## 快速开始

### 命令格式

```
/amazon-analyse <ASIN> [站点]
```

### 参数说明

| 参数 | 说明 | 可选值 | 默认值 |
|------|------|--------|--------|
| ASIN | 亚马逊产品标识码（10位） | - | 必填 |
| 站点 | 亚马逊站点 | US, GB, DE, FR, CA, JP, ES, IT, MX, AE, AU, BR, SA | US |

### 使用示例

```bash
# 分析美国站产品
/amazon-analyse B07PQFT83F US

# 分析德国站产品
/amazon-analyse B08N5WRWNW DE

# 分析日本站产品
/amazon-analyse B09XXX JP
```

---

## 分析报告内容

### 报告结构

```
1. 产品基础数据
   ├── 核心指标（价格、评分、排名）
   └── 市场表现（销量趋势、生命周期）

2. 关键词布局分析 (The Brain)
   ├── 流量关键词列表
   ├── 竞品关键词布局
   └── 文案构建逻辑

3. 评论定性分析 (The Voice)
   ├── 评论数据概览
   ├── 核心优势 Top 3
   ├── 核心痛点 Top 3
   └── 改进建议 Top 3

4. 竞争策略分析 (The Pulse)
   ├── 竞争优势
   ├── 竞争劣势
   ├── 市场机会
   └── 潜在威胁

5. 战略反击建议
   ├── 关键词策略
   ├── 定价策略
   ├── 产品优化方向
   └── Listing优化建议
```

---

## 输出文件

### 文件位置

```
项目目录/reports/
```

### 命名规则

```
analysis_{ASIN}_{站点}_{日期}.md

例如: analysis_B07PQFT83F_US_20260302.md
```

### 报告示例

```markdown
# 亚马逊竞品Listing全维度穿透分析报告

## 分析对象
- ASIN: B07PQFT83F
- 亚马逊站点: US
- 分析时间: 2026-03-02
- 数据来源: Sorftime MCP

## 第一部分：产品基础数据
### 核心指标
- 产品标题: Disney Store Official Buzz Lightyear...
- 品牌: Disney Store
- 价格: $39.95
- 评分: 4.70 / 5.0
- 评论数: 47,400
- 类目排名: #1 in Action Figures

...
```

---

## 数据来源

本工具使用 **Sorftime MCP** 服务获取亚马逊数据：

- 支持亚马逊14大站点
- 实时产品搜索与详情
- 用户评论分析（最多100条）
- 流量关键词数据
- 历史销量趋势

### Sorftime MCP API

```bash
curl -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{...}}'
```

---

## 配置

### API Key 配置

编辑 `项目目录/.mcp.json`：

```json
{
  "mcpServers": {
    "sorftime": {
      "type": "streamableHttp",
      "url": "https://mcp.sorftime.com?key=YOUR_API_KEY",
      "name": "Sorftime MCP",
      "description": "Sorftime 跨境电商平台数据服务"
    }
  }
}
```

### Sorftime API Key 获取

1. 访问 [Sorftime官网](https://www.sorftime.com)
2. 注册账号并申请API Key
3. 将API Key配置到 `.mcp.json` 文件

---

## 目录结构

```
项目目录/
├── .claude/
│   └── skills/
│       └── amazon-analyse/
│           ├── SKILL.md           # 技能定义文件
│           └── README.md          # 本文档
├── reports/                        # 分析报告输出目录
│   ├── analysis_xxx_US_20260302.md
│   └── archive/
│       ├── 2026/
│       └── 2025/
└── .mcp.json                       # MCP配置文件
```

---

## 故障排查

### 问题：ASIN未找到

**原因**：ASIN不在Sorftime数据库或已下架

**解决**：
1. 确认ASIN格式正确（10位字母数字）
2. 使用product_search工具验证
3. 检查产品是否在该站点上架

### 问题：API请求超时

**原因**：网络问题或API服务异常

**解决**：
1. 检查网络连接
2. 验证API Key是否有效
3. 增加超时时间：`curl --max-time 30`

### 问题：中文显示为乱码

**原因**：Unicode转义字符未解码

**解决**：现代工具会自动解码，或使用Python解码：
```python
import json
print(json.loads('"\\u4EA7\\u54C1"'))
```

---

## 最佳实践

### 1. 定期追踪竞品

建议每月分析一次核心竞品，监控其策略变化：

```bash
# 1月分析
/amazon-analyse B07PQFT83F US  # → analysis_xxx_US_20260115.md

# 2月分析
/amazon-analyse B07PQFT83F US  # → analysis_xxx_US_20260220.md

# 对比两次分析
diff reports/analysis_xxx_US_20260115.md reports/analysis_xxx_US_20260220.md
```

### 2. 多站点对比

同一产品在不同站点的表现可能不同：

```bash
/amazon-analyse B07PQFT83F US  # 美国站
/amazon-analyse B07PQFT83F DE  # 德国站
/amazon-analyse B07PQFT83F JP  # 日本站
```

### 3. 报告归档管理

定期整理旧报告：

```bash
# 归档6个月前的报告
mkdir -p reports/archive/2025/
mv reports/analysis_*_2025*.md reports/archive/2025/
```

---

## 版本历史

| 版本 | 日期 | 更新内容 |
|------|------|----------|
| v2.0 | 2026-03-02 | 添加报告保存功能、故障排查、最佳实践 |
| v1.0 | 2026-02-20 | 初始版本 |

---

## 相关链接

- [Sorftime官网](https://www.sorftime.com)
- [Amazon MWS文档](https://developer.amazonservices.com/)
- [Claude Code文档](https://claude.com/claude-code)

---

## 许可证

MIT License

---

*最后更新: 2026-03-02*


path: references/api-tools-reference.md
content: # Sorftime MCP 工具参考 (curl 调用格式)

**注意**：Sorftime MCP 使用 SSE 协议，所有工具调用格式如下：

```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":N,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{"amzSite":"US","asin":"ASIN"}}}'
```

---

## 核心工具

### 1. 产品详情 (product_detail)
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"product_detail","arguments":{"amzSite":"US","asin":"B07PQFT83F"}}}'
```

### 2. 产品搜索 (product_search) - 用于验证ASIN
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"product_search","arguments":{"amzSite":"US","keyword":"PRODUCT_NAME","page":1}}}'
```

### 3. 用户评论 (product_reviews)
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"product_reviews","arguments":{"amzSite":"US","asin":"ASIN","reviewType":"Both"}}}'
```
- reviewType: "Positive" (4-5星), "Negative" (1-3星), "Both" (全部)

### 4. 流量关键词 (product_traffic_terms)
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"product_traffic_terms","arguments":{"amzSite":"US","asin":"ASIN"}}}'
```

### 5. 竞品关键词布局 (competitor_product_keywords)
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"competitor_product_keywords","arguments":{"amzSite":"US","asin":"ASIN"}}}'
```

### 6. 产品趋势 (product_trend)
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"product_trend","arguments":{"amzSite":"US","asin":"ASIN","productTrendType":"SalesVolume"}}}'
```
- productTrendType: "SalesVolume" (销量), "SalesAmount" (销售额), "Price" (价格), "Rank" (排名)

### 7. 关键词详情 (keyword_detail)
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":7,"method":"tools/call","params":{"name":"keyword_detail","arguments":{"amzSite":"US","keyword":"KEYWORD"}}}'
```

---

## 并发请求最佳实践

为了提高效率，可以同时发起多个请求：

```bash
# 并发获取所有数据（使用不同的 id）
curl ... '{"id":1,...}' &
curl ... '{"id":2,...}' &
curl ... '{"id":3,...}' &
curl ... '{"id":4,...}' &
curl ... '{"id":5,...}' &
curl ... '{"id":6,...}' &
wait
```

或在同一行使用 `&&` 连接（顺序执行）：
```bash
(curl ... '{"id":1,...}' && curl ... '{"id":2,...}' && ...)
```

---

## 支持的亚马逊站点

US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR, SA

---

## 故障排查

### 问题1：ASIN 未找到

**现象**：返回 "未查询到对应产品，请检查传入产品ASIN"

**解决方案**：
1. 使用 product_search 工具验证：
```bash
curl -s -X POST "https://mcp.sorftime.com?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"product_search","arguments":{"amzSite":"US","keyword":"ASIN_OR_KEYWORD","page":1}}}'
```

2. 检查 ASIN 格式是否正确（10位字母数字）
3. 确认产品是否在该站点上架
4. 尝试其他站点

### 问题2：数据保存到临时文件

**现象**：返回 "Output too large... Full output saved to: ..."

**解决方案**：
```bash
# 使用 Read 工具读取临时文件
Read <file_path>
```

### 问题3：Unicode 转义字符

**现象**：中文显示为 `\u4EA7\u54C1ASIN\u7801`

**解决方案**：
- 大多数现代工具会自动解码
- 如果需要手动解码，使用 Python：
```python
import json
print(json.loads('"\\u4EA7\\u54C1ASIN\\u7801"'))
```

### 问题4：MCP 工具不响应

**现象**：curl 请求超时或无响应

**解决方案**：
1. 检查网络连接
2. 验证 API Key 是否有效
3. 检查 Sorftime 服务状态：`curl -I https://mcp.sorftime.com`
4. 增加超时时间：`curl --max-time 30`

### 问题5：部分数据缺失

**现象**：评论、趋势数据返回 "没有相关数据"

**解决方案**：
- 新产品可能没有历史趋势数据
- 部分产品可能没有评论数据
- 继续使用可用数据进行分析，标注缺失部分


path: references/report-management.md
content: # 报告管理

## 目录结构

```
项目目录/
├── reports/
│   ├── analysis_B07PQFT83F_US_20260302.md
│   ├── analysis_B08N5WRWNW_US_20260302.md
│   └── archive/
│       ├── 2025/
│       │   ├── analysis_xxx_US_20251215.md
│       │   └── ...
│       └── 2024/
│           └── ...
└── .claude/
    └── skills/
        └── amazon-analyse/
```

## 报告生命周期

| 阶段 | 时间范围 | 处理方式 |
|------|----------|----------|
| **活跃期** | 最近30天 | 保持在 `reports/` 根目录 |
| **参考期** | 1-6个月 | 移至 `reports/archive/YYYY/` |
| **归档期** | 6个月以上 | 可压缩归档或删除 |

## 报告对比分析

**纵向对比**：同一ASIN不同时期的报告
```bash
# 对比同一产品在不同时间的数据变化
diff reports/analysis_xxx_US_20260101.md \
     reports/analysis_xxx_US_20260301.md
```

**横向对比**：不同ASIN在同一时期的报告
```bash
# 对比竞品之间的数据差异
ls -la reports/analysis_*_US_20260302.md
```

## 报告应用场景

1. **竞品追踪**：定期分析同一竞品，监控其策略变化
2. **市场研究**：积累多个产品报告，发现行业趋势
3. **团队分享**：将报告发送给运营、产品团队
4. **决策支持**：基于历史数据制定定价、选品策略

## 报告导出格式

报告默认保存为 Markdown 格式，可转换为：
- PDF（用于打印/分享）
- HTML（用于网页展示）
- Excel（用于数据提取）

## 报告保存最佳实践

1. 每次分析都保存独立文件，便于历史对比
2. 文件名包含日期，支持多次分析同一产品
3. 报告开头包含分析时间戳，确保数据时效性
4. 建议定期整理旧报告，归档到 `reports/archive/` 目录

## 报告文件命名规则

```
analysis_{ASIN}_{站点}_{日期}.md
例如: analysis_B07PQFT83F_US_20260302.md
```

## 保存位置

```
项目目录/reports/
```

## 保存命令

```bash
# 1. 先检查/创建 reports 目录
mkdir -p reports/

# 2. 生成报告文件路径（使用当前日期）
FILENAME="reports/analysis_${ASIN}_${站点}_$(date +%Y%m%d).md"

# 3. 使用 Write 工具保存完整报告内容
Write $FILENAME
```


path: references/sorftime-mcp-api.md
content: # Sorftime MCP API 接口文档

## 调用方式
```bash
curl -s -X POST "https://mcp.sorftime.com?key={API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":N,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{...}}}'
```

---

## 一、产品相关接口

### 1.1 产品详情 (product_detail)
**调用消耗**: 1

**用途**: 查询亚马逊电商平台上产品的详情数据

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 US/GB/DE/FR/IN/CA/JP/ES/IT/MX/AE/AU/BR/SA |
| asin | string | 是 | 产品ASIN |

**返回数据**: 标题、价格、评分、评论数、品牌、类目、排名、销量等

---

### 1.2 产品子体明细 (product_variations)
**调用消耗**: 1

**用途**: 查询亚马逊电商平台产品的子体明细

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| asin | string | 是 | 产品ASIN（仅支持单ASIN） |

---

### 1.3 产品历史趋势 (product_trend)
**调用消耗**: 1

**用途**: 查询产品的历史趋势数据，支持月销量/月销额/价格/排名趋势

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| asin | string | 是 | 产品ASIN |
| productTrendType | string | 否 | 月销量趋势/月销额趋势/价格趋势/所属大类排名趋势 |

---

### 1.4 产品评论 (product_reviews)
**调用消耗**: 1

**用途**: 查询产品近一年的用户留评，最多返回100条

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| asin | string | 是 | 产品ASIN |
| reviewType | string | 否 | 全部（不限星级）/积极评论（4-5星）/消极评论（1-3星） |

---

### 1.5 产品流量关键词 (product_traffic_terms)
**调用消耗**: 1

**用途**: 产品反查关键词，返回产品在哪些关键词前3页中曝光

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| asin | string | 是 | 产品ASIN |
| page | int | 否 | 页码索引，默认第1页，每页50条 |

---

### 1.6 竞品关键词布局 (competitor_product_keywords)
**调用消耗**: 1

**用途**: 获取竞品在各核心关键词下的曝光位置（自然曝光）

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| asin | string | 是 | 产品ASIN |
| page | int | 否 | 页码索引，默认第1页 |

---

### 1.7 产品关键词排名趋势 (product_keyword_rank_trend)
**调用消耗**: 1

**用途**: 产品在指定关键词下曝光的排名趋势

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| asin | string | 是 | 产品ASIN |
| keyword | string | 是 | 关键词 |
| page | int | 否 | 页码索引，默认第1页 |

---

### 1.8 产品搜索 (product_search)
**调用消耗**: 1

**用途**: 搜索或筛选亚马逊产品，支持多维度筛选实现选品功能

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchName | string | 否 | 搜索产品名称 |
| brand | string | 否 | 筛选品牌 |
| delivery_type | string | 否 | 发货方式 |
| month_sales_volume_range | string | 否 | 月销量范围[x,y] |
| price_range | string | 否 | 价格范围[x,y] |
| property_name | string | 否 | 标题或属性包含词 |
| ratings_count_range | string | 否 | 评论数量范围[x,y] |
| ratings_range | string | 否 | 星级范围[x,y] |
| seasonal_popular_product | string | 否 | 热销旺季产品 |
| seller_name | string | 否 | 卖家名称 |
| subcategory_rank_range | string | 否 | 细分类目排名范围[x,y] |
| variation_count_range | string | 否 | 子体数量范围[x,y] |
| sortby_potential_index | string | 否 | 按潜力指数排序 |

---

### 1.9 潜力产品搜索 (potential_product_search)
**调用消耗**: 1

**用途**: 搜索亚马逊平台上的潜力产品

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 支持的站点 US/GB/DE |
| searchName | string | 否 | 产品名称 |
| price_range | string | 否 | 价格范围[x,y] |
| month_sales_volume_range | string | 否 | 月销量范围[x,y] |
| delivery_type | string | 否 | 发货方式 |

---

## 二、类目相关接口

### 2.1 类目名称搜索 (category_name_search)
**调用消耗**: 1

**用途**: 基于名称查询细分类目市场，返回nodeid和name

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchName | string | 是 | 类目市场名称 |

---

### 2.2 类目树结构 (category_tree)
**调用消耗**: 5

**用途**: 查询类目产品的特点

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchName | string | 是 | 类目名称 |

---

### 2.3 细分类目报告 (category_report)
**调用消耗**: 1

**用途**: 细分类目实时数据报告，基于Top100产品统计

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| nodeId | string | 否 | 细分类目nodeid |

---

### 2.4 细分类目历史报告 (category_history_report)
**调用消耗**: 1

**用途**: 细分类目历史指定时间段数据报告

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| nodeId | string | 否 | 细分类目nodeid |
| startDate | string | 是 | 起始时间(yyyy-MM-dd) |
| endDate | string | 否 | 截止时间，最长40天 |

---

### 2.5 类目趋势 (category_trend)
**调用消耗**: 1

**用途**: 查询类目市场趋势数据，基于Top100统计

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| nodeId | string | 是 | 细分类目nodeid |
| trendIndex | string | 是 | 趋势类型（见下方） |

**趋势类型 (trendIndex)**:
- 类目月销量趋势
- 品牌数量趋势
- 卖家数量趋势
- 平均售价趋势
- 平均评论数量趋势
- 平均星级趋势
- 上架3个月内新品销量占比趋势
- 亚马逊自营销量占比趋势
- 销量前3的产品销量占比趋势
- 销量前3的品牌销量占比趋势
- 销量前3的卖家销量占比趋势

---

### 2.6 类目市场搜索 (category_market_search)
**调用消耗**: 1

**用途**: 查询或搜索细分类目市场

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchName | string | 否 | 类目市场名称 |
| month_sales_volume_range | string | 否 | 月销量范围[x,y] |
| ratings_range | string | 否 | 星级范围[x,y] |
| ratings_count_range | string | 否 | 评论数范围[x,y] |
| price_range | string | 否 | 平均销售价范围[x,y] |
| seasonal_popular_product | string | 否 | 热销旺季 |
| top3Product_sales_share | string | 否 | Top3产品销量占比[x,y](0-1) |
| amazonOwned_sales_share | string | 否 | 亚马逊自营占比[x,y](0-1) |
| top100_top400_sales_share | string | 否 | Top100在Top400占比[x,y](0-1) |
| newproduct_sales_share | string | 否 | 新品销量占比[x,y](0-1) |

---

### 2.7 类目核心关键词 (category_keywords)
**调用消耗**: 1

**用途**: 查询细分类目市场的核心关键词

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| nodeId | string | 是 | 细分类目nodeid |
| page | int | 否 | 页码索引，默认第1页 |

---

## 三、关键词相关接口

### 3.1 关键词详情 (keyword_detail)
**调用消耗**: 1

**用途**: 查询热搜关键词详情

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| keyword | string | 是 | 查询的关键词 |

---

### 3.2 关键词搜索结果 (keyword_search_result)
**调用消耗**: 1

**用途**: 查询关键词搜索结果自然位产品清单

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchKeyword | string | 是 | 查询的关键词 |
| page | int | 否 | 页码索引，默认第1页 |

---

### 3.3 关键词历史趋势 (keyword_trend)
**调用消耗**: 1

**用途**: 查询关键词历史趋势（搜索量/搜索排名/CPC价格）

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchKeyword | string | 是 | 查询的关键词 |

---

### 3.4 关键词延伸词 (keyword_related_words)
**调用消耗**: 1

**用途**: 查询关键词的延伸词，用于发现长尾词

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | 亚马逊站点 |
| searchKeyword | string | 是 | 查询的关键词 |
| page | int | 否 | 页码索引，默认第1页 |

---

## 四、关键词词库管理接口

### 4.1 添加关键词收藏 (add_keyword)
**调用消耗**: 1

**参数**: site, keyword, dict(可选)

---

### 4.2 移动关键词到收藏夹 (move_keyword)
**调用消耗**: 1

**参数**: site, keyword, toDict, fromDict(可选)

---

### 4.3 删除关键词收藏 (remove_keyword)
**调用消耗**: 1

**参数**: site, keyword, dict(可选)

---

### 4.4 查询收藏夹列表 (query_keyword_dict_list)
**调用消耗**: 1

**参数**: site, page

---

### 4.5 查询收藏的词 (query_keyword_dict)
**调用消耗**: 1

**参数**: site, dict(可选，all查询全部), page

---

## 五、1688 供货平台接口

### 5.1 1688产品搜索 (products_1688)
**调用消耗**: 1

**用途**: 通过1688平台找产品的采购货源，分析产品采购成本价

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| searchName | string | 是 | 查询的产品名称 |
| page | int | 否 | 页码索引，默认第1页，每页50条 |

---

## 六、TikTok 电商平台接口

### 6.1 TikTok产品搜索 (tiktok_product_search)
**调用消耗**: 1

**用途**: 查询产品在TikTok平台上的相似产品，分析销售情况

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| searchName | string | 是 | 查询的产品名称 |
| page | int | 是 | 页码索引，默认第1页，每页50条 |

---

### 6.2 TikTok产品详情 (tiktok_product_detail)
**调用消耗**: 1

**用途**: 查询TikTok平台产品详情

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| productId | string | 是 | 产品ID |

---

### 6.3 TikTok带货视频 (tiktok_product_videos)
**调用消耗**: 1

**用途**: 查询TikTok平台产品的带货视频

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| productId | string | 是 | 产品ID |
| page | int | 是 | 页码索引，默认第1页，每页50条 |

---

### 6.4 TikTok带货达人分析 (tiktok_product_influencers)
**调用消耗**: 1

**用途**: TikTok平台产品的带货达人分析

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| productId | string | 是 | 产品ID |

---

### 6.5 TikTok产品趋势 (tiktok_product_trend)
**调用消耗**: 1

**用途**: 查询TikTok平台产品趋势，返回销量、价格、星级、评论数量、新增带货视频数、新增带货达人数

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| productId | string | 是 | 产品ID |

---

### 6.6 TikTok达人搜索 (tiktok_influencer_search)
**调用消耗**: 1

**用途**: 按产品名称搜索相关带货达人

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| searchName | string | 是 | 搜索的产品名称 |
| page | int | 是 | 页码索引，默认第1页，每页50条 |

---

### 6.7 TikTok类目搜索 (tiktok_category_name_search)
**调用消耗**: 1

**用途**: 按名称搜索TikTok上相关类目市场，返回类目市场名称和nodeid

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| searchName | string | 是 | 搜索的产品名称 |

---

### 6.8 TikTok类目报告 (tiktok_category_report)
**调用消耗**: 1

**用途**: 查询TikTok电商平台指定类目的类目数据报告

**参数**:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| site | string | 是 | TikTok站点 US/GB/MY/PH/VN/ID |
| nodeId | string | 是 | 类目市场nodeid，可通过tiktok_category_name_search获得 |

---

## 支持的平台站点

### 亚马逊 (14个站点)
`US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`

### TikTok (6个站点)
`US`, `GB`, `MY`, `PH`, `VN`, `ID`

### 1688 供货平台
国内批发采购平台

## 调用限制
- 大部分接口调用消耗: 1
- category_tree: 5
- 返回数据为SSE格式，需解析

---

*最后更新: 2026-03-03*


path: references/sorftime_mcp文档.txt
content: # sorftime mcp

查询亚马逊电商平台细分类目市场趋势数据，基于类目Top100产品统计
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
nodeId
（必填）查询类目的nodeid，可先从category_name_search获取相关类目nodeid
trendIndex
（必填）所查询的趋势类型 (类目月销量趋势, 品牌数量趋势, 卖家数量趋势, 平均售价趋势, 平均评论数量趋势, 平均星级趋势, 上架3个月内新品销量占比趋势, 亚马逊自营销量占比趋势, 销量前3的产品销量占比趋势, 销量前3的品牌销量占比趋势, 销量前3的卖家销量占比趋势)
基于名称查询亚马逊电商平台细分类目市场，返回相关细分类目的nodeid和name
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchName
（必填）需要查询的类目市场名称
亚马逊电商平台细分类目实时数据报告，基于细分类目销量Top100产品统计
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
nodeId
（可选）选填，细分类目nodeid，查询这个指定细分类目数据。可先从category_name_search获取相关类目nodeid
查询亚马逊电商平台细分类目市场的核心关键词
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
nodeId
（必填）基于nodeid查询指定细分类目市场，可先从category_name_search获取相关类目nodeid
page
（可选）查询结果的页码索引，默认为第1页。每页返回50条数据
查询或搜索亚马逊电商平台上的细分类目市场，用于获得类目细分市场基本情况。
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchName
（可选）可选参数，类目市场名称
month_sales_volume_range
（可选）可选参数，格式:"[x,y]"。如果指定表示筛选月销量在"x-y"范围内的细分类目市场
ratings_range
（可选）可选参数，格式:"[x,y]"。如果指定表示筛选星级在"x-y"范围内的细分类目市场
ratings_count_range
（可选）可选参数，格式:"[x,y]"。如果指定表示筛选评论数量在"x-y"范围内的细分类目市场
price_range
（可选）可选参数，格式:"[x,y]"。如果指定如果指定表示筛选平均销售价在"x-y"范围内的细分类目市场
seasonal_popular_product
（可选）可选参数，如果指定表示筛选在指定月份为热销旺季的细分类目
top3Product_sales_share
（可选）可选参数，格式:"[x,y]"，x和y取值为0-1之间表示百分比数。如果指定表示筛选Top3产品在Top100产品的销量占比（销量垄断系数）在"x-y"范围内的细分类目市场
amazonOwned_sales_share
（可选）可选参数，格式:"[x,y]"。x和y取值在0-1之间表示百分比数。如果指定表示筛选在Top100产品中亚马逊自营产品的销量占比（卖家垄断系数）在"x-y"范围内的细分类目市场
top100_top400_sales_share
（可选）可选参数，格式:"[x,y]"。x和y取值在0-1之间表示百分比数。如果指定表示筛选Top100产品在Top400产品中的销量占比（占比低表示长尾市场）在"x-y"范围内的细分类目市场
newproduct_sales_share
（可选）可选参数，格式:"[x,y]"。x和y取值在0-1之间表示百分比数。如果指定表示筛选Top100产品中上架时间在3个月内产品的销量占比（新品销量占比）在"x-y"范围内的细分类目市场
亚马逊电商平台细分类目历史指定时间段数据报告，基于历史指定时间段细分类目销量Top100产品统计
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
nodeId
（可选）选填，细分类目nodeid，查询这个指定细分类目数据。可先从category_name_search获取相关类目nodeid
startDate
（必填）查看历史数据，指定起始时间（格式：yyyy-MM-dd）
nodeId
（可选）选填，查看历史数据，当指定起始时间后（startDate）后用于指定查询截止时间，支持最长40天数据组合。



查询亚马逊平台上类目产品的特点
调用消耗：5
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchName
（必填）查询的类目名称
查询亚马逊电商平台上产品的详情数据
调用消耗：1
site
（必填）亚马逊站点, 支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
asin
（必填）产品ASIN
查询亚马逊电商平台产品的子体明细
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
ASIN
（必填）产品ASIN，仅支持单ASIN查询
查询亚马逊电商平台产品的历史趋势数据，支持月销量/月销额/价格/所属大类排名趋势
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
ASIN
（必填）产品ASIN，仅支持单ASIN查询
productTrendType
（可选）所需查询的产品趋势类型 (月销量趋势, 月销额趋势, 价格趋势, 所属大类排名趋势)。
查询亚马逊电商平台产品的近一年的用户留评，最多返回100条评论
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
ASIN
（必填）产品ASIN，仅支持单ASIN查询
ReviewType
（可选）查询评论意见倾向：全部（不限星级，默认），积极评论（4-5星），消极评论（1-3星）
搜索亚马逊电商平台上的潜力产品
调用消耗：1
site
（必填）支持的亚马逊站点 `US`, `GB`, `DE`
searchName
（可选）如果指定，将按此名称搜索相关产品
price_range
（可选）格式:"[x,y]"，如果指定，将筛选指定价格范围的产品。数组第一个数字为筛选价格起始值，第二个筛选价格截止值，也可以只指定第一个数字表示价格高于此，或只指定第二个表示价格低于此。
month_sales_volume_range
（可选）格式:"[x,y]"，如果指定，将筛选指定月销量范围的产品。数组第一个数字为筛选月销量起始值，第二个筛选月销量截止值，也可以只指定第一个数字表示月销量高于此，或只指定第二个表示月销量低于此。
delivery_type
（可选）如果指定，筛选产品的发货方式
查询或搜索亚马逊电商平台上的产品，也可以通过多个数据维度的筛选实现选品功能。默认按月销量倒序排列
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchName
（可选）将按此名称搜索相关产品
brand
（可选）将筛选此品牌的产品
delivery_type
（可选）筛选产品的发货方式
month_sales_volume_range
（可选）格式:"[x,y]"。如果指定表示筛选月销量在"x-y"范围内的产品
price_range
（可选）格式:"[x,y]"。如果指定表示筛选销售价在"x-y"范围内的产品
property_name
（可选）将筛选产品标题或属性中包含指定property的产品
ratings_count_range
（可选）格式:"[x,y]"。如果指定表示筛选评论数量在"x-y"范围内的产品
ratings_range
（可选）格式:"[x,y]"。如果指定表示筛选星级在"x-y"范围内的产品
seasonal_popular_product
（可选）将筛选在指定月份为热销旺季的产品
seller_name
（可选）将筛选此卖家的产品
subcategory_rank_range
（可选）格式:"[x,y]"，如果指定表示筛选在细分类目中销量排名在"x-y"范围内的产品
variation_count_range
（可选）格式:"[x,y]"，如果指定表示筛选产品子体数量范围在"x-y"范围内的产品
sortby_potential_index
（可选）产品的潜力指数（隐赚指数），若指定将按产品潜力从高到低排列
亚马逊电商平台产品反查关键词，返回近期产品在哪些关键词前3页中曝光，按最后曝光时间倒序排列。
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
asin
（必填）产品ASIN
page
（可选）查询结果的页码索引，默认为第1页。每页返回50条数据
获取亚马逊电商平台产品的竞品在各核心关键词下的曝光位置，这里只会使用自然曝光计算（排除了广告曝光），以此可以分析此产品获取流量的能力（例如：在搜索量大的核心词下都有排名靠前的曝光，就说明获取流量能力强；反之则有待加强）
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
asin
（必填）产品ASIN
page
（可选）查询结果的页码索引，默认为第1页。每页返回50条数据。
亚马逊电商平台产品在指定关键词下曝光的排名趋势，按曝光时间倒序排列。
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `IN`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
ASIN
（必填）产品ASIN
keyword
（必填）关键词
page
（可选）查询结果的页码索引，默认为第1页。每页返回50条数据



查询亚马逊电商平台上热搜关键词详情
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
keyword
（必填）查询的关键词
查询亚马逊电商平台上热搜关键词搜索结果自然位产品清单
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchKeyword
（必填）查询的关键词
page
（可选）查询结果的页码索引，默认为第1页。每页返回50条数据。
查询亚马逊电商平台上热搜关键词历史趋势，支持搜索量、搜索排名、cpc价格趋势
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchKeyword
（必填）查询的关键词
查询亚马逊电商平台上热搜关键词的延伸词关键词，可用于卖家查询相关关键词、发现长尾词或挖掘个性化需求
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
searchKeyword
（必填）查询的关键词
page
（可选）查询结果的页码索引，默认为第1页。每页返回50条数据
在我的亚马逊平台关键词词库中添加关键词收藏
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
keyword
（必填）需要收藏的词
dict
（可选）选填，如果指定，将添加词到指定收藏夹
移动我的亚马逊平台关键词词库中收藏的关键词到指定收藏夹，如果收藏夹不存在会新建
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
keyword
（必填）需要移动的词
toDict
（必填）移动到的收藏夹名称
fromDict
（可选）选填，如果指定，将移动指定收藏夹下的词
删除我的亚马逊平台关键词词库中收藏的指定关键词
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
keyword
（必填）需要删除的词
dict
（可选）选填，如果指定，将删除指定收藏夹下的词
查询我的亚马逊平台关键词词库的收藏夹列表
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
page
（必填）查询结果的页码索引，默认为第1页。每页返回50条数据
查询我的亚马逊平台关键词词库的词
调用消耗：1
site
（必填）亚马逊站点，支持 `US`, `GB`, `DE`, `FR`, `CA`, `JP`, `ES`, `IT`, `MX`, `AE`, `AU`, `BR`, `SA`
dict
（可选）选填，如果指定，查询指定收藏夹下的词；如需查询全部词，指定传值`all`
page
（必填）查询结果的页码索引，默认为第1页。每页返回50条数据

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)