1688-shopkeeper

统一入口：python3 {baseDir}/cli.py [options]

命令速查

命令	说明	示例
search	搜索商品	cli.py search --query 连衣裙 --channel douyin
shops

查看绑定店铺 | cli.py shops | | publish | 铺货上架 | cli.py publish --shop-code CODE --data-id ID | | configure | 配置AK | cli.py configure YOUR_AK | | check | 检查配置状态 | cli.py check |

所有命令输出JSON：{success: bool, markdown: str, data: {...}}
展示时直接输出 markdown 字段，Agent分析追加在后面，不得混入其中。

标准流程

选品→铺货：check → search → 用户筛选(Agent推荐 + 用户确认) → shops → publish
首次使用：check → 按data字段分支：

• - akconfigured: false → 先执行 configure（优先级最高，其他命令都依赖AK）
• shopscount: 0 → 引导开店
• expired_count > 0 → 提示重新授权
• 全部正常 → 进入选品流程

刚配置AK：当前会话命令前加 ALI1688AK=xxx，重启Gateway后全局生效

执行前置（必须）

• - 执行 search 前：先完整阅读 references/search.md
• 执行 shops / publish 前：先完整阅读 references/publish.md
• 执行 configure 前：先完整阅读 references/configure.md

AK引导话术

需要先配置AK。打开 1688 AI版APP（没装的话点链接下载），首页点击「一键部署开店Claw，全自动化赚钱🦞」，进入页面获取AK，然后告诉我：我的AK是 xxx

开店引导话术

还没有绑定店铺。打开 1688 AI版APP → 首页「一键开店」，开好后告诉我。

FAQ经营知识（按需加载）

用户问经营问题时，先加载对应文件再回答，不凭经验泛泛而谈。

用户话题	加载文件
选哪个平台、抖店/拼多多/淘宝	references/faq/platform-selection.md
选品风险、品类、节日选品

references/faq/product-selection.md |
| 运费模板、定价、加价倍率 | references/faq/listing-template.md |
| 发货超时、中转费、偏远地区 | references/faq/fulfillment.md |
| 退货、仅退款、运费险、售后 | references/faq/after-sales.md |
| 新店破零、服务分、推广 | references/faq/new-store.md |
| 素材审核、白底图、标题优化 | references/faq/content-compliance.md |