Sorftime CLI Skill
Sorftime 提供 Amazon、Shopee、Walmart 三大电商平台的数据分析 API，通过 sorftime-cli 命令行工具调用。
前置配置
安装与认证
# 安装 CLI
npm install -g sorftime-cli
# 添加账户 （profile-name 可以任意命名， api-key 在 Sorftime 官网获取）
sorftime add <profile-name> <api-key>
# 激活账号
sorftime use <profile-name>
账户管理
# 列出所有账户
sorftime list / sorftime ls
# 切换当前活跃账户
sorftime use <profile-name>
# 查看当前活跃账户
sorftime whoami
# 删除账户
sorftime remove <profile-name>
通用命令格式
sorftime api <接口名称> '{"参数JSON"}' --domain <站点数字ID>
通用返回结构
所有接口返回统一结构：
{
"Code": 0,
"Message": null,
"Data": {},
"RequestLeft": 9999,
"RequestConsumed": 1,
"RequestCount": 1
}
Code=0 成功，非0失败RequestLeft 当月剩余请求次数RequestConsumed 本次消耗次数
常见错误码
| 错误码 | 说明 | 处理方式 |
|---|
| 0 | 成功 | - |
| 4 | 积分余额不足 | 引导用户充值或等待下月重置 |
| 97 | ASIN/产品不存在 | 提醒用户检查参数 |
| 98 | 采集失败 | 稍后重试 |
| 99 | 正在实时抓取 | 等待5分钟后重试 |
| 401 | 认证失败 | 引导用户重新执行 sorftime add |
| 403 | 权限不足 | 检查套餐权限 |
| 429 | 频率超限 | 降低请求速度，等待1分钟后重试 |
Resources 目录索引（按需加载）
所有 resources 文件头部均指向 _common.md 获取 CLI 模板、Domain 表、错误码。本索引只列接口清单与跳转。
公共参考
| 文件 | 内容 |
|---|
_common.md | Amazon/Shopee/Walmart Domain 表、完整错误码（0/4/97/98/99/-999 + HTTP 401/403/429/500）、通用返回结构、CLI 调用模板 |
Amazon（43 个 endpoint）
| 文件 | 接口数 | 接口清单 |
|---|
amazon-category.md | 4 | CategoryTree、CategoryRequest、CategoryProducts、CategoryTrend |
amazon-product.md | 8 | ProductRequest、ProductSearch、AsinSalesVolume、ProductVariationHistory、ProductTrend、ProductReviewsCollection、ProductReviewsCollectionStatusQuery、ProductReviewsQuery |
amazon-product-realtime.md | 5 | ProductRealtimeRequest、ProductRealtimeRequestStatusQuery、SimilarProductRealtimeRequest、SimilarProductRealtimeRequestStatusQuery、SimilarProductRealtimeRequestCollection |
amazon-keyword.md | 12 | KeywordQuery、KeywordRequest、KeywordSearchResults、KeywordSearchResultTrend、KeywordExtends、CategoryRequestKeyword、ASINRequestKeywordv2、KeywordProductRanking、ASINKeywordRanking、FavoriteKeyword、ChangeFavoriteKeyword、GetFavoriteKeyword |
amazon-monitoring.md | — | 监控通用规则：period 表达式、积分消耗、站点矩阵、任务状态流转。接口详情跳转到 3 个子文件。 |
amazon-monitoring-keyword.md | 5 | KeywordBatchSubscription、KeywordTasks、KeywordBatchTaskUpdate、KeywordBatchScheduleList、KeywordBatchScheduleDetail |
amazon-monitoring-bestseller.md | 4 | BestSellerListSubscription、BestSellerListTask、BestSellerListDelete、BestSellerListDataCollect |
amazon-monitoring-seller.md | 5 | ProductSellerSubscription、ProductSellerTasks、ProductSellerTaskUpdate、ProductSellerTaskScheduleList、ProductSellerTaskScheduleDetail |
amazon-recipes.md | — | 多接口编排配方：选品流程、竞品深挖、监控部署、趋势追踪、跨平台对比。展示 CLI 比 MCP 灵活的核心场景。 |
Shopee（5 个 endpoint）
| 文件 | 接口数 | 接口清单 |
|---|
shopee-api.md | 5 | CategoryTree、CategoryRequest、ProductRequest、ProductTrend、ShopRequest |
Walmart（13 个 endpoint）
| 文件 | 接口数 | 接口清单 |
|---|
walmart-api.md | 5 | CategoryTree、CategoryRequest、ProductRequest、ProductTrendRequest、ProductSalesVolume |
walmart-keyword.md | 8 | KeywordQuery、KeywordSearchResults、KeywordRequest、ProductRequestKeywordv2、KeywordExtends、FavoriteKeyword、ChangeFavoriteKeyword、GetFavoriteKeyword |
目录结构
sorftime-cli/
├── SKILL.md # 本文件：主索引 + 触发器 + 分流声明
└── resources/
├── _common.md # 公共：Domain 表 / 错误码 / 返回结构 / CLI 模板
├── amazon-category.md # Amazon 类目 4 接口
├── amazon-product.md # Amazon 产品核心 8 接口
├── amazon-product-realtime.md # Amazon 产品实时采集 5 接口
├── amazon-keyword.md # Amazon 关键词 12 接口
├── amazon-monitoring.md # Amazon 监控通用规则（索引）
├── amazon-monitoring-keyword.md # Amazon 关键词监控 5 接口
├── amazon-monitoring-bestseller.md # Amazon Best Seller 监控 4 接口
├── amazon-monitoring-seller.md # Amazon 跟卖监控 5 接口
├── amazon-recipes.md # 多接口编排配方（CLI 差异化场景）
├── shopee-api.md # Shopee 5 接口
├── walmart-api.md # Walmart 类目+产品 5 接口
└── walmart-keyword.md # Walmart 关键词+词库 8 接口
重要规则
- 不要猜测 domain 值 — 始终使用上述站点速查表中的准确值
- JSON 参数用单引号包裹 —
sorftime api XXX '{"key": "value"}'
- 大响应设置超时 — CategoryTree 返回约10MB+数据，建议设置较长超时时间