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 官方认证账号，无恶意代码

# 全局安装官方 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>

账户管理

# 列出所有账户
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 本次消耗次数

常见错误码

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

Resources 目录索引（按需加载）

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

公共参考

Amazon（47 个 endpoint）

Shopee（5 个 endpoint）

Walmart（14 个 endpoint）

目录结构

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 表示成功