API & MCP：把 54 个工具接进 Claude / Cursor / n8n

GrowSail 的 54 个工具同时是 MCP 工具：同一套能力，既能在网页里点，也能让 Claude、Cursor、ChatGPT、n8n 直接调。这一篇讲怎么接，以及接了之后真正多出来的那部分能力。

MCP 是什么，接了之后多出什么

MCP 可以理解为「AI 客户端的插件接口」。把 GrowSail 接进 Claude 后，你就能直接说「帮我拆一下 drsquatch.com 在投的广告角度」，AI 会自己依次调用 get_brand_ads → tag_brand_ads → brand_tags_summary。

和网页端的区别

先说清楚：同一批能力。 网页端的竞品情报走的就是这些工具，登录即可用，不需要 key。

所以接 MCP 不是为了拿到新能力，而是为了三件网页端做不了的事：

第二行和第四行是真正的分水岭。

什么人需要接

需要： 想做定时监控并推到团队群的；已经在用 Claude / Cursor 写东西、不想切浏览器的；要批量处理几十个域名的。

不需要： 一周看几次竞品、网页端完全够用的。接 MCP 要配置文件、管 key，不是零成本。

三步快速开始

左侧边栏「系统 → API & MCP」。

1. 拿 key

在「API key」区域点「+ 创建新 key」。

明文只显示一次。 创建后立刻复制到密码管理器或环境变量里。列表里只会看到前几位。

列表会显示：名称、套餐、余额/已用、最后使用时间，以及一个「停用」按钮。

2. 连客户端

两个参数，所有客户端都一样：

3. 说人话

接完之后不需要记工具名。页面给的示例就是直接说：「帮我拆一下 drsquatch.com 在投的广告角度」。

AI 会自己决定调哪几个工具、按什么顺序调。

一个重要提醒

页面上写了：不需要 key 的用法 —— 在 growsail.ai 网页里用竞品情报，登录即可，走的是同一批工具。API key 只给外部 AI 客户端用。

别为了用网页端去建 key。

各客户端怎么配

Claude（网页 / 桌面版）

设置 → Connectors → Add custom connector：

Claude Code

一条命令：

claude mcp add growsail "https://growsail.ai/api/mcp" -t http -H "x-api-key: gsk_你的key"

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "growsail": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://growsail.ai/api/mcp",
               "--header", "x-api-key:${GROWSAIL_KEY}"],
      "env": { "GROWSAIL_KEY": "gsk_你的key" }
    }
  }
}

Cursor / VS Code / Windsurf

~/.cursor/mcp.json（或工作区的 .cursor/mcp.json）：

{
  "mcpServers": {
    "growsail": {
      "url": "https://growsail.ai/api/mcp",
      "headers": { "x-api-key": "gsk_你的key" }
    }
  }
}

ChatGPT

设置 → Apps → 开发者模式 → Create app。URL 填 https://growsail.ai/api/mcp，认证选 Custom header，填 x-api-key。

n8n

用 MCP Client 节点：Transport 选 HTTP Streamable，Endpoint 填服务地址，Header 加 x-api-key。

页面上写了它最适合的用法：做定时竞品监控 → 变动推 Slack / 飞书。 这是下一节的第一个场景。

自建 / 本地 stdio

克隆仓库后本地跑，不计费，用本机 .env：

npx tsx mcp/server.ts        # stdio
npm run intel -- list         # CLI 列出全部工具
npm run intel -- get_brand_ads domain=craftdlondon.com limit=40

54 个工具怎么分类

工具表由代码仓库的注册表自动生成，和线上完全一致。标为只读的工具不扣 credits。

两个值得记住的免费工具

get_teardown —— 读上次拆解的结果，完全免费。它还顺带三样纯计算的东西：

• timeline —— 近 180 天在投广告日曲线，从每条广告的起止日期反推
• countries —— 投放国家（会在 confidenceCn 里写明是实测还是推断）
• revenue —— 预估月营收，basisCn 里是完整算式

profile_store —— 对任意 Shopify 店做技术与经营画像，免费。主题、像素、App、商品数、价格带、上线年份、社媒链接全有。

一个省钱的习惯

品牌页再次打开同一家时，系统自动用 get_teardown（免费），只有点「重新拆解」才跑 get_brand_ads 等真抓取工具。

在 MCP 里也是同样的逻辑：写 prompt 时明确说「先读库里已有的，没有再抓」，能省不少 credits。否则 AI 很可能每次都重新抓一遍。

两个限制要知道

• 花费与触达只对触达过欧盟的广告可得。 AU / US / SEA 的广告没有。
• 页内排名不是全网排名。 工具描述里也特地标了这一句。

三个真正值得接的场景

接 MCP 有配置成本，不是每个人都需要。下面三个是明确划算的。

场景一：定时竞品监控推到团队群

用 n8n：定时器触发 → 调 get_teardown（免费）→ 对比上次结果 → 有变动就推 Slack / 飞书。

和差分邮件（第 05 篇）的区别：

团队超过两三个人时，这个差别很实在。一封只有老板看的邮件，和一条投放、运营、设计都能看到的群消息，产生的行动不一样。

场景二：在 IDE 里边写边查

你在 Cursor 里写落地页，直接问：「看一下 craftdlondon.com 的主力落地页是怎么结构的，我这个页缺什么」。

价值不在省那几分钟，而在不断线。写页面写到一半去切浏览器查竞品，回来就忘了刚才要写什么。

场景三：批量处理

你手上有 30 个域名，要知道哪些在投广告、投了多少。

网页端要点 30 次。在 MCP 里，把域名列表给 AI，让它循环调 get_teardown（先读库，免费），库里没有的再决定要不要花 credits 拆。

这里有个实用的 prompt 写法：

对这 30 个域名，先用 get\_teardown 读库。库里有的直接用，库里没有的先列出来给我看，我决定拆哪几个。

这样 AI 不会自作主张把 30 个全拆一遍。

计费、邀请与效率

credits 怎么算

关键区别：credits 只在 MCP / API 调用里消耗，网页端不扣。

所以接了 MCP 之后，需要留意两件事：

1. 只读工具不扣费。 库浏览、指标计算、get_teardown、profile_store 都是 0。
2. 真抓取的才扣。 get_brand_ads 5、search_meta_ads 5、discover_stores 3、tiktok_top_ads 2。

自建本地 stdio 跑不计费（用本机 .env），要大量调用的可以考虑这条路。

邀请好友

页面上有个邀请码机制：把链接发给同行，对方注册 14 天内填码，双方各得 200 credits。

注意：这 200 credits 只能在 MCP / API 调用里用，网页端不扣也就用不到。不打算接 MCP 的人，邀请奖励对他没意义。

数据边界

页面单独开了一节「数据边界」。写文章时这一段值得完整引用——企业客户接 MCP 前一定会问这个。

效率账

结论很清楚：单次、低频的使用，网页端更快。批量、定时、要进别的系统的，接 MCP。