1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息 核心工具能力:1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。 触发词:找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。 不触发场景:找商品/选品 → 1688-product-find;比价/换供 →...
---
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. 不擅自扩写、改写用户的查询关键字;如需优化,应明确告知并征得用户认可
don't have the plugin yet? install it then click "run inline in claude" again.