用一行命令，获取全部数据
Sorftime CLI 提供功能和数据结构与 API 完全一致。
安装即用，JSON 输出，AI Agent 天然适配。
$ npm install -g sorftime-cli
# 配置账户
$ sorftime add myaccount your-account-sk
# 调用 API
$ sorftime api ProductRequest '{"asin":"B0CVM8TXHP"}' --domain 1
{ "Code": 0, "Data": { ... }, "RequestLeft": 9999 }
为什么选择 CLI？
专为开发者和 AI Agent 打造的数据工具
零集成成本
AI Agent 天然具备命令行执行能力，无需编写 HTTP 请求代码、处理认证逻辑，直接调用即可。
结构化 JSON 输出
默认 JSON 格式输出，Agent 可直接解析使用，无需额外适配层或格式转换。
自动凭证管理
Account-SK 存储在本地配置中，所有命令自动携带认证，Agent 无需处理鉴权细节。
开箱即用
全局安装后在任何目录下均可调用，不依赖项目依赖管理，无包版本兼容性问题。
调试友好
命令行输出清晰可见，便于在开发过程中排查问题和迭代 Prompt。
无状态调用
每个命令独立执行，无需维护连接状态或 session，完美适配 AI Agent 的函数调用模式。
Sorftime CLI 已支持功能
CLI 提供的功能与 Sorftime APIs 完全一致 — 方法名、请求参数、返回的数据结构均与 API 文档相同，零学习成本，即装即用。
一键安装 Sorftime CLI
一键安装 Sorftime CLI 并下载配置配套 Skills，导入 AI Agent 即可自动激活并使用 Sorftime 数据能力
安装 sorftime-cli
首先确保已全局安装 Sorftime CLI 工具
npm install -g sorftime-cli
# 验证安装
sorftime --version
配置 Sorftime 账户
从 Sorftime 后台获取 Account-SK，添加到 CLI 并设为默认账户
sorftime add myaccount your-account-sk
# 切换到该账户作为默认
sorftime use myaccount
# 列出所有账户
sorftime list
# 查看当前活跃账号
sorftime whoami
下载 Skill 文件
下载完整的 Skill 文档包（包含 Amazon / Shopee / Walmart 全部平台的 Skill 文档），解压后得到以下目录：
├── 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 接口
全局安装 Skills 到 Claude Code
前提：您已经Claude Code 安装完成。
将sorftime-cli文件夹目录复制到 Claude Code 的全局 Skills 目录，即可在所有项目中使用。
# 路径：$env:USERPROFILE\.claude\skills （通常为：C:\Users\{登录名}\.claude\skills）
# 步骤 2：在终端输入 claude 命令进入 Claude Code
claude
# 步骤 3：在对话中输入 /skills 验证是否已识别 sorftime-cli
/skills
# 步骤 4：激活 Skill，输入 /sorftime-cli
/sorftime-cli
# 路径：~/.claude/skills
# 步骤 2：在终端输入 claude 命令进入 Claude Code
claude
# 步骤 3：在对话中输入 /skills 验证是否已识别 sorftime-cli
/skills
# 步骤 4：激活 Skill，输入 /sorftime-cli
/sorftime-cli
# OpenClaw 安装方法类似，全局 Skills 目录位于$env:USERPROFILE\.openclaw\skills
# 复制进去后直接自然语言对话“安装 sorftime-cli skills”
开始使用
Skill 加载成功后，直接用自然语言向 Agent 描述需求即可，Agent 会自动激活对应 Skill 并调用 CLI：
得到结果：{ "Code": 0, "Data": { "title": "...", "sales": 12450, ... } }
为 AI Agent 而生
Claude Code、Cursor、Copilot 等 AI 开发工具原生支持命令行执行。Sorftime CLI 让 Agent 无需编写任何集成代码，即可调用全部数据能力。
- ✓ 零代码集成 — Agent 直接执行命令行，无需编写 HTTP 请求、错误处理、重试逻辑
- ✓ 统一认证 — 一次配置 Account-SK，所有命令自动认证，Agent 无需管理 token
- ✓ JSON 原生输出 — 返回结构化数据，Agent 可直接解析并用于下一步决策
- ✓ 无状态设计 — 每个命令独立执行，符合 Agent 函数调用的一次性执行模型
- ✓ 所见即所得 — 终端输出透明可见，方便调试 Prompt 和验证数据准确性
> sorftime api ProductRequest \
'{"asin":"B0CVM8TXHP","trend":1}' --domain 1
{
"Code": 0,
"Data": {
"asin": "B0CVM8TXHP",
"title": "...", "sales": 12450,
"trend": [...] }
},
"RequestLeft": 9999
}
CLI、API、MCP 怎么选？
三种方式，覆盖不同场景的数据获取需求
| 维度 | CLI | API | MCP |
|---|---|---|---|
| 调用方式 | 命令行直接执行 | HTTP/REST 请求 | 通过 MCP Server 中转 |
| 集成门槛 | npm 安装即用 | 需处理请求和认证 | 需安装并配置 MCP Server |
| 适用场景 | AI Agent、CI/CD、自动化脚本 | Web 应用、移动端、服务端 | AI IDE 内联查询 |
| 认证方式 | 本地配置文件（Account-SK） | Header / Query 参数 | Server 内部管理 |
| 环境依赖 | Node.js + npm | 任意 HTTP 客户端 | MCP 兼容客户端 |
| AI Agent 友好度 | ★★★★★ | ★★★ | ★★★★ |
选 CLI
使用 AI Agent（Claude Code / Cursor）做数据分析，或写自动化脚本批量处理数据
AI Agent ✓
选 API
开发 Web 应用、小程序，或需要深度定制集成逻辑和业务流程
Web 应用 ✓
选 MCP
希望在 AI IDE 中直接通过对话方式查询数据，无需离开编辑器环境
AI IDE ✓