SaleSmartly API 技能

适用人群

适合：要批量打开网页、搜索信息、点击页面并保存结果的人、要反复登录后台、填写表单、截图取证或下载页面内容的人、要把固定网页操作交给 AI 自动执行的运营、测试和采集人员。

技能介绍

SaleSmartly API 集成技能（只读查询），用于客户查询、消息查询、团队查询。通过封装的 Python 脚本调用 SaleSmartly API。使用场景：(1) 查询客户列表和详情，(2) 获取客户消息，(3) 查询团队成员，(4) 筛选今天新增客户，(5) 调用任意 API 接口。

| 文件 | 用途 | 更新频率 | |——|——|———| | SKILL.md | 用户使用说明 | 低（功能变化时更新） | | scripts/client.py | API 调用脚本 | 中（新增常用接口时） | | references/api-full.md | API 参考文档 | 低（API 大版本更新） | | references/response-codes.md | 错误码对照 | 低 | | llms.txt | AI 接口目录 | 高（SaleSmartly 自动更新） |。

业务背景和落地案例

| 用户需求 | AI 操作 | |———|——–| | “查一下今天新增客户” | get-contacts --today | | “看看客服团队有谁” | get-members | | “查张三的聊天记录” | get-contacts --keyword "张三" → get-messages --chat-user-id xxx | | “我们有哪些分流链接” | api-call split-link/get-list | | “查 WhatsApp 设备列表” | api-call whatsapp-app/get-list |。

能做什么

• 只读优先 – 只封装查询类接口，避免误操作。
• 常用 + 通用 – 高频接口封装命令，低频接口用 api-call。
• AI 友好 – 通过 llms.txt 自主查询新接口。
• 易于维护 – 接口增加不需要频繁更新脚本。
• 查询 SaleSmartly 客户数据（列表、详情）。
• 读取客户聊天记录。
• 查询客服团队信息。
• 统计报表（今天新增、渠道分布等）。

安装方法

方式 1：对 OpenClaw 说（不用写代码）

适合：OpenClaw、Codex、Kimiclaw、Windsurf、Trae、华为 CodeArts。

直接对 OpenClaw 说：

帮我安装一个叫 SaleSmartly API 技能 的 Skill。
如果安装时需要精确名字，就用 api-skill。
装好以后，先用它帮我处理一遍当前任务。

如果需要手动安装，可以用这条命令：

clawhub install api-skill

方式 2：导入 MD 安装

适合：腾讯Workbuddy、百度Duclaw、字节Arkclaw、智谱Autoclaw、科大讯飞Astronclaw。

1. 找到这条 Skill 自带的 Markdown 文件，通常就是它的 SKILL.md 或同名 .md 文件。
2. 把这个 Markdown 文件导入到你的产品里。
3. 导入完成后，直接对 AI 说：

用刚刚导入的SaleSmartly API 技能，先帮我处理当前任务。

备注：这一种本质上是导入一个 Markdown 文件，给知道安装包里有 .md 文件的人即可。

方式 3：代码安装

适合：Claude Code、Cursor、通义灵码、文心快码。

最短可用命令：

python3 scripts/client.py get-members

如果要继续执行，可以再用：

python scripts/client.py get-contacts
python scripts/client.py get-contacts --today

使用步骤

1. 先选上面 3 种方式里，自己最容易完成的一种。
2. 安装完成后，直接对 OpenClaw 说：“用SaleSmartly API 技能帮我处理当前任务。” 先让它自己跑一遍就可以。
3. 如果你已经有明确文件、网址、目录或数据，再把它补给 OpenClaw，让它只处理这一部分。
4. 先看第一轮结果，再决定要不要追加条件、缩小范围或继续执行下一步。
5. 如果这条 Skill 确实好用，就把它保留在常用列表，后面重复任务直接复用。

你需要准备什么

• 与你当前任务相关的文件、网址、目录或数据。
• 要访问的网址或页面列表。
• 需要执行的网页操作目标。
• 如果涉及登录，还要准备可用账号或权限。
• 如果这条 Skill 依赖外部服务，还要准备对应账号权限或可用凭证。

你会看到什么结果

• 页面截图、抓取结果或结构化数据。
• 自动化执行后的页面结果。
• 可继续复用的网页操作流程。

风险提示

• 涉及 API Key、Token 或其他凭证时，先确认保存方式和权限边界。
• 如果会修改外部系统、本地文件或线上环境，建议先在测试环境跑最小流程。
• 依赖外部服务时，网络波动、配额限制或接口变化都会影响结果。
• 自动化页面流程容易受页面结构变化影响，正式使用前先跑一遍最小示例。

来源信息

• 公开页面地址: https://agentskillsrepo.com/skill/Sale-Smartly/api-skill
• SKILL.md 下载地址: https://agentskillsrepo.com/skill/Sale-Smartly/api-skill/download