--- name: "ljxp" description: "蓝鲸选品助手是由深圳领东时代科技有限公司(https://www.lingdongsz.com/)推出的美客多官方SPN认证数据选品运营分析Skill，全面覆盖墨西哥、巴西、阿根廷、智利、哥伦比亚站点。支持调用蓝鲸选品 API 结合本地脚本，一站式获取美客多商品、类目、关键词、定价、竞品动态、店铺、品牌、目录链接、运费、汇率多维数据，助力美客多选品精细化运营。" version: "2.0.1" author: "蓝鲸选品" --- # 蓝鲸选品 Mercado Libre 选品调研工具。**先澄清意图再调用脚本**（API 消耗 1\~10 积分/次，方向错浪费积分）。 ## 前置要求 - Authorization Token（配置 `LJXP_TOKEN` 环境变量或用户提供）；**不要在回复中暴露 Token ;**  - 用户未提供 Token 时，将 Token 获取入口发给用户： （蓝鲸选品 Skill 服务页；官网 - 支持站点：`MLM`、`MLB`、`MLC`、`MLA`、`MCO` - API 基础：`https://xpskills.lingdongsz.com/api`；脚本使用 Python 标准库
## 标准 9 步流程（严格顺序，打 ✅ 绝对不能跳） ``` Step1 确认需求 → Step2 选功能 → Step3 查参考文档 → Step4 调脚本拿数据 → Step5 数据分析 → Step6 业务结论 → Step7 积分统计 → Step8 后续引导 → Step9（可选）问HTML ``` | 步骤 | 做什么 | 必做 | 何时可省 | | -------------- | -------------------------------------- | :-: | ------------- | | Step1 确认用户需求 | 站点/类目/分析目标/关键参数齐全？ | ✅ | 永不省；缺信息先澄清再继续 | | Step2 选功能 | 从 10 类业务功能中选对应项 | ✅ | 永不省 | | Step3 查该功能参考文档 | 打开 `references/api/<模块>.md` 确认参数/积分/字段 | ✅ | 永不省 | | Step4 调脚本拿数据 | 执行对应脚本取原始返回 | ✅ | 纯咨询类无数据需求时省 | | Step5 结合数据分析 | 对比、归纳、找规律 | ✅ | 永不省 | | Step6 给业务结论 | 关键数据+机会等级+风险+推荐动作+复现条件 | ✅ | 永不省 | | Step7 积分消耗统计 | 列出调用明细+合计 | ✅ | 永不省 | | Step8 后续分析引导 | 推荐强相关下一步方向 | ✅ | 永不省 | | Step9 询问HTML展示 | 主动询问是否需HTML | ❌ | 用户明确要/不要时省 |
## Step1 意图澄清（查询前必读） ### 何时必须先提问（满足任一即不可直接执行） - ❌ 未指定站点（MLM/MLB/MLC/MLA/MCO） - ❌ 未指定类目或关键词 - ❌ 分析目标模糊（如"帮我看看市场"） - ❌ 关键参数缺失（热搜词未给日期、趋势未给类目ID等） - ❌ 多方向并存、优先级不明 ### 何时可直接执行 站点 + 类目/关键词 + 分析目标 + 必要参数 齐全。 **目标无法对应下方清单中某一具体分析类型 → 视为模糊，先提问。** 常见模糊表述："查 XX 销量怎么样"（宏观类目大盘 / 微观商品表现 / 两者都要）。追问模板：「看类目大盘 / 看具体商品 / 两者都要？」 ### 各分析类型必填参数清单 > **【类目树极其重要】** 后端 `GET /category/tree` **只接受** **`siteId`** **一个参数**。`--depth`/`--search`/`--refresh` 是脚本本地后处理，**绝对不能发给后端**。 | 分析类型 | 后端必填参数 | 脚本本地处理参数（不发后端） | 对应脚本 | | ---------- | ------------------------- | -------------------------------- | ------------------------------- | | 类目树查询/定位ID | 站点（siteId） | `--depth` `--search` `--refresh` | `category_tree.py` | | 类目机会评估 | 站点、类目ID | — | `trends.py` | | 价格带分析 | 站点、类目ID | 目标价格范围 | `trends.py`（--type price\_list） | | 关键词研究 | 站点、查询类型(day/month)、日期 | 类目ID、搜索词 | `search_keywords.py` | | 竞品分析 | 站点、搜索条件(关键词/类目/店铺ID 至少其一) | 价格范围、销量范围、排序 | `search_items.py` | | 店铺分析 | 站点、筛选条件(类型/等级/店铺ID 至少其一) | 具体店铺ID | `search_sellers.py` | | 品牌格局分析 | 站点、类目ID | 关注品牌 | `trends.py`（--type top\_brands） | | 目录链接机会 | 站点、搜索条件(关键词/类目 至少其一) | 跟卖状态、价格范围 | `catalog_search.py` | | 利润测算 | 站点、商品信息(价格/重量) | 成本、目标利润率 | `get_item_info.py` + 运费查询 | > 类目 ID 格式如 `MLM458037`。只有品类名时优先 `category_tree.py --site <站点> --search <关键词>` 本地过滤定位（首次 10 积分，命中缓存免费，缓存 7 天，`--refresh` 强制刷新）。 ### 澄清原则（提问时） 一次性问完、给默认值建议、用选项引导、简要说明用途、不过度提问。
## Step2 10 类业务功能 1. 类目树查询 / 定位 ID 2. 类目机会评估 3. 价格带分析 4. 关键词研究 5. 竞品分析 / 商品搜索 / 商品详情 6. 店铺分析 7. 品牌格局分析 8. 目录链接机会 9. 利润测算 10. 套餐 / 积分余额查询 详细执行步骤见下方「各分析流程」小节。 ## Step3 查参考文档时确认 3 件事 | 确认项 | 去哪里看 | | ------------------- | ---------------------------------------- | | ① 必填/可选参数、后端真实接什么参数 | `references/api/<模块>.md` 「接口选择规则 / 请求参数」 | | ② 单次积分消耗、缓存/免费规则 | 各模块末尾「本模块接口积分明细表」 | | ③ 返回字段真实含义（业务判断用） | 各模块字段说明章节 | > 套餐查询额外看 `users.md` 中「各接口积分定价全表」。 *** ## 调用红线（空结果 / 异常处理） **触发条件**：当AI对接口或脚本有疑惑并想通过调用接口来查找错误时 **处理顺序（跳过任何一步都算违规）**： 1. 停止所有后续脚本调用，不硬凑分析/结论 2. 回读 `references/api/<模块>.md` 核对参数（站点、必填、枚举、后端 vs 本地参数口径、缓存规则） 3. ① 2-3 条具体原因 + 每个调整方案的【调用次数 × 单次积分】预估； 4. **等用户明确同意再调用** **唯一例外**：用户消息明确写「多试几个参数」「全跑一遍」时可连调，但仍需先写明「几次 × 多少积分」，结束后 Step7 完整列明细。 *** ## Step4 常用脚本路径 > 🛑 先读上方「调用红线」：空/异常禁止自动改参数重调烧积分，停 → 查文档 → 给原因+预估 → 等同意。 类目树：`scripts/category_tree.py` ｜ 商品搜索/详情：`scripts/search_items.py` / `scripts/get_item_info.py` ｜ 店铺：`scripts/search_sellers.py` ｜ 热搜词：`scripts/search_keywords.py` ｜ 目录链接：`scripts/catalog_search.py` ｜ 行业趋势：`scripts/trends.py`（各模块文档中有详细对应路径） ## Step5 分析维度 高低/占比/趋势/供需缺口/集中度/本土跨境差异；价格带、销量、类目、品牌、店铺、关键词交叉分析。 ## Step6 业务结论 6 要素 关键数据（核心指标一句话）｜ 机会等级（推荐/谨慎/暂不建议）｜ 主要风险（2-3条）｜ 推荐动作（明确下一步）｜ 筛选条件/脚本（可复现）｜ 需补充信息（如有） > 套餐查询输出规范详见 `references/api/users.md`：先用户信息(nickName+phoneNo)→套餐列表→汇总积分；`tcCount`/`useCount` 必须读作「积分」禁止说「次数」。 ## Step7 积分消耗统计（每次结尾必附） ``` --- ### 📊 本次积分消耗 | 功能 | 调用次数 | 单次积分 | 小计 | |:---|---:|---:|---:| | 商品查询 | 1 | 5 | 5 | | 店铺查询 | 1 | 2 | 2 | **合计消耗：7 积分** ``` 规则： 1. 只列本次实际调用的接口功能名（用各模块积分表的「功能描述」） 2. 同一接口多次调用累计次数和小计 3. 类目树缓存命中：调用次数1、单次积分0、备注「(本地缓存命中，免费)」；首次或 `--refresh` 记 10 积分 4. 末尾必须有「合计消耗：X 积分」 5. 纯咨询未调 API：说明「本次未调用 API，不消耗积分」 6. **积分不足 / 套餐用尽（返回积分余额为 0 或不够本次消耗）时，告知用户并附上充值入口：** - 👉 充值续费入口： 7. **空结果/异常重试积分（联动「调用红线」）**：未经用户同意就自动重调产生的积分也要如实列出，合计下方追加：`⚠️ 说明：XX、YY 两次为空重试，共 Z 积分。后续调整需您确认（见「调用红线」）。` ## Step8 后续分析引导（每次必问） 先推荐 2-3 个和本次最相关的下一步方向，再补兜底： > 「这个技能还支持：**商品分析、行业与趋势分析、竞争分析、店铺分析、关键词研究、目录链接分析、物流与汇率查询、利润测算**。你接下来想做哪块？直接说目标站点和想查的品类就行，我帮你一步步跑。」 ## Step9 HTML 生成策略 1. **默认不生成**，以 Markdown 表格+文字交付 2. 列表类结果在回答末尾主动问：「需要为你生成 HTML 格式的对比结果（可直接在浏览器打开）吗？」 3. 生成时：用 `references/search_results_template.html` 作模板，文件输出到用户工作目录，给绝对路径链接 *** ## 各分析流程（Step2 详细步骤，每个流程第一步均为「确认关键参数」） ### 类目树查询 / 定位类目 ID 1. **确认参数**：站点（必选）；只有品类名无 ID 时走本流程 2. 定位：优先关键词过滤，无关键词逐层浏览 3. 结果让用户核对中英文名称，ID 传给下游趋势/搜索/关键词/目录链接等流程 ### 类目机会评估 1. **确认参数**：站点、类目ID（无ID先走类目树） 2. 查：行业趋势+价格分布+头部店铺+头部品牌+代表商品 3. 判断：市场容量/竞争强度/品牌集中度/本土跨境格局 4. 输出：推荐/谨慎/暂不建议 + 下一步（价格/关键词/竞品/上架策略） ### 价格带分析 1. **确认参数**：站点、类目ID（+目标价格范围如有） 2. 查价格分布 → 对比各区间商品数和销量 → 找需求高供给少的价格带 → 拉热门商品验证 3. 输出：建议定价+避开价格带+参考商品 ### 关键词研究 1. **确认参数**：站点、查询类型(day/month)、查询日期（+类目/搜索词如有） 2. 查热搜词 → 关注搜索量高/访问量高/销量好/商品数少的词 → 用商品搜索验证供给竞争 3. 输出：自然流量词+广告词+长尾词+不建议投入的词 ### 竞品分析 1. **确认参数**：站点、搜索条件(关键词/类目ID/店铺ID 至少其一，推荐+价格范围/销量范围/排序) 2. 按条件筛选商品 → 对比价格/30天销量/评分/评论数/店铺类型/仓储/上架时间 → 查详情/评价/每日月度数据/流量词 3. 输出：爆款共性+用户痛点+差异化机会+风险 ### 店铺分析 1. **确认参数**：站点、筛选条件(店铺类型/等级/优质卖家等级/店铺ID 至少其一) 2. 筛选店铺 → 查看商品数/销量/信用等级/取消率/延迟率/投诉率 → 按店铺ID查商品矩阵 3. 输出：对标店铺+经营模型+可学习点 ### 品牌格局分析 1. **确认参数**：站点、类目ID（+关注品牌如有） 2. 查头部品牌 → 对比品牌数/活跃品牌数/Top品牌销量/销售额/均价 → 判断是否有强品牌壁垒 3. 输出：白牌机会+对标品牌+进入风险 ### 目录链接机会 1. **确认参数**：站点、搜索条件(关键词/类目ID 至少其一，推荐+跟卖状态/价格范围/BSR范围) 2. 按条件筛选目录链接 → 查详情和跟卖商品 → 判断适合跟卖/差异化上架/竞品参考 3. 输出：机会链接+风险点+筛选条件 ### 利润测算 1. **确认参数**：站点、商品信息(商品ID 或 价格+重量，推荐+成本/目标利润率；未给成本先问) 2. 取价格/重量/店铺类型/佣金/货币 → 查汇率运费 → 估算毛利/毛利率/价格安全区间 3. 明确说明测算假设