Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/next-1688--1688-source-suppliers/badge.svg)](/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

i

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)

  1. ---
  2. name: 1688-source-suppliers
  3. version: "1.0.0"
  4. description: |
  5. 1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息
  6. 核心工具能力:1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。
  7. 触发词:找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。
  8. 不触发场景:找商品/选品 → 1688-product-find;比价/换供 → 1688-product-compare;下单付款 → 不处理。
  9. metadata: {"openclaw": {"emoji": "🏭", "requires": {"bins": ["python3"]}, "primaryEnv": "ALI_1688_AK"}}
  10. ---
  11. # 1688-source-suppliers
  12. ## 意图判断
  13. **触发本技能**:
  14. - 找供应商、查供应商、1688供应商、供应商信息、工厂信息
  15. - 查询某地区的工厂/产业带(如"常州灯具工厂"、"义乌小商品供应商")
  16. - 寻找某品类的生产厂家/加工厂
  17. ## 严格禁止(NEVER DO)
  18. 1. **不编造供应商信息**:禁止凭空生成不存在的公司名称、联系方式或地址
  19. 2. **不擅自改写查询关键字**:不得在未征得用户认可的情况下修改用户的查询意图
  20. 3. **不混入Agent分析内容**:供应商信息展示时,Agent 分析内容必须追加在最后,不得混入供应商数据中
  21. ## 命令速查
  22. 统一入口:`python3 {baseDir}/cli.py <command> [options]`
  23. 所有命令输出 JSON:`{"success": bool, "markdown": str, "data": {...}}`
  24. | 命令 | 说明 | 示例 |
  25. |------|------|------|
  26. | `ali_1688_source_suppliers` | 查询1688供应商信息 | `cli.py ali_1688_source_suppliers --query "灯具供应商"` |
  27. | `configure` | 配置 AK | `cli.py configure YOUR_AK` |
  28. ## 执行前置
  29. 首次执行命令前需先完整阅读 `references/capabilities/<命令名>.md`,同一会话内后续重复调用可复用已加载知识。
  30. ## 使用流程
  31. **步骤1:提取查询关键字**
  32. - 从用户消息中提取供应商名称或关键字
  33. - 若关键字不明确,使用参数补齐引导话术追问用户:
  34. > "查询1688供应商信息需要提供查询关键字。你可以直接告诉我,例如:查询"灯具供应商"或"常州工厂"。"
  35. **步骤2:调用工具查询**
  36. - 执行命令:`python3 cli.py ali_1688_source_suppliers --query "<查询关键字>"`
  37. - 等待工具返回结果
  38. **步骤3:检查输出状态**
  39. - 若 `success: true`:输出 `markdown` 字段内容 → 追加引导链接 → 可追加 Agent 分析
  40. - 若 `success: false`:按「异常处理」章节处理
  41. **步骤4:追加引导链接**
  42. - 在供应商信息后追加:
  43. > 📌 [找更多优质供应商上1688](https://s.1688.com/company/company_search.htm)
  44. ## 输出规范
  45. **数据质量要求**:
  46. - 返回的供应商记录必须包含以下完整信息,缺少任一字段的记录将被自动过滤:
  47. - 公司名称(必填,不能为空)
  48. - 合作方式(必填,不能为空)
  49. - 服务(必填,不能为空)
  50. - Agent在向用户展示供应商信息时,应确保所有推荐的供应商都包含完整的供应商名称
  51. **输出顺序**:
  52. 1. 先输出 `markdown` 字段内容(供应商信息)
  53. 2. 再追加引导链接
  54. 3. 最后可追加 Agent 分析内容
  55. **引导链接格式**:
  56. > 📌 [找更多优质供应商上1688](https://s.1688.com/company/company_search.htm)
  57. **输出示例**:
  58. ```json
  59. {
  60. "success": true,
  61. "markdown": "找到 5 家供应商\n\n---\n\n### 供应商 1\n\n- 公司名称: [中山市致富照明有限公司](https://sale.1688.com/...)\n- 所在地区: 广东中山\n- 合作方式: OEM\n- 服务: 清加工, 包工包料",
  62. "data": {...}
  63. }
  64. ```
  65. ## 异常处理
  66. 任何命令输出 `success: false` 时:
  67. 1. **先输出 `markdown` 字段**(已包含用户可读的错误描述)
  68. 2. **再根据关键词追加引导**:
  69. | markdown 关键词 | Agent 额外动作 |
  70. |----------------|--------------|
  71. | "AK 未配置" 或 "签名无效" 或 "401" | 提示用户当前查询能力所需鉴权未就绪,请运行 `cli.py configure YOUR_AK` 配置 AK 后重试 |
  72. | "参数缺失" 或 "query 不能为空" | 提示用户补充查询关键字后重试 |
  73. | "限流" 或 "429" | 建议用户等待 1-2 分钟后重试 |
  74. | "格式异常" 或 "服务异常" | 提示用户服务暂时不可用,请稍后重试 |
  75. | 其他 | 仅输出 markdown 即可 |
  76. ## 安全声明
  77. | 风险级别 | 命令 | Agent 行为 |
  78. |---------|------|-----------|
  79. | **读取** | ali_1688_source_suppliers | 当查询关键字明确时直接执行;信息缺失时先追问补齐 |
  80. **全局读取规则**:
  81. 1. 查询类操作属于读取,当查询关键字明确时可直接执行
  82. 2. 当查询关键字不明确时,先向用户追问补齐后再执行
  83. 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)

  1. # 1688找供应商
  2. 一个用于查询1688供应商及工厂信息的命令行工具。
  3. ## 功能特性
  4. - 根据供应商名称或关键字查询1688供应商信息
  5. - 支持按地区、行业等条件筛选供应商
  6. - 简单易用的CLI命令行界面
  7. - 自动AK管理和签名认证
  8. ## 安装
  9. ### 前置要求
  10. - Python 3.6 或更高版本
  11. - pip(Python包管理器)
  12. ### 安装依赖
  13. ```bash
  14. pip install -r requirements.txt
  15. ```
  16. ## 快速开始
  17. ### 1. 配置AK
  18. 首次使用前需要配置Access Key(AK):
  19. ```bash
  20. python3 cli.py configure YOUR_ACCESS_KEY
  21. ```
  22. ### 2. 查询供应商
  23. ```bash
  24. # 查询特定供应商
  25. python3 cli.py ali_1688_source_suppliers --query "灯具供应商"
  26. # 使用缩写参数
  27. python3 cli.py ali_1688_source_suppliers -q "常州工厂"
  28. ```
  29. ## 使用说明
  30. ### 命令列表
  31. | 命令 | 说明 |
  32. |------|------|
  33. | `ali_1688_source_suppliers` | 查询1688供应商信息 |
  34. | `configure` | 配置或查看AK状态 |
  35. ### 参数说明
  36. #### ali_1688_source_suppliers
  37. | 参数 | 缩写 | 必填 | 说明 |
  38. |------|------|------|------|
  39. | `--query` | `-q` | 是 | 供应商名称或关键字 |
  40. #### configure
  41. | 参数 | 说明 |
  42. |------|------|
  43. | `[AK]` | 可选,提供AK则进行配置,不提供则查看当前状态 |
  44. ### 输出格式
  45. 所有命令输出均为JSON格式:
  46. ```json
  47. {
  48. "success": true,
  49. "markdown": "操作说明信息",
  50. "data": {
  51. "data": {
  52. // 具体数据
  53. }
  54. }
  55. }
  56. ```
  57. ## 常见问题
  58. ### AK未配置
  59. 如果提示"AK 未配置",请运行:
  60. ```bash
  61. python3 cli.py configure YOUR_ACCESS_KEY
  62. ```
  63. ### AK无效
  64. 如果AK无效或已过期,请:
  65. 1. 检查AK是否正确
  66. 2. 重新配置AK:`python3 cli.py configure YOUR_ACCESS_KEY`
  67. 3. 如果配置后仍未生效,尝试重启OpenClaw或执行 `openclaw secrets reload`
  68. ### 网络错误
  69. 如果遇到网络错误:
  70. 1. 检查网络连接
  71. 2. 稍后重试
  72. 3. 检查防火墙设置
  73. ## 项目结构
  74. ```
  75. 1688-source-suppliers/
  76. ├── cli.py # CLI入口
  77. ├── SKILL.md # Skill定义
  78. ├── requirements.txt # Python依赖
  79. ├── scripts/ # 核心脚本
  80. │ ├── _auth.py # 认证模块
  81. │ ├── _http.py # HTTP客户端
  82. │ ├── _const.py # 全局常量
  83. │ ├── _errors.py # 异常定义
  84. │ ├── _output.py # 输出工具
  85. │ └── capabilities/ # 功能实现
  86. │ ├── configure/ # AK配置
  87. │ └── ali_1688_source_suppliers/ # 供应商查询
  88. └── references/ # 参考文档
  89. └── capabilities/
  90. ├── configure.md
  91. └── ali_1688_source_suppliers.md
  92. ```
  93. ## 开发
  94. ### 运行测试
  95. ```bash
  96. # 查看帮助
  97. python3 cli.py
  98. # 测试配置命令
  99. python3 cli.py configure
  100. # 测试查询命令
  101. python3 cli.py ali_1688_source_suppliers --help
  102. ```
  103. ### 代码规范
  104. - 遵循PEP 8代码风格
  105. - 使用类型注解
  106. - 添加必要的文档字符串
  107. ## 许可证
  108. [许可证信息]
  109. ## 联系方式
  110. 如有问题或建议,请联系项目维护者。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.