1688-shopkeeper
- Repo stars 1,322
- Author updated Live
- Author repo 1688-shopkeeper
- Domain
- Other
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @next-1688 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: 1688-shopkeeper
description: | 统一入口:python3 {baseDir}/cli.py <command> [options] runs entirely locally. Works with Claude Cod…
category: other
runtime: no special runtime
---
# 1688-shopkeeper output preview
## PART A: Task fit
- Use case: | 统一入口:python3 {baseDir}/cli.py <command> [options] runs entirely locally. Works with Claude Code, Cursor, Cline and 23 more..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “命令速查 / 使用流程 / 安全声明” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “| 统一入口:python3 {baseDir}/cli.py <command> [options] runs entirely locally. Works with Claude Code, Cursor, Cline and 23 more.”.
- **02** When the source has headings, the agent prioritizes “命令速查 / 使用流程 / 安全声明” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “命令速查 / 使用流程 / 安全声明”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: 1688-shopkeeper
description: | 统一入口:python3 {baseDir}/cli.py <command> [options] runs entirely locally. Works with Claude Cod…
category: other
source: next-1688/1688-shopkeeper
---
# 1688-shopkeeper
## When to use
- | 统一入口:python3 {baseDir}/cli.py <command> [options] 统一入口:python3 {baseDir}/cli.py <command [options] | 命令 | 说明 | 示例 |…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “命令速查 / 使用流程 / 安全声明” and keep inference separate from source facts.
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "1688-shopkeeper" {
input -> user goal + target files + boundaries + acceptance criteria
context -> 命令速查 / 使用流程 / 安全声明
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} 1688-shopkeeper
统一入口:python3 {baseDir}/cli.py <command> [options]
命令速查
| 命令 | 说明 | 示例 |
|---|---|---|
search |
找商品 | cli.py search --query "帮我找1688上支持一件代发包邮的露营椅,100元以内" --channel douyin |
prod_detail |
商品详情 | cli.py prod_detail --item-ids "991122553819,894138137003" |
shops |
查绑定店铺 | cli.py shops |
publish |
铺货 | cli.py publish --shop-code CODE --data-id ID |
opportunities |
商机热榜 | cli.py opportunities |
trend |
趋势洞察 | cli.py trend --query "大码女装" |
shop_daily |
店铺经营日报 | cli.py shop_daily |
configure |
配置 AK | cli.py configure YOUR_AK |
check |
检查配置状态 | cli.py check |
所有命令输出 JSON:{"success": bool, "markdown": str, "data": {...}}
展示时直接输出 markdown 字段,Agent 分析追加在后面,不得混入其中。
使用流程
Agent 根据用户意图直接执行对应命令,无需每次先执行 check。
各命令在 AK 缺失、店铺异常等情况下会自行返回明确错误,Agent 按下方「异常处理」应对即可。
选品铺货典型路径:search → 用户筛选 → shops(确认目标店铺) → publish
商品详情使用指引:
prod_detail:用户想看商品标题、价格、类目、SKU、CPV 属性、商家信息时使用。
商机/趋势使用指引:
opportunities:用户想看“此刻/近1小时/热榜/趋势商机”。trend:用户询问某宽泛类目/行业的周期趋势、价格分布、热品概况;关键词过长或过细时先按用户原词尝试,若空结果再提示用户换更宽泛/拆分词后重试。shop_daily:用户想看“店铺经营日报/今日动销/渠道经营诊断/主营商品选品建议”。
安全声明
| 风险级别 | 命令 | Agent 行为 |
|---|---|---|
| 只读 | search, shops, check, opportunities, trend, shop_daily | 直接执行 |
| 配置 | configure | 提示影响范围后执行 |
| 写入 | publish | 必须先 dry-run 预检查;仅当写入目标不唯一时追问,目标唯一则直接执行 |
全局写入规则(适用于所有写操作):
- 必须先执行 dry-run。
- 仅当写入目标不唯一(商品或店铺存在多个候选)时,才向用户追问一次做歧义消解。
- 目标唯一时,dry-run 成功后直接执行正式写入,不再二次确认。
异常处理
任何命令输出 success: false 时:
- 先输出
markdown字段(已包含用户可读的错误描述) - 再根据关键词追加引导:
| markdown 关键词 | Agent 额外动作 |
|---|---|
| "AK 未配置" 或 "签名无效"/"401" | 输出下方 AK 引导话术 |
| "授权过期" | 提示用户在 1688 AI版 APP 中重新授权 |
| "店铺未绑定" 或 shops 返回 0 个店铺 | 输出下方 开店引导话术 |
| "限流"/"429" | 建议用户等待 1-2 分钟后重试 |
| 其他 | 仅输出 markdown 即可 |
详细错误码说明见 references/common/error-handling.md。
执行前置(首次命中能力时必须)
- 首次执行
search前:先完整阅读references/capabilities/search.md - 首次执行
prod_detail前:先完整阅读references/capabilities/prod_detail.md - 首次执行
shops前:先完整阅读references/capabilities/shops.md - 首次执行
publish前:先完整阅读references/capabilities/publish.md - 首次执行
configure前:先完整阅读references/capabilities/configure.md - 首次执行
opportunities前:先完整阅读references/capabilities/opportunities.md - 首次执行
trend前:先完整阅读references/capabilities/trend.md - 首次执行
shop_daily前:先完整阅读references/capabilities/shop_daily.md - 同一会话内后续重复调用同一能力可复用已加载知识;仅在规则冲突或文档更新时重读。
AK 引导话术
"需要先配置 AK。打开 1688 AI版 APP(没装的话点链接下载),首页点击「一键部署开店Claw,全自动化赚钱🦞」,进入页面获取 AK,然后告诉我:'我的AK是 xxx'"
开店引导话术
"还没有绑定店铺。打开 1688 AI版APP → 首页「一键开店」,开好后告诉我。"
FAQ 知识库(按需加载)
用户问经营或技术问题时,先加载对应文件再回答,不凭经验泛泛而谈。
| 用户话题 | 加载文件 |
|---|---|
| AK 问题、铺货失败、支持平台、收费 | references/faq/base.md |
| 选哪个平台、抖店/拼多多/淘宝 | 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 |
Decide Fit First
Design Intent
How To Use It
Boundaries And Review