Skip to content

LeoYeAI/agent-master-skills / skills/amazon-sorftime-research-mcp-skill

amazon-analyse

Verified

对亚马逊竞品Listing进行全维度穿透分析,包括文案逻辑、评论分析、关键词分析、市场动态等。分析完成后自动保存为Markdown报告文档到reports/目录。Invoke when user uses /amazon-analyse command with a product ASIN.

FileKindSize
README.mdmarkdown5.8 KB
SKILL.mdskill md15.8 KB
_meta.jsonconfig325 B
references/api-tools-reference.mdmarkdown4.9 KB
references/report-management.mdmarkdown2.3 KB
references/sorftime-mcp-api.mdmarkdown13.3 KB
references/sorftime_mcp文档.txtmarkdown12.7 KB

references/api-tools-reference.md

View on GitHub
# 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:部分数据缺失

**现象**:评论、趋势数据返回 "没有相关数据"

**解决方案**:
- 新产品可能没有历史趋势数据
- 部分产品可能没有评论数据
- 继续使用可用数据进行分析,标注缺失部分
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall