alphashop-sel-ranking
查询Amazon和TikTok平台的关键词榜单、商品榜单和类目数据,支持热销榜、飙升榜、新品榜、蓝海词榜等多种类型,帮助快速发现跨境选品机会。
SKILL.mdskills/alphashop-sel-ranking/SKILL.md
GitHub⚠️ 重要提示:
本 skill 使用 AlphaShop API,需要配置:
ALPHASHOP_ACCESS_KEYALPHASHOP_SECRET_KEY不要与
1688-ranking混淆! 如果你看到要求ALI1688_APP_KEY、ALI1688_REFRESH_TOKEN等变量,说明你运行了错误的 skill。两个 skill 的区别:
1688-ranking: 使用 1688 官方 Open API(OAuth 认证,需要 ALI1688_* 变量)alphashop-sel-ranking: 使用 AlphaShop 平台 API(JWT 认证,需要 ALPHASHOP_* 变量)
配置
环境变量
需要配置 AlphaShop API 凭证(与 alphashop-sel-newproduct 共享):
重要提示: userId 参数需要使用 Java Long 类型范围的数字(建议使用大于 10 位的整数),例如 1234567890123。小整数如 123456 会导致参数校验失败。
{
skills: {
entries: {
"alphashop-sel-ranking": {
env: {
ALPHASHOP_ACCESS_KEY: "你的AccessKey",
ALPHASHOP_SECRET_KEY: "你的SecretKey",
ALPHASHOP_ENV: "pre" // 可选: pre(预发) 或 prod(线上),默认 pre
}
}
}
}
}
环境说明:
ALPHASHOP_ENV=pre- 预发环境:https://pre-api.alphashop.cnALPHASHOP_ENV=prod- 线上环境(默认):https://api.alphashop.cn
如何获取 API Key
获取途径
本 skill 使用 AlphaShop/遨虾平台的 API 服务,需要申请以下凭证:
ALPHASHOP_ACCESS_KEY- API 访问密钥(32位字符)ALPHASHOP_SECRET_KEY- API 密钥
申请步骤
联系平台方
- 如果您是 1688 或阿里内部用户,请联系 AlphaShop/遨虾 平台管理员
获取凭证
- 平台审核通过后会提供 Access Key 和 Secret Key
- 确认凭证格式:Access Key 为32位,Secret Key 为更长字符串
- 确认凭证有效期和权限范围
配置到环境
- 命令行方式:
export ALPHASHOP_ACCESS_KEY='...' - 或使用 OpenClaw 配置(推荐)
- 命令行方式:
验证配置
# 检查环境变量
echo "Access Key: ${ALPHASHOP_ACCESS_KEY:0:10}..."
echo "Secret Key: ${ALPHASHOP_SECRET_KEY:0:10}..."
# 运行环境检查脚本
bash check-env.sh
# 测试 API 调用
python3 scripts/ranking.py overview --platform amazon --country US
AlphaShop选品榜单查询SKILL
通过榜单服务API查询跨境电商市场的热门关键词、爆款商品和类目数据,快速发现选品机会。
功能说明
本 Skill 封装了 1688 选品系统的榜单服务 API,提供 5 大核心功能:
1. 获取总榜列表 (overview)
返回可用的榜单配置和元数据,包括:
- 机会赛道榜(关键词维度)
- 全网商品榜(商品维度)
- 平台国家映射
- 榜单更新时间
2. 查询关键词榜单 (keyword)
根据平台、国家、类目、榜单类型查询关键词榜单明细,包括:
- 关键词市场机会分
- 销量和销售额数据
- 市场竞争指数
- 商品图片预览
- 仅支持一级类目
使用模式:
交互式模式 (推荐): 不提供参数或使用
--interactive,系统将引导您完成以下步骤:- 选择关注的平台 (Amazon/TikTok)
- 选择国家 (默认US)
- 自动查询并展示该平台国家的所有类目
- 选择感兴趣的类目
- 选择榜单类型 (热销词榜/蓝海词榜)
- 展示查询结果
命令行模式: 提供所有必需参数 (--platform, --country, --cate-id, --ranking-type) 直接查询
3. 查询商品榜单 (product)
根据平台、国家、类目层级、榜单类型查询商品榜单明细,包括:
- 商品基本信息
- 销量趋势
- 评分评论
- 上架时间
- 支持1-3级类目
- 支持全站榜单查询
使用模式:
交互式模式 (推荐): 不提供参数或使用
--interactive,系统将引导您完成以下步骤:- 选择关注的平台 (Amazon/TikTok)
- 选择国家 (默认US)
- 选择查询全站榜单或指定类目
- 如选择指定类目,自动查询并展示商品类目树(支持1-3级)
- 选择感兴趣的类目
- 选择榜单类型 (热销榜/飙升榜/新品榜/微创新榜)
- 展示查询结果
命令行模式: 提供所有必需参数 (--platform, --country, --ranking-type) 直接查询
4. 查询商品类目 (product-category)
获取指定平台和国家的商品类目树(最多3层),按商品数量降序排列
5. 查询关键词类目 (keyword-category)
获取指定平台和国家的关键词类目列表(仅一级类目),按关键词数量降序排列
支持的平台和国家
Amazon 平台
支持国家:US, GB, ES, FR, DE, IT, CA, JP
TikTok 平台
支持国家:ID, VN, MY, TH, PH, US, SG, BR, MX, GB, ES, FR, DE, IT, JP
榜单类型说明
商品维度榜单
| 榜单类型 | 代码 | 说明 | 适用场景 |
|---|---|---|---|
| 热销榜 | HOT_SELL_LIST | 验证过的成熟爆款 | 适合跟卖或寻找供应链 |
| 销量飙升榜 | SALE_GROW_LIST | 短期爆发型商品 | 适合捕捉季节性趋势或网红效应 |
| 趋势新品榜 | NEW_ITM_LIST | 处于上升期的新潜力股 | 适合早期切入 |
| 微创新机会榜 | IMPROVE_LIST | 存在痛点改进空间的高销商品 | 适合差异化开发 |
关键词维度榜单
| 榜单类型 | 代码 | 说明 | 适用场景 |
|---|---|---|---|
| 热销词榜 | sold_cnt | 高流量大词 | 适合投放广告或SEO布局 |
| 蓝海词榜 | new_itm | 高需求低竞争词 | 适合中小卖家突围 |
使用方法
功能1: 获取总榜列表
基础用法
查询指定平台和国家的榜单配置:
python3 scripts/ranking.py overview \
--platform amazon \
--country US
输出示例
→ 正在查询总榜列表: AMAZON US
→ 请求中... (响应时间约5秒内)
======================================================================
总榜列表
======================================================================
1. 全网商品榜
描述: 基于销量、评分等多维度筛选的优质商品榜单
子榜单 (4):
- 热销榜 (HOT_SELL_LIST)
更新时间: 2026-03-23 10:00:00
- 销量飙升榜 (SALE_GROW_LIST)
更新时间: 2026-03-23 10:00:00
- 趋势新品榜 (NEW_ITM_LIST)
更新时间: 2026-03-23 10:00:00
- 微创新机会榜 (IMPROVE_LIST)
更新时间: 2026-03-23 10:00:00
2. 机会赛道榜
描述: 基于市场机会分析的关键词榜单
子榜单 (2):
- 热销词榜 (sold_cnt)
更新时间: 2026-03-23 10:00:00
- 蓝海词榜 (new_itm)
更新时间: 2026-03-23 10:00:00
功能2: 查询关键词榜单
交互式模式(推荐)
无需提供任何参数,系统会引导您完成查询流程:
python3 scripts/ranking.py keyword
交互式流程:
- 选择平台: 从 Amazon 和 TikTok 中选择
- 选择国家: 输入国家代码(默认US)或直接回车
- 查看类目: 系统自动查询并展示所有可用类目及关键词数量
- 选择类目: 从列表中选择感兴趣的类目
- 选择榜单类型: 热销词榜 或 蓝海词榜
- 查看结果: 展示关键词榜单数据
示例输出:
======================================================================
关键词榜单查询 (交互式)
======================================================================
请选择您关注的平台:
1) AMAZON
2) TIKTOK
请输入序号 [1-2]: 1
选择的平台: AMAZON
请选择国家 (支持: US, GB, ES, FR, DE, IT, CA, JP):
请输入国家代码 [默认: US]:
→ 正在查询 AMAZON US 的关键词类目...
找到 12 个类目:
1) Clothing - 1580 个关键词
2) Home & Kitchen - 1250 个关键词
3) Sports & Outdoors - 980 个关键词
...
请选择类目序号 [1-12]: 1
选择的类目: Clothing (ID: 2001)
请选择榜单类型:
1) 热销词榜 (sold_cnt)
2) 蓝海词榜 (new_itm)
请输入序号 [1-2]: 1
→ 正在查询关键词榜单...
命令行模式(高级用法)
如果您已知所有参数,可以直接查询:
python3 scripts/ranking.py keyword \
--platform amazon \
--country US \
--cate-id 123456 \
--ranking-type sold_cnt
带类目名称
python3 scripts/ranking.py keyword \
--platform amazon \
--country US \
--cate-id 123456 \
--ranking-type new_itm \
--cate-name "Clothing"
强制交互式
即使提供了部分参数,也可以使用 --interactive 强制进入交互式模式:
python3 scripts/ranking.py keyword --interactive
参数说明
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
--platform |
String | ⚠️ | 平台(amazon/tiktok),不提供则交互式询问 | amazon |
--country |
String | ⚠️ | 国家代码,不提供则使用默认US | US |
--cate-id |
String | ⚠️ | 类目ID(仅支持一级类目),不提供则交互式选择 | 123456 |
--ranking-type |
String | ⚠️ | 榜单类型(sold_cnt/new_itm),不提供则交互式选择 | sold_cnt |
--cate-name |
String | ❌ | 类目名称 | "Clothing" |
--interactive |
Flag | ❌ | 强制使用交互式模式 | - |
--output-json |
Flag | ❌ | 输出完整JSON | - |
注意: 如果缺少 --platform、--cate-id 或 --ranking-type 任一参数,将自动进入交互式模式
输出示例
→ 正在查询关键词榜单: AMAZON US - 类目 123456 - sold_cnt
→ 请求中... (响应时间约5秒内)
======================================================================
关键词榜单 (100)
======================================================================
1. yoga pants (瑜伽裤)
平台: AMAZON | 国家: US
机会分: 42.5 - 击败同一级类目85.3%关键词
排名: #1
平均价格: US$25.99
月销量: 113.7K
在售商品: 15K
2. yoga mat (瑜伽垫)
平台: AMAZON | 国家: US
机会分: 38.2 - 击败同一级类目78.5%关键词
排名: #2
平均价格: US$22.50
月销量: 85.3K
在售商品: 12K
... 还有 90 个关键词(使用 --output-json 查看完整数据)
功能3: 查询商品榜单
交互式模式(推荐)
无需提供任何参数,系统会引导您完成查询流程:
python3 scripts/ranking.py product
交互式流程:
- 选择平台: 从 Amazon 和 TikTok 中选择
- 选择国家: 输入国家代码(默认US)或直接回车
- 选择范围:
- 全站榜单(不限定类目)
- 或 指定类目榜单
- 查看类目(如选择指定类目): 系统自动查询并展示所有类目(支持1-3级树形结构)
- 选择类目(如选择指定类目): 从列表中选择感兴趣的类目
- 选择榜单类型: 热销榜/飙升榜/新品榜/微创新榜
- 查看结果: 展示商品榜单数据
示例输出:
======================================================================
商品榜单查询 (交互式)
======================================================================
请选择您关注的平台:
1) AMAZON
2) TIKTOK
请输入序号 [1-2]: 1
选择的平台: AMAZON
请选择国家 (支持: US, GB, ES, FR, DE, IT, CA, JP):
请输入国家代码 [默认: US]:
查询范围:
1) 全站榜单 (不限定类目)
2) 指定类目榜单
请选择 [1-2, 默认: 1]: 2
→ 正在查询 AMAZON US 的商品类目...
找到 15 个一级类目:
1) Clothing [L1] - 125000 个商品
2) Women's Clothing [L2] - 85000 个商品
3) Activewear [L3] - 15000 个商品
4) Dresses [L3] - 20000 个商品
5) Men's Clothing [L2] - 40000 个商品
...
请选择类目序号 [1-35]: 3
选择的类目: Activewear (ID: 1001-01-01, L3)
请选择榜单类型:
1) 热销榜 (HOT_SELL_LIST)
2) 销量飙升榜 (SALE_GROW_LIST)
3) 趋势新品榜 (NEW_ITM_LIST)
4) 微创新机会榜 (IMPROVE_LIST)
请输入序号 [1-4]: 1
→ 正在查询商品榜单...
命令行模式(高级用法)
查询全站榜单:
python3 scripts/ranking.py product \
--platform amazon \
--country US \
--ranking-type HOT_SELL_LIST
指定类目(一级类目):
python3 scripts/ranking.py product \
--platform amazon \
--country US \
--ranking-type SALE_GROW_LIST \
--cate-id 123456 \
--cate-level 1
指定类目(二级类目):
python3 scripts/ranking.py product \
--platform amazon \
--country US \
--ranking-type NEW_ITM_LIST \
--cate-id 789012 \
--cate-level 2 \
--cate-name "Women's Clothing"
强制交互式
即使提供了部分参数,也可以使用 --interactive 强制进入交互式模式:
python3 scripts/ranking.py product --interactive
参数说明
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
--platform |
String | ⚠️ | 平台(amazon/tiktok),不提供则交互式询问 | amazon |
--country |
String | ⚠️ | 国家代码,不提供则使用默认US | US |
--ranking-type |
String | ⚠️ | 榜单类型,不提供则交互式选择 | HOT_SELL_LIST |
--cate-id |
String | ❌ | 类目ID,不提供则交互式选择或查全站 | 123456 |
--cate-level |
String | ❌ | 类目层级(1/2/3) | 1 |
--cate-name |
String | ❌ | 类目名称 | "Clothing" |
--interactive |
Flag | ❌ | 强制使用交互式模式 | - |
--output-json |
Flag | ❌ | 输出完整JSON | - |
注意: 如果缺少 --platform 或 --ranking-type 任一参数,将自动进入交互式模式
榜单类型:
HOT_SELL_LIST- 热销榜SALE_GROW_LIST- 销量飙升榜NEW_ITM_LIST- 趋势新品榜IMPROVE_LIST- 微创新机会榜
输出示例
→ 正在查询商品榜单: AMAZON US - 类目 123456 (L1) - HOT_SELL_LIST
→ 请求中... (响应时间约5秒内)
======================================================================
商品榜单 (100)
======================================================================
1. Women's High Waist Yoga Pants - Tummy Control
商品ID: B0ABC12345
平台: AMAZON | 国家: US
机会分: 78.5
价格: US$29.99
月销量: 5.2K
评分: 4.5 ⭐ (1523条评论)
上架时间: 2025/10/15
链接: https://www.amazon.com/dp/B0ABC12345
2. Premium Yoga Mat with Carrying Strap
商品ID: B0DEF67890
平台: AMAZON | 国家: US
机会分: 72.3
价格: US$24.99
月销量: 4.8K
评分: 4.7 ⭐ (2891条评论)
上架时间: 2025/09/20
链接: https://www.amazon.com/dp/B0DEF67890
... 还有 98 个商品
> **字段说明**:
> - **必有字段**:商品ID、平台、国家、价格、商品链接
> - **可选字段**:机会分、月销量、评分、上架时间、商品图片等
> - 实际显示字段取决于API返回的数据,部分字段可能为空而不显示
> - 如需查看API返回的所有字段,使用 `--debug-fields` 参数
功能4: 查询商品类目
基础用法
python3 scripts/ranking.py product-category \
--platform amazon \
--country US
输出示例
→ 正在查询商品类目: AMAZON US
→ 请求中... (响应时间约5秒内)
======================================================================
类目树 (15 个一级类目)
======================================================================
服装鞋包 (ID: 1001, 商品数: 125000)
└─ 女装 (ID: 1001-01, 商品数: 85000)
└─ 运动装 (ID: 1001-01-01, 商品数: 15000)
└─ 连衣裙 (ID: 1001-01-02, 商品数: 20000)
... 还有 8 个子类目
└─ 男装 (ID: 1001-02, 商品数: 40000)
└─ T恤 (ID: 1001-02-01, 商品数: 12000)
... 还有 6 个子类目
家居厨房 (ID: 1002, 商品数: 95000)
└─ 厨房用品 (ID: 1002-01, 商品数: 50000)
... 还有 4 个子类目
... 还有 13 个一级类目(使用 --output-json 查看完整数据)
功能5: 查询关键词类目
基础用法
python3 scripts/ranking.py keyword-category \
--platform amazon \
--country US
输出示例
→ 正在查询关键词类目: AMAZON US
→ 请求中... (响应时间约5秒内)
======================================================================
类目树 (12 个一级类目)
======================================================================
Clothing (ID: 2001, 商品数: 1580)
Home & Kitchen (ID: 2002, 商品数: 1250)
Sports & Outdoors (ID: 2003, 商品数: 980)
Beauty & Personal Care (ID: 2004, 商品数: 850)
Electronics (ID: 2005, 商品数: 720)
... 还有 7 个一级类目(使用 --output-json 查看完整数据)
功能6: 查询1688类目信息
基础用法
本地查询1688平台一级类目信息(不需要API调用):
# 列出所有类目
python3 scripts/test_categories.py list
# 根据ID查询类目
python3 scripts/test_categories.py get --id 2
# 根据名称搜索类目
python3 scripts/test_categories.py search --name 服装
输出示例
查询类目:
✅ 找到类目:
类目ID: 2
类目名称: 食品、饮料
别名: 食品酒水
搜索类目:
✅ 找到 1 个匹配的类目:
ID 3: 服装
特殊策略说明
1. 随机洗牌策略
适用接口: 关键词榜单、商品榜单
- 目的: 避免榜单固化,给更多商品/关键词展示机会
- 实现: 从候选池中随机抽取指定数量的结果
- 影响: 每次查询相同参数,返回的榜单顺序可能不同
2. 类目轮播策略
适用接口: 商品类目、关键词类目
- 目的: 根据时间段轮播展示不同类目,避免首位类目过度曝光
- 实现: 基于当前时段计算轮播索引,将对应类目排在第一位
- 影响: 不同时间段查询,类目排序可能不同
3. 候选池配置
关键词榜单:
- 候选池大小: 500
- 展示数量: 100
- 仅支持一级类目
商品榜单:
| 类目层级 | 候选池大小 | 展示数量 |
|---|---|---|
| 一级类目 | 500 | 100 |
| 二级类目 | 200 | 50 |
| 三级类目 | 100 | 30 |
使用技巧
1. 优先使用交互式模式(关键词和商品榜单)
对于关键词和商品榜单查询,强烈推荐使用交互式模式:
# 交互式查询关键词榜单 (推荐)
python3 scripts/ranking.py keyword
# 交互式查询商品榜单 (推荐)
python3 scripts/ranking.py product
# 优势:
# - 无需记忆类目ID
# - 自动查询并展示类目列表
# - 支持全站或指定类目查询
# - 友好的引导式体验
2. 商品榜单的两种查询方式
方式A: 全站榜单(快速查看整体市场)
# 交互式: 选择"全站榜单"
python3 scripts/ranking.py product
# 然后在步骤3选择: 1) 全站榜单
# 命令行:
python3 scripts/ranking.py product \
--platform amazon \
--country US \
--ranking-type HOT_SELL_LIST
方式B: 类目榜单(精准类目分析)
# 交互式: 选择"指定类目榜单"
python3 scripts/ranking.py product
# 然后在步骤3选择: 2) 指定类目榜单
# 系统会展示多级类目树供选择
3. 多次查询获取更多样本
由于采用随机洗牌策略,可以多次查询同一榜单,获取不同的商品/关键词样本:
# 第一次查询
python3 scripts/ranking.py keyword --platform amazon --country US --cate-id 123456 --ranking-type sold_cnt
# 等待几秒后第二次查询(会得到不同的结果顺序)
python3 scripts/ranking.py keyword --platform amazon --country US --cate-id 123456 --ranking-type sold_cnt
4. 使用 JSON 输出进行数据分析
python3 scripts/ranking.py product \
--platform amazon \
--country US \
--ranking-type NEW_ITM_LIST \
--cate-id 123456 \
--cate-level 1 \
--output-json > analysis.json
数据会同时输出到终端和自动保存到 output/alphashop-sel-ranking/ 目录。
5. 使用调试模式排查字段问题
如果发现某些字段(如商品链接、图片链接)没有显示,使用 --debug-fields 参数诊断:
# 调试商品榜单
python3 scripts/ranking.py product \
--platform amazon \
--country US \
--ranking-type HOT_SELL_LIST \
--debug-fields
# 调试关键词榜单
python3 scripts/ranking.py keyword \
--platform amazon \
--country US \
--cate-id 123456 \
--ranking-type sold_cnt \
--debug-fields
# 交互式模式也支持调试
python3 scripts/ranking.py product --debug-fields
调试输出说明:
- 显示第一个条目的所有字段名和值
- 标记空字符串和null值
- 帮助诊断字段缺失或数据不完整问题
查看详细的调试指南:DEBUG_FIELDS_GUIDE.md
错误处理
常见错误
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
platform or country is empty! |
平台或国家参数缺失 | 检查必填参数 |
cateId is empty! |
类目ID缺失 | 添加 --cate-id 参数 |
Invalid ranking type |
榜单类型不合法 | 检查榜单类型是否在支持列表中 |
Invalid country code |
国家代码不合法 | 检查国家代码是否在支持列表中 |
FAIL_AUTH_ERROR |
API 凭证不正确 | 检查 ALPHASHOP_ACCESS_KEY 和 ALPHASHOP_SECRET_KEY |
FAIL_REQUEST_PARAMETER_ILLEGAL |
userId 参数非法 | userId 必须是 Java Long 类型(>10位整数) |
请求超时 |
网络问题或服务响应慢 | 稍后重试或切换环境 |
环境诊断
运行环境检查脚本诊断配置问题:
bash check-env.sh
检查项包括:
- ✅ 当前目录和 skill 名称
- ✅ 必需的环境变量(ALPHASHOP_ACCESS_KEY、ALPHASHOP_SECRET_KEY)
- ⚠️ 错误的环境变量(ALI1688_* 相关变量)
注意事项
- 响应时间: 所有接口响应时间在5秒内
- 数据更新: 榜单数据每天更新
- 类目限制:
- 关键词榜单仅支持一级类目
- 商品榜单支持1-3级类目
- 随机性: 由于随机洗牌策略,相同查询参数多次请求可能返回不同的结果顺序
- 平台差异: Amazon 和 TikTok 的部分字段不同
安全声明
本 Skill 的安全策略:
数据处理
- ✅ 不处理个人身份信息(PII)
- ✅ 不访问生产数据库
- ✅ 仅查询公开的榜单数据
权限要求
- ✅ 需要 AlphaShop API 凭证(通过环境变量配置)
- ✅ 不需要 Root 或管理员权限
- ✅ 输出文件仅写入当前目录的
output/子目录
网络访问
- ✅ 仅访问 AlphaShop API 端点
- 预发环境:
https://pre-api.alphashop.cn - 线上环境:
https://api.alphashop.cn
- 预发环境:
- ✅ 所有请求使用 HTTPS 加密
- ✅ 设置 30 秒超时防止长时间阻塞
敏感信息保护
- ✅ API 密钥通过环境变量传递,不写入日志
- ✅ 错误信息仅包含 RequestId,不包含完整请求内容
- ✅ 输出文件权限仅限当前用户访问
能力边界与约束
✅ 本 Skill 可以做什么
- ✅ 查询 Amazon 和 TikTok 平台的多种榜单类型(热销榜/飙升榜/新品榜/蓝海词榜等)
- ✅ 支持关键词榜单和商品榜单两大查询模式
- ✅ 支持交互式模式:自动引导用户选择平台→查询范围→类目→榜单类型
- ✅ 商品榜单支持全站查询和 1-3 级类目树形展示
- ✅ 支持切换环境(预发/生产)
- ✅ 将榜单结果保存到本地文件
- ✅ 可以多次调用,查询不同关键词、类目或榜单类型
❌ 本 Skill 不能做什么
- ❌ 不能批量查询:一次调用只能查询一个关键词或一个类目的榜单
- ❌ 不能跨平台对比:一次只能查询一个平台(Amazon 或 TikTok)
- ❌ 不能深度分析:只展示榜单原始数据,不做商品分析、市场趋势分析
- ❌ 不能历史对比:只返回当前榜单数据,不包含历史排名变化
- ❌ 不能自定义榜单规则:榜单类型和计算规则由 AlphaShop 平台预定义
- ❌ 不能访问其他 API:只调用 AlphaShop 榜单相关端点
💡 合理的延伸问题示例
✅ 推荐的延伸方向(在能力范围内或可多次调用实现):
- "换一个关键词查询看看"
- "切换到商品榜单模式"
- "查询 TikTok 平台的同一个关键词"
- "查看某个具体类目的热销榜"
- "切换到飙升榜查看新兴趋势"
- "将榜单保存到文件"
- "对比'瑜伽裤'在 Amazon 和 TikTok 的榜单"(提示:需要手动调用两次)
❌ 不推荐的延伸方向(超出 skill 范围):
- "分析这 10 个关键词在两个平台的差异"(需要数据分析工具)
- "预测这个关键词下个月的排名"(无预测能力)
- "筛选出价格低于 50 美元的上榜商品"(API 可能不返回价格数据)
- "对比这个商品今天和上周的排名变化"(无历史对比能力)
💡 后续处理建议:
- 可以将同一关键词在不同平台的榜单保存后,手动对比差异
- 可以定期查询同一关键词/类目,手动记录排名变化趋势
- 可以结合榜单数据,在对应平台上进一步查看商品详情
API 参考文档
完整的API接口和数据结构文档请参阅 references/api-ranking-list.md。