⚙   配置信息

蓝鲸选品 MCP 服务提供两种接入方式，请根据你的 AI 客户端类型选择对应的配置方法。

密钥获取方式：在蓝鲸选品的购买页上获取

方式一：链接直连（最简单）

适用场景：

支持直接填写 MCP URL 的客户端（如 Cherry Studio、Claude Desktop 部分版本、网页端 MCP 工具等）。一键复制粘贴即可使用，无需手写 JSON。

操作步骤：

1. 复制下方完整链接

2. 在你的 AI 客户端的 MCP 配置入口，粘贴到「服务地址 / URL」字段

3. 保存并启用，即可在对话中调用蓝鲸选品的能力

配置链接：

https://xpmcp.lingdongsz.com/mcp?secret-key=您的密钥

方式二：JSON 配置（适合标准 MCP 客户端）

适用场景：需要写入配置文件的客户端（如 Codex、Continue、Cursor、Cline、自建 Agent 等）。密钥放在请求头中，安全性更高。

操作步骤：

4. 打开 AI 客户端的 MCP 配置文件（通常为 mcp.json 或客户端设置界面）

5. 复制下方 JSON 内容，合并到 mcpServers 节点下

6. 保存配置并重启客户端，即可识别 my-idea-mcp 服务

JSON 配置示例：

{
  "mcpServers": {
    "my-idea-mcp": {
      "baseUrl": "https://xpmcp.lingdongsz.com/mcp",
      "headers": {
        "X-API-Key": "您的密钥"
      },
      "auth": "none"
    }
  }
}

提示：适合需要写入配置文件的客户端（如 Codex、Continue、自建 Agent）。密钥放在请求头中，更安全。

密钥安全提示

· 请妥善保管 secret-key / X-API-Key，不要在公开仓库、聊天群、截图中泄露

· 如怀疑密钥泄露，请第一时间登录蓝鲸选品后台重置密钥

· 建议在企业团队中为不同成员分配独立密钥，方便审计与回收

· 推荐使用「方式二（JSON 配置）」，将密钥写入请求头，避免出现在 URL 日志中

配置Claude

蓝鲸选品 MCP · 常见问题解答

一、基础认知篇

Q1：MCP 到底是什么？它和 API 是一回事吗？

MCP（Model Context Protocol，模型上下文协议）可以理解成「AI 大模型的标准化数据/工具插座」。AI 模型本身只懂思考和表达，并不知道美客多今天哪个玩具卖爆了；

MCP 就是那根连线，把蓝鲸选品多年沉淀的拉美电商数据，实时、结构化地喂给 AI，让它从纸上谈兵变成手握真实数据的拉美选品军师。

一句话区分：

· MCP → 给运营、店长、选品师用的「对话式数据助手」，说人话就能查

· API → 给开发工程师用的「系统对接接口」，得写代码、做联调

MCP vs 传统 API 对比：

Q2：直接用 ChatGPT 联网搜索不也行吗？为什么还要装蓝鲸 MCP？

两者差距，就像在街边问路和打开专业导航：

· 普通 AI / 联网搜索：抓的是公开网页，数据零散、时效不一，遇到要算销量趋势、做品类对比时基本抓瞎，还可能编数据。

· 蓝鲸选品 MCP：AI 直接调取蓝鲸结构化、可信、按天更新的美客多专业数据库，每个数字都有出处，能直接拿来决策。

简单说：前者是道听途说，后者是专业数据 + AI 解读。

Q3：蓝鲸选品 MCP 目前覆盖哪些站点和能力？

站点覆盖：

墨西哥（MLM）、巴西（MLB）、阿根廷（MLA）、智利（MLC）、哥伦比亚（MCO）等核心美客多站点。

能力维度（持续扩展中）：

· 商品维度：商品搜索、官链搜索、商品详情、销量历史

· 类目维度：类目搜索、销量趋势、价格分布、新品机会、销售额统计

· 排行维度：热门品牌、热门商品、热门店铺、BSR 排名

· 关键词维度：热搜词查询（按月/按天）、流量词反查

· 店铺维度：店铺搜索、店铺等级、优质卖家筛选

· 辅助工具：汇率查询、套餐用量、仓储类型分布

⚙️二、配置接入篇

Q4：照着文档配了，还是连不上蓝鲸 MCP，怎么排查？

90% 的连接失败都集中在这几个点，请按顺序自查：

1. 密钥核对—— 确认从蓝鲸后台复制的 API Key / secret-key 前后没有多余空格或换行，大小写一致。

2. 服务地址检查—— 客户端里的 MCP URL 建议直接从蓝鲸提供的配置示例复制，不要手敲。

3. 网络可达性—— 公司内网/VPN/代理/防火墙都可能拦截，先 ping/curl 一下确认能访问。

4. 使用测试连接按钮—— 多数客户端自带连接测试，能直接告诉你是鉴权失败还是网络超时。

5. 看日志定位—— 客户端调试窗口里的错误码比连接失败四个字有用得多。

Q5：蓝鲸 MCP 支持哪些 AI 客户端？我用的客户端能接吗？

只要支持 MCP 协议的客户端都能接，目前实测兼容的有：

· ✅ Claude Desktop —— Anthropic 官方桌面端，原生支持

· ✅ Cherry Studio —— 国内主流 AI 客户端，配置最友好

· ✅ Cursor / Cline —— 开发者向 IDE/插件

· ✅ Codex CLI / Continue —— 命令行与 VSCode 插件

· ✅ Refly / DeepChat / ChatBox 等第三方 MCP 客户端

· ✅ 自建 Agent —— 通过标准 MCP SDK 接入

不确定你的客户端是否支持？查看它的「MCP / Tools / 扩展」相关菜单即可，或直接到我们开放平台咨询。

Q6：链接直连和 JSON 配置两种方式选哪个？

推荐：能用 JSON 配置就优先用 JSON，密钥不会暴露在 URL 日志里。

Q7：我可以同时在多台电脑/多个客户端使用同一个密钥吗？

可以。同一个密钥可以在多设备、多客户端同时使用，不受设备数量限制。

但请注意：

· 调用量统计是合并的，所有设备共享同一份套餐配额

· 团队多人使用建议分配独立密钥，方便审计、回收、定位异常调用

· 一旦怀疑密钥泄露，立即到蓝鲸后台重置密钥，旧密钥会立即失效

三、模型与稳定性篇

Q8：我用的免费第三方 AI 模型，总是没反应/报错/限流，是 MCP 的问题吗？

大概率不是。这种情况几乎都出在你用的「AI 模型本身」：

· 免费模型限流严：调用频率限制苛刻，AI 连续调几个工具就会触发限流。

· 稳定性参差：低成本渠道高峰期容易超时，且不是所有模型都对 MCP 工具调用支持成熟。

推荐做法：

· ✅ 优先使用 DeepSeek 官方 / Claude / GPT-4 / Qwen 等成熟模型

· ✅ 登录模型后台查配额

· ✅ 让 AI 分步执行任务，别一次性调 10 个工具

Q9：哪些大模型对蓝鲸 MCP 支持最好？

经实测，Function Calling / Tool Use 能力强的模型表现最佳：

四、配额与计费篇

Q10：MCP 调用怎么计费？一次对话会消耗多少？

蓝鲸 MCP 按接口调用次数计费（不按对话轮次），具体规则：

· 一句话 = 多次调用：AI 为了回答一个问题，可能后台调 3~10 个工具，每个都算一次

· 免费接口：汇率查询（rateInfo）、套餐用量查询（myUsage）等不消耗配额

· 付费接口：商品/类目/趋势/关键词类接口按次扣减

想随时查看用量，直接对 AI 说：「帮我看下蓝鲸 MCP 的套餐使用情况」，它会调用 myUsage 给你最新数据。

Q11：套餐用完了或快用完了会怎样？

· 接近上限：会在接口返回中带提醒，但不影响调用

· 超出配额：接口会返回限流错误，AI 会告诉你「额度已用完」

· 续费/升级：到蓝鲸选品开放平台后台续费或升级套餐，充值后立即生效，无需重新配置 MCP

五、报错与排障篇

Q12：在 Cursor / Cline / Refly 等其他 MCP 客户端遇到报错怎么办？

通用排障三板斧：

6. 重启 MCP 服务：在客户端里先禁用，再启用，多数临时故障一次重连就好

7. 重启客户端：完全关闭再打开，让进程重新加载配置

8. 重新配置（Refly 等特殊客户端）：参数填错后直接修改不生效，需删除后重新添加

仍解决不了，到开放平台扫码联系技术服务人员一对一处理��

Q13：AI 调用 MCP 时返回「工具调用失败」或参数错误，怎么办？

这类问题通常是 AI 对参数理解有偏差，可以这样优化：

· 明确指定参数：直接告诉 AI「用墨西哥站（MLM）查类目 MLM1132 的趋势」，比「看一下墨西哥玩具」更精准

· 拆分复杂请求：把「对比 5 个类目的销量、价格、品牌排名」拆成 3 句话问

· 重新唤起一次：偶尔模型会传错参数，让它「重试一下」通常就能修正

· 检查参数范围：如日期格式必须是 YYYYMM / YYYYMMDD，类目 ID 必须是蓝鲸返回的标准 ID（如 MLM1132）

Q14：返回的数据看起来不对 / 和后台看到的对不上，是什么原因？

可能的原因（按概率排序）：

9. 数据更新时点不同：核心数据每日更新，凌晨~上午是更新窗口，可能短暂不一致

10. 筛选条件不一致：AI 可能默认带了某些筛选（如只看活跃商品、只看本土店），可以让它「用同样的筛选条件再查一次」

11. 站点搞错：MLM/MLB/MLA 容易混淆，确认是不是查到别的站点了

12. 类目 ID 错位：同样叫玩具的类目在不同父级下 ID 不同，建议先用 categorySearch 确认 ID

如果反复核对后仍有差异，欢迎反馈给我们排查。

六、使用技巧篇

Q15：怎么提问才能让 AI 调蓝鲸 MCP 调得更准？

4 个简单原则：

· 先说站点：「墨西哥站」「巴西站」直接亮明，AI 不用猜

· 再说类目：先模糊问类目 ID，再用 ID 查趋势；避免直接说「玩具」「家具」让 AI 自己猜映射

· 加上时间范围：「近 30 天」「2026 年 1~4 月」比「最近」更可执行

· 说清输出形式：「列前 20 个」「画一张表」「导出 Excel」，结果更可控

把上述四要素串起来，例如：「用墨西哥站（MLM），帮我看一下玩具大类（MLM1132）近 30 天销量 Top 20，按 sale30d 排序，输出表格」

Q16：能不能让 AI 一次性生成选品报告？

可以，蓝鲸 MCP 工具是原子化设计的，AI 可以自动组合多个工具完成一份完整报告。常见模板：

· 【市场扫描报告】：trendStatistical + trendSoldHis + trendPrice → 大盘体量、增长、价格带

· 【竞品对标报告】：itemSearch + itemInfo + itemHistory + keywordReverse → 竞品销量、关键词

· 【机会挖掘报告】：trendNewItems + trendBrandTopItem + monthSearch → 新品+热搜+爆品

你只需要说：「帮我出一份墨西哥站玩具品类的选品报告」，AI 会自动编排调用。

Q17：MCP 调用结果可以保存或导出吗？

· ✅ 当下保存：让 AI「把这份结果导出为 Excel/Word/PDF」，它会生成文件给你

· ✅ 历史留存：在 Claude Desktop / Cherry Studio 等客户端中，对话历史会自动保留，可随时回顾

· ✅ 团队共享：把对话导出为 Markdown / PDF 分享给同事，他们不用装 MCP 也能看

Q18：MCP 能用来做自动化任务（如每日推送选品周报）吗？

目前 MCP 主要面向「人机对话」场景，自动化定时任务需要配合：

· 方式一：在支持定时任务的 AI 平台（如 OpenClaw、Dify、n8n）中配置 cron + MCP 调用

· 方式二：使用蓝鲸选品的 API 接口（更适合自动化），由开发人员对接

简单总结：MCP 适合「问答式探索」，API 适合「定时化执行」，两者可以并用。

持续更新中—— 如有更多问题，欢迎到蓝鲸选品开放平台反馈