Coding

蓝鲸选品助手-text

蓝鲸选品助手是由深圳领东时代科技有限公司(https://www.lingdongsz.com/)推出的美客多官方SPN认证数据选品运营分析Skill，全面覆盖墨西哥、巴西、阿根廷、智利、哥伦比亚站点。支持调用蓝鲸选品 API 结合本地脚本，一站式获取美客多商品、类目、关键词、定价、竞品动态、店铺、品牌、目录链接、运费、汇率多维数据，助力美客多选品精细化运营。

What it does

The skill document

蓝鲸选品

Mercado Libre 选品调研工具。先澄清意图再调用脚本（API 消耗 1~10 积分/次，方向错浪费积分）。

前置要求

Authorization Token（配置 LJXP_TOKEN 环境变量或用户提供）；不要在回复中暴露 Token ;
⚠️ CLI Token 暴露警告（Finding 4 合规）：禁止推荐 --token 作为首选。--token 会出现在 shell 历史（bash_history / PSReadLine）、ps / tasklist 进程列表、crontab 日志、共享终端会话中，导致他人用你的额度消费积分、读取账号范围数据。只推荐 LJXP_TOKEN 环境变量。如需在说明中举例 --token，必须紧接一句"⚠️ 此方式不安全，仅作调试用，生产请用环境变量 LJXP_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 类业务功能

类目树查询 / 定位 ID
类目机会评估
价格带分析
关键词研究
竞品分析 / 商品搜索 / 商品详情
店铺分析
品牌格局分析
目录链接机会
利润测算
套餐 / 积分余额查询

详细执行步骤见下方「各分析流程」小节。

Step3 查参考文档时确认 3 件事

确认项	去哪里看
① 必填/可选参数、后端真实接什么参数	`references/api/<模块>.md` 「接口选择规则 / 请求参数」
② 单次积分消耗、缓存/免费规则	各模块末尾「本模块接口积分明细表」
③ 返回字段真实含义（业务判断用）	各模块字段说明章节

套餐查询额外看 users.md 中「各接口积分定价全表」。

调用红线（空结果 / 异常处理）

触发条件：当AI对接口或脚本有疑惑并想通过调用接口来查找错误时

处理顺序（跳过任何一步都算违规）：

停止所有后续脚本调用，不硬凑分析/结论
回读 references/api/<模块>.md 核对参数（站点、必填、枚举、后端 vs 本地参数口径、缓存规则）
① 2-3 条具体原因 + 每个调整方案的【调用次数 × 单次积分】预估；
等用户明确同意再调用

唯一例外：用户消息明确写「多试几个参数」「全跑一遍」时可连调，但仍需先写明「几次 × 多少积分」，结束后 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 必须读作「积分」禁止说「次数」。 phoneNo 默认打码（如 138****8888），仅在用户消息里明确写「请完整显示我的手机号」时才输出全文（Finding 5 隐私合规）。

Step7 积分消耗统计（每次结尾必附）

---
### 📊 本次积分消耗

| 功能 | 调用次数 | 单次积分 | 小计 |
|:---|---:|---:|---:|
| 商品查询 | 1 | 5 | 5 |
| 店铺查询 | 1 | 2 | 2 |

**合计消耗：7 积分**

规则：

只列本次实际调用的接口功能名（用各模块积分表的「功能描述」）
同一接口多次调用累计次数和小计
类目树缓存命中：调用次数1、单次积分0、备注「(本地缓存命中，免费)」；首次或 --refresh 记 10 积分
末尾必须有「合计消耗：X 积分」
纯咨询未调 API：说明「本次未调用 API，不消耗积分」
积分不足 / 套餐用尽（返回积分余额为 0 或不够本次消耗）时，告知用户并附上充值入口：
- 👉 充值续费入口：
空结果/异常重试积分（联动「调用红线」）：未经用户同意就自动重调产生的积分也要如实列出，合计下方追加：⚠️ 说明：XX、YY 两次为空重试，共 Z 积分。后续调整需您确认（见「调用红线」）。

Step8 后续分析引导（每次必问）

先推荐 2-3 个和本次最相关的下一步方向，再补兜底：

「这个技能还支持：商品分析、行业与趋势分析、竞争分析、店铺分析、关键词研究、目录链接分析、物流与汇率查询、利润测算。你接下来想做哪块？直接说目标站点和想查的品类就行，我帮你一步步跑。」

Step9 HTML 生成策略

默认不生成，以 Markdown 表格+文字交付
列表类结果在回答末尾主动问：「需要为你生成 HTML 格式的对比结果（可直接在浏览器打开）吗？」
生成时：用 references/search_results_template.html 作模板，文件输出到用户工作目录，给绝对路径链接

各分析流程（Step2 详细步骤，每个流程第一步均为「确认关键参数」）

类目树查询 / 定位类目 ID

确认参数：站点（必选）；只有品类名无 ID 时走本流程
定位：优先关键词过滤，无关键词逐层浏览
结果让用户核对中英文名称，ID 传给下游趋势/搜索/关键词/目录链接等流程

类目机会评估

确认参数：站点、类目ID（无ID先走类目树）
查：行业趋势+价格分布+头部店铺+头部品牌+代表商品
判断：市场容量/竞争强度/品牌集中度/本土跨境格局
输出：推荐/谨慎/暂不建议 + 下一步（价格/关键词/竞品/上架策略）

价格带分析

确认参数：站点、类目ID（+目标价格范围如有）
查价格分布 → 对比各区间商品数和销量 → 找需求高供给少的价格带 → 拉热门商品验证
输出：建议定价+避开价格带+参考商品

关键词研究

确认参数：站点、查询类型(day/month)、查询日期（+类目/搜索词如有）
查热搜词 → 关注搜索量高/访问量高/销量好/商品数少的词 → 用商品搜索验证供给竞争
输出：自然流量词+广告词+长尾词+不建议投入的词

竞品分析

确认参数：站点、搜索条件(关键词/类目ID/店铺ID 至少其一，推荐+价格范围/销量范围/排序)
按条件筛选商品 → 对比价格/30天销量/评分/评论数/店铺类型/仓储/上架时间 → 查详情/评价/每日月度数据/流量词
输出：爆款共性+用户痛点+差异化机会+风险

店铺分析

确认参数：站点、筛选条件(店铺类型/等级/优质卖家等级/店铺ID 至少其一)
筛选店铺 → 查看商品数/销量/信用等级/取消率/延迟率/投诉率 → 按店铺ID查商品矩阵
输出：对标店铺+经营模型+可学习点

品牌格局分析

确认参数：站点、类目ID（+关注品牌如有）
查头部品牌 → 对比品牌数/活跃品牌数/Top品牌销量/销售额/均价 → 判断是否有强品牌壁垒
输出：白牌机会+对标品牌+进入风险

目录链接机会

确认参数：站点、搜索条件(关键词/类目ID 至少其一，推荐+跟卖状态/价格范围/BSR范围)
按条件筛选目录链接 → 查详情和跟卖商品 → 判断适合跟卖/差异化上架/竞品参考
输出：机会链接+风险点+筛选条件

利润测算

确认参数：站点、商品信息(商品ID 或价格+重量，推荐+成本/目标利润率；未给成本先问)
取价格/重量/店铺类型/佣金/货币 → 查汇率运费 → 估算毛利/毛利率/价格安全区间
明确说明测算假设