← 返回 Skills 市场
1688aiinfra

1688 Source Suppliers

作者 1688AiInfra · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
6
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install 1688-source-suppliers
功能描述
1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息 核心工具能力:1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。 触发词:找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。 不触发场景:找商品/选品 → 1688-product-find;比价/换供 →...
使用说明 (SKILL.md)

1688-source-suppliers

意图判断

触发本技能

  • 找供应商、查供应商、1688供应商、供应商信息、工厂信息
  • 查询某地区的工厂/产业带(如"常州灯具工厂"、"义乌小商品供应商")
  • 寻找某品类的生产厂家/加工厂

严格禁止(NEVER DO)

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

命令速查

统一入口:python3 {baseDir}/cli.py \x3Ccommand> [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/\x3C命令名>.md,同一会话内后续重复调用可复用已加载知识。

使用流程

步骤1:提取查询关键字

  • 从用户消息中提取供应商名称或关键字
  • 若关键字不明确,使用参数补齐引导话术追问用户:

    "查询1688供应商信息需要提供查询关键字。你可以直接告诉我,例如:查询"灯具供应商"或"常州工厂"。"

步骤2:调用工具查询

  • 执行命令:python3 cli.py ali_1688_source_suppliers --query "\x3C查询关键字>"
  • 等待工具返回结果

步骤3:检查输出状态

  • success: true:输出 markdown 字段内容 → 追加引导链接 → 可追加 Agent 分析
  • success: false:按「异常处理」章节处理

步骤4:追加引导链接

输出规范

数据质量要求

  • 返回的供应商记录必须包含以下完整信息,缺少任一字段的记录将被自动过滤:
    • 公司名称(必填,不能为空)
    • 合作方式(必填,不能为空)
    • 服务(必填,不能为空)
  • Agent在向用户展示供应商信息时,应确保所有推荐的供应商都包含完整的供应商名称

输出顺序

  1. 先输出 markdown 字段内容(供应商信息)
  2. 再追加引导链接
  3. 最后可追加 Agent 分析内容

引导链接格式

📌 找更多优质供应商上1688

输出示例

{
  "success": true,
  "markdown": "找到 5 家供应商\
\
---\
\
### 供应商 1\
\
- 公司名称: [中山市致富照明有限公司](https://sale.1688.com/...)\
- 所在地区: 广东中山\
- 合作方式: OEM\
- 服务: 清加工, 包工包料",
  "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. 不擅自扩写、改写用户的查询关键字;如需优化,应明确告知并征得用户认可
安全使用建议
Review the AK configuration behavior before installing. The supplier lookup itself appears aligned with the stated purpose, but confirm that saving the credential under `1688-shopkeeper` is intentional and will not overwrite or expose credentials for another OpenClaw skill.
功能分析
Type: OpenClaw Skill Name: 1688-source-suppliers Version: 1.0.0 The skill bundle provides a legitimate interface for searching 1688 suppliers and factories. It follows standard OpenClaw patterns for authentication (HMAC-SHA256 signing), configuration management (writing to ~/.openclaw/openclaw.json), and communication with a dedicated gateway (skills-gateway.1688.com). No evidence of malicious intent, data exfiltration to unauthorized endpoints, or prompt injection was found; minor naming inconsistencies in the configuration scripts (referencing '1688-shopkeeper') appear to be unintentional development artifacts.
能力标签
requires-sensitive-credentials
能力评估
Purpose & Capability
The core capability—querying 1688 supplier/factory information from a user-provided keyword—is coherent with the description and uses a disclosed 1688 gateway API.
Instruction Scope
The skill instructs the agent to run read-only supplier queries when the keyword is clear and to ask follow-up questions when it is not; this is proportionate, but it also instructs configuration of an AK when provided.
Install Mechanism
There is no automatic install spec. The README documents a manual `pip install -r requirements.txt` step with a standard `requests` dependency.
Credentials
Credential setup mutates OpenClaw configuration and uses the config entry name `1688-shopkeeper`, while the declared skill is `1688-source-suppliers`; this mismatch could affect or reuse another skill’s credential configuration.
Persistence & Privilege
The configure command can persist an AK through the OpenClaw gateway or by writing `~/.openclaw/openclaw.json`; persistence is purpose-aligned, but the different target skill name makes the boundary unclear.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install 1688-source-suppliers
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /1688-source-suppliers 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
1688-source-suppliers v1.0.0 - Initial release with supplier search capability for 1688 platform. - Supports querying suppliers and factories by user-provided keywords. - Enforces strict output completeness: supplier name, cooperation type, and services required. - Includes detailed error handling and user guidance for missing or invalid parameters. - Provides clear instructions for tool usage, output sequence, and safe execution. - Ensures no supplier info is fabricated and query intent is not altered without user consent.
元数据
Slug 1688-source-suppliers
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

1688 Source Suppliers 是什么?

1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息 核心工具能力:1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。 触发词:找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。 不触发场景:找商品/选品 → 1688-product-find;比价/换供 →... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 6 次。

如何安装 1688 Source Suppliers?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install 1688-source-suppliers」即可一键安装,无需额外配置。

1688 Source Suppliers 是免费的吗?

是的,1688 Source Suppliers 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

1688 Source Suppliers 支持哪些平台?

1688 Source Suppliers 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 1688 Source Suppliers?

由 1688AiInfra(@1688aiinfra)开发并维护,当前版本 v1.0.0。

💬 留言讨论