1688-source-suppliers
1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息 核心工具能力:1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。 触发词:找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。 不触发场景:找商品/选品 → 1688-product-find;比价/换供 → 1688-product-compare;下单付款 → 不处理。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/next-1688--1688-source-suppliers)HTML
<a href="/listings/next-1688--1688-source-suppliers"><img src="/api/listings/next-1688--1688-source-suppliers/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
前置要求
- Python 3.6 或更高版本 - pip(Python包管理器)
安装依赖
pip install -r requirements.txt
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 111 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- 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. 不擅自扩写、改写用户的查询关键字;如需优化,应明确告知并征得用户认可
README.md · README · 159 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 1688找供应商
- 一个用于查询1688供应商及工厂信息的命令行工具。
- ## 功能特性
- - 根据供应商名称或关键字查询1688供应商信息
- - 支持按地区、行业等条件筛选供应商
- - 简单易用的CLI命令行界面
- - 自动AK管理和签名认证
- ## 安装
- ### 前置要求
- - Python 3.6 或更高版本
- - pip(Python包管理器)
- ### 安装依赖
- ```bash
- pip install -r requirements.txt
- ```
- ## 快速开始
- ### 1. 配置AK
- 首次使用前需要配置Access Key(AK):
- ```bash
- python3 cli.py configure YOUR_ACCESS_KEY
- ```
- ### 2. 查询供应商
- ```bash
- # 查询特定供应商
- python3 cli.py ali_1688_source_suppliers --query "灯具供应商"
- # 使用缩写参数
- python3 cli.py ali_1688_source_suppliers -q "常州工厂"
- ```
- ## 使用说明
- ### 命令列表
- | 命令 | 说明 |
- |------|------|
- | `ali_1688_source_suppliers` | 查询1688供应商信息 |
- | `configure` | 配置或查看AK状态 |
- ### 参数说明
- #### ali_1688_source_suppliers
- | 参数 | 缩写 | 必填 | 说明 |
- |------|------|------|------|
- | `--query` | `-q` | 是 | 供应商名称或关键字 |
- #### configure
- | 参数 | 说明 |
- |------|------|
- | `[AK]` | 可选,提供AK则进行配置,不提供则查看当前状态 |
- ### 输出格式
- 所有命令输出均为JSON格式:
- ```json
- {
- "success": true,
- "markdown": "操作说明信息",
- "data": {
- "data": {
- // 具体数据
- }
- }
- }
- ```
- ## 常见问题
- ### AK未配置
- 如果提示"AK 未配置",请运行:
- ```bash
- python3 cli.py configure YOUR_ACCESS_KEY
- ```
- ### AK无效
- 如果AK无效或已过期,请:
- 1. 检查AK是否正确
- 2. 重新配置AK:`python3 cli.py configure YOUR_ACCESS_KEY`
- 3. 如果配置后仍未生效,尝试重启OpenClaw或执行 `openclaw secrets reload`
- ### 网络错误
- 如果遇到网络错误:
- 1. 检查网络连接
- 2. 稍后重试
- 3. 检查防火墙设置
- ## 项目结构
- ```
- 1688-source-suppliers/
- ├── cli.py # CLI入口
- ├── SKILL.md # Skill定义
- ├── requirements.txt # Python依赖
- ├── scripts/ # 核心脚本
- │ ├── _auth.py # 认证模块
- │ ├── _http.py # HTTP客户端
- │ ├── _const.py # 全局常量
- │ ├── _errors.py # 异常定义
- │ ├── _output.py # 输出工具
- │ └── capabilities/ # 功能实现
- │ ├── configure/ # AK配置
- │ └── ali_1688_source_suppliers/ # 供应商查询
- └── references/ # 参考文档
- └── capabilities/
- ├── configure.md
- └── ali_1688_source_suppliers.md
- ```
- ## 开发
- ### 运行测试
- ```bash
- # 查看帮助
- python3 cli.py
- # 测试配置命令
- python3 cli.py configure
- # 测试查询命令
- python3 cli.py ali_1688_source_suppliers --help
- ```
- ### 代码规范
- - 遵循PEP 8代码风格
- - 使用类型注解
- - 添加必要的文档字符串
- ## 许可证
- [许可证信息]
- ## 联系方式
- 如有问题或建议,请联系项目维护者。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.