1688 Marketing — 1688 营销

1688-marketing-skill 统一入口：python3 {baseDir}/cli.py [options] 环境准备 重要：本 skill 所在的整个目录文件需要先拷贝到 ${AGENT_WORK_ROOT}/workspace 目录下，再执行后续操作。 统一入口：python3 {baseDir}/cli.py [options] 尽量使用绝对路径执行脚本 Windows 权限问题（仅 Windows 用户需要） 若 skills 目录缺少执行权限（提示"拒绝访问"），需先将目录拷贝到 workspace 再操作： xcopy /E /I /Y "" "%USERPROFILE%\workspace\1688-auth-skill-for-wukong" cd /d "%USERPROFILE%\workspace\1688-auth-skill-for-wukong" /E 递归复制所有子目录，/I 目标不存在时自动创建，/Y 覆盖时不询问确认。 拷贝完成后，后续所有命令均在 workspace 路径下执行。 首次使用前，在项目根目录执行： 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 重新获取 意图判断 触发场景 当用户表达以下意图时，应触发本技能： 招商活动报名: 报名活动、招商活动、查询活动、提报、报名、活动报名 商品建议价查询: 查看建议价、查询价格、提报价 商机推荐查询: 商机推荐、商机、市场机会、找商机、查商机 不触发场景 当用户仅询问以下非 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 '' 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 格式，结构如下： { "success": true, "markdown": "可选的用户可读描述", "data": {}, "error_code": "可选的错误码（仅失败时）", "required_scope": "可选的所需 OAuth Scope（仅授权错误时）" } 仅包含非空字段。error_code 和 required_scope 用于 Agent 自动识别网关授权错误并触发恢复流程。 使用流程 Agent 根据用户意图识别所属功能模块，按对应流程执行： 流程一：招商活动报名 查询活动：用户表达报名意图时，先调用 1688_enroll_activity_query 查询招商活动，展示活动列表供用户选择 查询建议价：用户选定活动和商品后，调用 1688_enroll_offer_query 查询商品信息和建议提报价，展示给商家确认，此接口返回的价格单位为分。当建议价为空时，中断流程，提示商家无法报名此活动 确认价格：必须等商家明确确认建议价后，才能进入报名步骤 提交报名：商家确认后，根据商品是否有 SKU 构造 fillFormDataList，调用 1688_enroll_submit_item 提交报名，此接口入参价格单位为元 流程二：商机推荐查询 明确意图：用户表达查看商机、市场机会的意图 收集筛选条件：从用户消息中提取关键词、类目等筛选条件（均为可选） 执行查询：调用 1688_opp_recommend 查询商机推荐列表 展示结果：将商机列表以易读格式展示（标题、类目、求购数、参考价格等），如有更多结果提示用户可翻页 各命令在 AK 缺失等情况下会自行返回明确错误，Agent 按下方「异常处理」应对即可。 安全声明 风险级别 命令 Agent 行为 只读 1688_enroll_activity_query 直接执行 只读 1688_enroll_offer_query 直接执行 只读 1688_opp_recommend 直接执行 写入 1688_enroll_submit_item 必须在商家确认建议价后才能执行，不得自动提交 全局写入规则（适用于所有写操作）： 所有写入操作必须经过商家明确确认，不得自动执行。 提交报名前，必须先查询建议价并展示给商家；商家明确确认价格后，方可提交报名。 不擅自修改商家确认的任何参数。 环境变量（.env） 项目根目录的 .env 文件存储 skill 基础信息，供埋点上报等模块读取。发布到不同环境时可直接替换该文件中的变量值。 变量 默认值 说明 SKILL_NAME 1688-marketing skill 名称 SKILL_VERSION 1.0.0 skill 版本号 SKILL_CHANNEL clawhub 发布渠道 已存在的系统环境变量优先级高于 .env，CI/CD 注入的变量不会被覆盖。 埋点上报 每次 CLI 命令执行时，自动向 skill 网关上报一次调用记录，用于统计 skill 调用次数。 实现位置：scripts/_tracker.py → report_skill_usage()，在 cli.py 的 main() 中每次命令执行后自动调用 上报接口：POST /api/reportSkillsUsage/1.0.0 上报参数： 参数 值来源 说明 apiName 固定 null 固定传 null skillsName .env SKILL_NAME skill 名称 version .env SKILL_VERSION skill 版本号 scene 固定 CLI 固定值 channel .env SKILL_CHANNEL 发布渠道 失败处理：上报失败静默忽略，不影响主流程 执行前置（首次命中能力时必须） 首次执行 1688_enroll_activity_query 前：先完整阅读 references/capabilities/1688_enroll_activity_query.md 首次执行 1688_enroll_offer_query 前：先完整阅读 references/capabilities/1688_enroll_offer_query.md 首次执行 1688_enroll_submit_item 前：先完整阅读 references/capabilities/1688_enroll_submit_item.md 首次执行 1688_opp_recommend 前：先完整阅读 references/capabilities/1688_opp_recommend.md 首次执行 configure 前：先完整阅读 references/capabilities/configure.md 同一会话内后续重复调用可复用已加载知识；仅在规则冲突或文档更新时重读。 授权链接处理（browser_use） get_ak 和 authorize 命令输出一条 JSON 后立即退出，回调服务器作为独立后台进程继续运行（最长 300 秒）。 输出格式： { "pending": true, "action": "browser_use", "url": "https://...", "markdown": "授权链接已生成！请使用 browser_use 工具打开以下链接完成授权..." } 强制动作：输出中只要出现 "action": "browser_use"，Agent 必须立即调用 browser_use 工具打开 url 字段中的链接，不得跳过、延迟或用其他方式替代。 Agent 处理流程： 读到 "action": "browser_use" → 立即用 browser_use 工具导航到 url，并