1688 Source Suppliers

SKILL.md

---
name: 1688-source-suppliers
version: "1.0.0"
description: |
  1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息
  核心工具能力：1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。
  触发词：找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。
  不触发场景：找商品/选品 → 1688-product-find；比价/换供 → 1688-product-compare；下单付款 → 不处理。
metadata: {"openclaw": {"emoji": "🏭", "requires": {"bins": ["python3"]}, "primaryEnv": "ALI_1688_AK"}}
---

# 1688-source-suppliers

## 意图判断

**触发本技能**：
- 找供应商、查供应商、1688供应商、供应商信息、工厂信息
- 查询某地区的工厂/产业带（如"常州灯具工厂"、"义乌小商品供应商"）
- 寻找某品类的生产厂家/加工厂

## 严格禁止（NEVER DO）

1. **不编造供应商信息**：禁止凭空生成不存在的公司名称、联系方式或地址
2. **不擅自改写查询关键字**：不得在未征得用户认可的情况下修改用户的查询意图
3. **不混入Agent分析内容**：供应商信息展示时，Agent 分析内容必须追加在最后，不得混入供应商数据中

## 命令速查

统一入口：`python3 {baseDir}/cli.py <command> [options]`

所有命令输出 JSON：`{"success": bool, "markdown": str, "data": {...}}`

| 命令 | 说明 | 示例 |
|------|------|------|
| `ali_1688_source_suppliers` | 查询1688供应商信息 | `cli.py ali_1688_source_suppliers --query "灯具供应商"` |
| `configure` | 配置 AK | `cli.py configure YOUR_AK` |

## 执行前置

首次执行命令前需先完整阅读 `references/capabilities/<命令名>.md`，同一会话内后续重复调用可复用已加载知识。

## 使用流程

**步骤1：提取查询关键字**
- 从用户消息中提取供应商名称或关键字
- 若关键字不明确，使用参数补齐引导话术追问用户：
  > "查询1688供应商信息需要提供查询关键字。你可以直接告诉我，例如：查询"灯具供应商"或"常州工厂"。"

**步骤2：调用工具查询**
- 执行命令：`python3 cli.py ali_1688_source_suppliers --query "<查询关键字>"`
- 等待工具返回结果

**步骤3：检查输出状态**
- 若 `success: true`：输出 `markdown` 字段内容 → 追加引导链接 → 可追加 Agent 分析
- 若 `success: false`：按「异常处理」章节处理

**步骤4：追加引导链接**
- 在供应商信息后追加：
  > 📌 [找更多优质供应商上1688](https://s.1688.com/company/company_search.htm)

## 输出规范

**数据质量要求**：
- 返回的供应商记录必须包含以下完整信息，缺少任一字段的记录将被自动过滤：
  - 公司名称（必填，不能为空）
  - 合作方式（必填，不能为空）
  - 服务（必填，不能为空）
- Agent在向用户展示供应商信息时，应确保所有推荐的供应商都包含完整的供应商名称

**输出顺序**：
1. 先输出 `markdown` 字段内容（供应商信息）
2. 再追加引导链接
3. 最后可追加 Agent 分析内容

**引导链接格式**：
> 📌 [找更多优质供应商上1688](https://s.1688.com/company/company_search.htm)

**输出示例**：
```json
{
  "success": true,
  "markdown": "找到 5 家供应商\n\n---\n\n### 供应商 1\n\n- 公司名称: [中山市致富照明有限公司](https://sale.1688.com/...)\n- 所在地区: 广东中山\n- 合作方式: OEM\n- 服务: 清加工, 包工包料",
  "data": {...}
}
```

## 异常处理

任何命令输出 `success: false` 时：

1. **先输出 `markdown` 字段**（已包含用户可读的错误描述）
2. **再根据关键词追加引导**：

| markdown 关键词 | Agent 额外动作 |
|----------------|--------------|
| "AK 未配置" 或 "签名无效" 或 "401" | 提示用户当前查询能力所需鉴权未就绪，请运行 `cli.py configure YOUR_AK` 配置 AK 后重试 |
| "参数缺失" 或 "query 不能为空" | 提示用户补充查询关键字后重试 |
| "限流" 或 "429" | 建议用户等待 1-2 分钟后重试 |
| "格式异常" 或 "服务异常" | 提示用户服务暂时不可用，请稍后重试 |
| 其他 | 仅输出 markdown 即可 |

## 安全声明

| 风险级别 | 命令 | Agent 行为 |
|---------|------|-----------|
| **读取** | ali_1688_source_suppliers | 当查询关键字明确时直接执行；信息缺失时先追问补齐 |

**全局读取规则**：
1. 查询类操作属于读取，当查询关键字明确时可直接执行
2. 当查询关键字不明确时，先向用户追问补齐后再执行
3. 不擅自扩写、改写用户的查询关键字；如需优化，应明确告知并征得用户认可