Sorftime CLI Skill#

Sorftime 提供 Amazon、Shopee、Walmart 三大电商平台的数据分析 API，通过 sorftime-cli 命令行工具调用。

前置配置#

安装与认证#

🔒 安全说明：本工具完全开源，代码可公开审计

• 开源仓库地址： https://github.com/sorftime/sorftime-cli
• npm 官方包主页： https://www.npmjs.com/package/sorftime-cli
• 发布者为 Sorftime 官方认证账号，无恶意代码

bash

# 全局安装官方 CLI（推荐）
npm install -g sorftime-cli

# 添加账户 （profile-name 可以任意命名， api-key 在 Sorftime 官网获取：https://www.sorftime.com/cli）
sorftime add <profile-name> <api-key>
# 激活账号
sorftime use <profile-name>

账户管理#

bash

# 列出所有账户
sorftime list / sorftime ls

# 切换当前活跃账户
sorftime use <profile-name>

# 查看当前活跃账户
sorftime whoami

# 删除账户
sorftime remove <profile-name>

通用命令格式#

bash

sorftime api <接口名称> '{"参数JSON"}' --domain <站点数字ID>

通用返回结构#

所有接口返回统一结构：

json

{
  "code": 0,
  "message": null,
  "data": {},
  "requestleft": 9999,
  "requestconsumed": 1,
  "requestcount": 1
}

• code=0 成功，非0失败
• requestleft 当月剩余请求次数
• requestconsumed 本次消耗次数

常见错误码#

完整错误码表（按平台区分）见 _common.md。快速参考：

错误码说明处理方式0成功-4积分余额不足充值或等待下月重置10请求参数错误检查参数格式、类型、必填项97ASIN/产品不存在检查参数98采集失败稍后重试99正在实时抓取等待后重试400非认证 IP检查 IP 白名单401认证失败/请求接口未开放检查 Account-SK 和接口名称500本月请求已达限额等待下月重置或升级套餐501一分钟请求已达限额降低频率，1分钟后重试502一天请求已达限额等待次日重置或升级套餐

---

Resources 目录索引（按需加载）#

所有 resources 文件头部均指向 _common.md 获取 CLI 模板、Domain 表、错误码。本索引只列接口清单与跳转。

公共参考#

文件内容_common.mdAmazon/Shopee/Walmart Domain 表、完整错误码（按平台区分）、通用返回结构、CLI 调用模板account.md跨平台通用账户管理（3 接口）：CoinQuery、CoinStream、RequestStream

Amazon（47 个 endpoint）#

文件接口数接口清单amazon-category.md5CategoryTree、CategoryRequest、CategoryProducts、CategoryTrend、CategorySearchFromNameamazon-product.md11ProductRequest、ProductSearch、AsinSalesVolume、ProductVariationHistory、ProductReviewsCollection、ProductReviewsCollectionStatusQuery、ProductReviewsQuery、ProductSearchFromName、ASINSubscription、ASINSubscriptionQuery、ASINSubscriptionCollectionamazon-product-realtime.md5ProductRealtimeRequest、ProductRealtimeRequestStatusQuery、SimilarProductRealtimeRequest、SimilarProductRealtimeRequestStatusQuery、SimilarProductRealtimeRequestCollectionamazon-keyword.md12KeywordQuery、KeywordRequest、KeywordSearchResults、KeywordSearchResultTrend、KeywordExtends、CategoryRequestKeyword、ASINRequestKeywordv2、KeywordProductRanking、ASINKeywordRanking、FavoriteKeyword、ChangeFavoriteKeyword、GetFavoriteKeywordamazon-monitoring.md—监控通用规则：period 表达式、积分消耗、站点矩阵、任务状态流转。 接口详情跳转到 3 个子文件。amazon-monitoring-keyword.md5KeywordBatchSubscription、KeywordTasks、KeywordBatchTaskUpdate、KeywordBatchScheduleList、KeywordBatchScheduleDetailamazon-monitoring-bestseller.md4BestSellerListSubscription、BestSellerListTask、BestSellerListDelete、BestSellerListDataCollectamazon-monitoring-seller.md5ProductSellerSubscription、ProductSellerTasks、ProductSellerTaskUpdate、ProductSellerTaskScheduleList、ProductSellerTaskScheduleDetailamazon-recipes.md—多接口编排配方：选品流程、竞品深挖、监控部署、趋势追踪、跨平台对比。展示 CLI 比 MCP 灵活的核心场景。

Shopee（5 个 endpoint）#

文件接口数接口清单shopee-api.md5CategoryTree、CategoryRequest、ProductRequest、ProductTrend、ShopRequestshopee-data-types.md—Shopee 数据类型定义

Walmart（14 个 endpoint）#

文件接口数接口清单walmart-api.md5CategoryTree、CategoryRequest、ProductRequest、ProductTrendRequest、ProductSalesVolumewalmart-keyword.md9KeywordQuery、KeywordSearchFromName、KeywordSearchResults、KeywordRequest、ProductRequestKeyword、KeywordExtends、FavoriteKeyword、ChangeFavoriteKeyword、GetFavoriteKeywordwalmart-data-types.md—Walmart 数据类型定义

---

目录结构#

text

sorftime-cli/
├── SKILL.md                              # 本文件：主索引 + 触发器 + 分流声明
├── README.md                             # 快速参考指南
└── resources/
    ├── _common.md                        # 公共：Domain 表 / 错误码 / 返回结构 / CLI 模板
    ├── account.md                        # 跨平台通用账户管理（3 接口）
    ├── amazon-category.md                # Amazon 类目 5 接口
    ├── amazon-product.md                 # Amazon 产品核心 11 接口
    ├── 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 接口
    ├── shopee-data-types.md              # Shopee 数据类型定义
    ├── walmart-api.md                    # Walmart 类目+产品 5 接口
    ├── walmart-keyword.md                # Walmart 关键词+词库 9 接口
    └── walmart-data-types.md             # Walmart 数据类型定义

---

重要规则#

1. 不要猜测 domain 值 — 始终使用 _common.md 中的站点速查表
2. JSON 参数用单引号包裹 — sorftime api XXX '{"key": "value"}'
3. 大响应设置超时 — CategoryTree 返回约10MB+数据，建议设置较长超时时间
4. 错误码判断 — 以 code 字段为准（小写）， code=0 表示成功