agentCLAWHUBUnverified
1688 Marketing
1688营销 Skill —— 帮助商家进行招商活动报名、查看商机推荐等营销操作。 核心工具能力：招商活动查询、商品建议价查询、活动报名提交、商机推荐查询。 触发词：报名活动、招商活动、查询活动、提报、报名、活动报名、查看建议价、商机推荐、商机、市场机会、找商机、查商机，不要在用户仅询问非1688业务（如闲聊、天...
OpenClaw
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
0.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.1.0release · observed May 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s177df9srv6z2y0gd1kw90rern83hzxb:1688-marketing- Install using `clawhub skill install s177df9srv6z2y0gd1kw90rern83hzxb:1688-marketing` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/1688aiinfra/1688-marketing before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-marketing/snapshot"
Documentation
CLAWHUB
38,776 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: 1688-marketing
description: |
1688营销 Skill —— 帮助商家进行招商活动报名、查看商机推荐等营销操作。
核心工具能力：招商活动查询、商品建议价查询、活动报名提交、商机推荐查询。
触发词：报名活动、招商活动、查询活动、提报、报名、活动报名、查看建议价、商机推荐、商机、市场机会、找商机、查商机，不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。
metadata: {"openclaw": {"emoji": "🏷️","version": "1.0.0", "requires": {"bins": ["python3"]}, "primaryEnv": "ACCESS_KEY"}}
---
# 1688-marketing-skill
统一入口：`python3 {baseDir}/cli.py <command> [options]`
## 环境准备
> **重要**：本 skill 所在的整个目录文件需要先拷贝到 ${AGENT_WORK_ROOT}/workspace 目录下，再执行后续操作。
统一入口：`python3 {baseDir}/cli.py <command> [options]` 尽量使用绝对路径执行脚本
### Windows 权限问题（仅 Windows 用户需要）
若 skills 目录缺少执行权限（提示"拒绝访问"），需先将目录拷贝到 workspace 再操作：
```cmd
xcopy /E /I /Y "<skills目录路径>" "%USERPROFILE%\workspace\1688-auth-skill-for-wukong"
cd /d "%USERPROFILE%\workspace\1688-auth-skill-for-wukong"
```
> `/E` 递归复制所有子目录，`/I` 目标不存在时自动创建，`/Y` 覆盖时不询问确认。
> 拷贝完成后，后续所有命令均在 workspace 路径下执行。
首次使用前，在项目根目录执行：
```bash
pip install -r requirements.txt
# 若上述命令不可用，尝试：
pip3 install -r requirements.txt
```
依赖列表：仅使用 Python 标准库，无需额外安装第三方包。
## AK 安全说明
> ⚠️ **AK 是访问 1688 接口的唯一凭证，请妥善保管，避免泄漏。**
- AK 在本地以**设备绑定加密**方式存储（PBKDF2 派生密钥 + 流加密 + HMAC 校验），加密文件拷贝到其他机器后**无法解密**
- 不要将 AK 明文粘贴到聊天记录、截图、日志或版本控制中
- 不要将 `ak_store.json` 或 `.device_id` 上传到任何云端或共享目录
- 如怀疑 AK 已泄漏，立即执行 `cli.py configure --clear` 清除本地存储，并前往 [clawhub.1688.com](https://clawhub.1688.com/) 重新获取
## 意图判断
### 触发场景
当用户表达以下意图时，应触发本技能：
- **招商活动报名**: 报名活动、招商活动、查询活动、提报、报名、活动报名
- **商品建议价查询**: 查看建议价、查询价格、提报价
- **商机推荐查询**: 商机推荐、商机、市场机会、找商机、查商机
### 不触发场景
当用户仅询问以下非 1688 业务话题时，不应触发本技能：
- 闲聊（如：今天天气怎么样）
- 通用编程问题（如：帮我写一个 Python 排序算法）
- 翻译请求（如：帮我把这段话翻译成英文）
- 其他与 1688 营销无关的话题
## Tool 总览
| 工具名称 | 用途 | 调用方式 |
|----------|------|-----------------------------------------------------------------------------------------------------------------------------|
| `1688_enroll_activity_query` | 查询招商活动列表 | `python3 {baseDir}/cli.py 1688_enroll_activity_query [--keyword <关键词>] [--pageNo <页码>] [--pageSize <条数>]` |
| `1688_enroll_offer_query` | 查询商品建议提报价 | `python3 {baseDir}/cli.py 1688_enroll_offer_query --activityId <活动ID> --itemId <商品ID>` |
| `1688_enroll_submit_item` | 提交活动报名（⚠️写入） | `python3 {baseDir}/cli.py 1688_enroll_submit_item --activityId <活动ID> --itemId <商品ID> --fillFormDataList '<JSON>'` |
| `1688_opp_recommend` | 查询商机推荐列表 | `python3 {baseDir}/cli.py 1688_opp_recommend [--keyword <关键词>] [--categoryId <类目>] [--pageNo <页码>] [--pageSize <条数>]` |
| `configure` | 配置 AK（支持 --status / --clear / --reset） | `python3 {baseDir}/cli.py configure YOUR_AK` |
| `get_ak` | 获取AK | `cli.py get_ak` |
## 输出格式
所有命令统一输出 JSON 格式，结构如下：
```json
{
"success": true,
"markdown": "可选的用户可读描述",
"data": {},
"error_code": "可选的错误码（仅失败时）",
"required_scope": "可选的所需 OAuth S_meta.json
{
"ownerId": "kn76msg8cwkep3b08z7zffx9fx82p5wj",
"slug": "1688-marketing",
"version": "0.1.0",
"publishedAt": 1778051571463
}references/capabilities/1688_enroll_activity_query.md
# 1688招商活动查询指南
## 功能说明
查询1688招商活动列表，支持按活动ID或名称关键词搜索，支持分页。
## 前置条件
- 已配置 AK（未配置时会提示运行 `cli.py configure YOUR_AK`）
## CLI 调用
```bash
python3 {baseDir}/cli.py 1688_enroll_activity_query --pageNo 1 --pageSize 10 --keyword "活动名称"
```
### 参数说明
| 参数 | 缩写 | 是否必填 | 类型 | 说明 |
|------|------|----------|------|------|
| `--pageNo` | `-p` | 否 | Integer | 当前分页，默认1 |
| `--pageSize` | `-s` | 否 | Integer | 分页大小，默认10 |
| `--keyword` | `-k` | 否 | String | 活动Id或名称关键词 |
### 调用示例
```bash
# 查询第一页活动
python3 {baseDir}/cli.py 1688_enroll_activity_query
# 按关键词搜索
python3 {baseDir}/cli.py 1688_enroll_activity_query -k "618"
# 指定分页
python3 {baseDir}/cli.py 1688_enroll_activity_query -p 2 -s 20
```
## 输出格式
### 成功
```json
{
"success": true,
"markdown": "",
"data": {
"total": 5,
"pageNo": 1,
"pageSize": 10,
"data": [...]
}
}
```
## Agent 处理流程
```
1. 用户表达查询活动意图时，提取关键词（如有）
2. 执行 python3 {baseDir}/cli.py 1688_enroll_activity_query [--keyword <关键词>]
3. 检查输出：
- success=true → 展示活动列表，引导用户选择感兴趣的活动
- success=false → 原样输出错误信息
4. 用户选择活动后，可继续调用商品查询和报名流程
```
## 异常处理
| 场景 | Agent 应对 |
|------|-----------|
| AK 未配置 | 引导用户执行 `cli.py configure YOUR_AK` 配置 AK |
| 无匹配活动 | 提示用户更换关键词或查看全部活动 |
| 其他运行时异常 | 原样输出错误信息 |
通用 HTTP 异常（400/401/429/500）处理见 SKILL.md 异常处理章节。references/capabilities/1688_enroll_offer_query.md
# 1688招商活动商品信息及建议价查询指南
## 功能说明
根据活动ID和商品ID，查询商品信息及建议提报价格。报名前必须先调用此接口，让商家确认建议价后再提交报名。
## 前置条件
- 已配置 AK（未配置时会提示运行 `cli.py configure YOUR_AK`）
- 已知活动ID（可通过 `1688_enroll_activity_query` 获取）
- 已知商品ID
## CLI 调用
```bash
python3 {baseDir}/cli.py 1688_enroll_offer_query --activityId 12345 --itemId 67890
```
### 参数说明
| 参数 | 缩写 | 是否必填 | 类型 | 说明 |
|------|------|----------|------|------|
| `--activityId` | `-a` | ✅ 是 | Integer | 活动Id |
| `--itemId` | `-i` | ✅ 是 | Integer | 商品Id |
### 调用示例
```bash
python3 {baseDir}/cli.py 1688_enroll_offer_query -a 12345 -i 67890
```
## 输出格式
### 成功 — 无SKU商品（价格在商品级别）
```json
{
"success": true,
"markdown": "",
"data": {
"itemId": 67890,
"title": "商品名称",
"price": 100,
"suggestPrice": 80,
"skuList": []
}
}
```
### 成功 — 有SKU商品（价格在SKU级别）
```json
{
"success": true,
"markdown": "",
"data": {
"itemId": 67890,
"title": "商品名称",
"price": null,
"suggestPrice": null,
"skuList": [
{
"skuId": 111,
"title": "红色/XL",
"price": 100,
"suggestPrice": 80
},
{
"skuId": 222,
"title": "蓝色/L",
"price": 120,
"suggestPrice": 95
}
]
}
}
```
> **注意**：`skuList` 为空时，商品级别的 `price` 和 `suggestPrice` 有值；`skuList` 不为空时，价格在 SKU 级别，商品级别的 `price` 和 `suggestPrice` 为空。价格单位为分。
## Agent 处理流程
```
1. 用户选定活动后，询问要报名的商品ID
2. 执行 python3 {baseDir}/cli.py 1688_enroll_offer_query --activityId <活动ID> --itemId <商品ID>
3. 检查输出：
- success=true → 展示商品信息和建议提报价，询问商家是否确认以该价格提报
- success=false → 原样输出错误信息
4. 商家确认价格后，继续调用报名接口
```
## 异常处理
| 场景 | Agent 应对 |
|------|-----------|
| AK 未配置 | 引导用户执行 `cli.py configure YOUR_AK` 配置 AK |
| 参数缺失（activityId/itemId） | 提示用户补充缺少的参数 |
| 商品不存在或不符合活动要求 | 原样输出错误信息，建议用户确认商品ID |
| 其他运行时异常 | 原样输出错误信息 |
通用 HTTP 异常（400/401/429/500）处理见 SKILL.md 异常处理章节。references/capabilities/1688_enroll_submit_item.md
# 1688招商活动报名指南
## 功能说明
提交1688招商活动报名，报品同时报商。提交前需先通过 `1688_enroll_offer_query` 查询建议价并获得商家确认。
## 前置条件
- 已配置 AK（未配置时会提示运行 `cli.py configure YOUR_AK`）
- 已通过 `1688_enroll_offer_query` 查询商品建议价
- 商家已确认提报价格
## CLI 调用
```bash
python3 {baseDir}/cli.py 1688_enroll_submit_item --activityId 12345 --itemId 67890 --fillFormDataList '[{"inputKey":"fixPrice","inputValue":"0.8"}]'
```
### 参数说明
| 参数 | 缩写 | 是否必填 | 类型 | 说明 |
|------|------|----------|------|------|
| `--activityId` | `-a` | ✅ 是 | Integer | 活动Id |
| `--itemId` | `-i` | ✅ 是 | Integer | 商品Id |
| `--fillFormDataList` | `-f` | ✅ 是 | JSON String | 价格等表单填充数据列表 |
### fillFormDataList 格式
JSON 数组，每项包含：
| 字段 | 类型 | 说明 |
|------|------|------|
| `inputKey` | String | 表单key |
| `inputValue` | String | 表单值，商品无SKU时填此项 |
| `inputValueSku` | Object | 表单值，商品有SKU时填此项，key为skuId，value为对应值 |
#### 无SKU商品示例
```json
[{"inputKey": "fixPrice", "inputValue": "0.8"}]
```
#### 有SKU商品示例
```json
[{"inputKey": "fixPrice", "inputValueSku": {"111": "0.8", "222": "0.75"}}]
```
### 调用示例
```bash
# 无SKU商品报名
python3 {baseDir}/cli.py 1688_enroll_submit_item -a 12345 -i 67890 -f '[{"inputKey":"fixPrice","inputValue":"0.8"}]'
# 有SKU商品报名
python3 {baseDir}/cli.py 1688_enroll_submit_item -a 12345 -i 67890 -f '[{"inputKey":"fixPrice","inputValueSku":{"111":"0.8","222":"0.75"}}]'
```
## 输出格式
### 成功
```json
{
"success": true,
"markdown": "✅ 报名成功！记录ID: 99999",
"data": {
"success": true,
"recordId": 99999,
"message": ""
}
}
```
### 失败
```json
{
"success": false,
"markdown": "❌ 报名失败：xxx原因",
"data": {
"success": false,
"recordId": null,
"message": "失败原因"
}
}
```
## Agent 处理流程
```
1. 商家确认建议价后，根据商品是否有SKU构造 fillFormDataList，注意价格单位需要转为元
2. 执行 python3 {baseDir}/cli.py 1688_enroll_submit_item --activityId <活动ID> --itemId <商品ID> --fillFormDataList '<JSON>'
3. 检查输出：
- success=true → 告知商家报名成功，展示记录ID
- success=false → 原样输出错误信息
```
## 异常处理
| 场景 | Agent 应对 |
|------|-----------|
| AK 未配置 | 引导用户执行 `cli.py configure YOUR_AK` 配置 AK |
| 参数缺失 | 提示用户补充缺少的参数 |
| fillFormDataList 格式错误 | 提示用户检查 JSON 格式 |
| 报名失败（业务原因） | 原样输出错误信息中的 message |
| 其他运行时异常 | 原样输出错误信息 |
通用 HTTP 异常（400/401/429/500）处理见 SKILL.md 异常处理章节。Github ReposUpdated 1d agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/1688aiinfra/skills/1688-marketing",
"sourceUrl": "https://clawhub.ai/1688aiinfra/skills/1688-marketing",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T02:31:34.281Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-marketing/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-marketing/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T02:31:34.281Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/1688aiinfra/1688-marketing",
"sourceUrl": "https://clawhub.ai/1688aiinfra/1688-marketing",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T02:31:34.281Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.0",
"href": "https://clawhub.ai/1688aiinfra/1688-marketing",
"sourceUrl": "https://clawhub.ai/1688aiinfra/1688-marketing",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-06T07:12:51.463Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-marketing/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-marketing/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.0",
"description": "1688营销 Skill 首次发布，支持招商活动、商机推荐等基础营销操作。 - 支持查询1688招商活动列表、商机推荐及商品建议提报价。 - 支持提交招商活动报名，报名前需确认建议价。 - 提供详尽的错误处理、权限说明与环境配置指引。 - 明确区分与非1688相关话题，避免误触发。 - 首次执行需加载对应能力文档，提升安全性与合规性。",
"href": "https://clawhub.ai/1688aiinfra/1688-marketing",
"sourceUrl": "https://clawhub.ai/1688aiinfra/1688-marketing",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-06T07:12:51.463Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.