connskill-growth-mcp

@connskill/mcp-growth-services

从 Keyword Metrics 开始，获取 Google Ads 搜索量、CPC、广告竞争程度和可用的月度历史数据。仅当建模得出的提问需求信号有助于决策时，再添加 AI Search Volume。这是两项独立的付费结果，并非自动捆绑。AI 需求包含 Google People Also Ask 等信号；它并非 ChatGPT 或 Perplexity 使用量的测量值。广告竞争程度不等于自然搜索 SEO 难度。

开始关键词研究 · 德语入门 · 实用指南

结果	免费准备	付费 MCP 工具
Google 关键词需求、CPC 和广告竞争程度	关键词方案	keyword_metrics
建模得出的 AI／提问需求信号	数据限制和输入项	ai_search_volume
某个域名排名所用的关键词	域名排名	ranked_keywords
本地搜索 + 地图观察结果	本地市场检查	local_market_check

一项范围明确的关键词任务

1. 选择 1–10 个词条，并通过免费目录确定国家／语言。
2. 查看当前价格和输入限制。批准每项工具及总预算。
3. 仅调用已获批准的工具，并使用相同的词条和市场进行比较：

{"keywords":["seo api","keyword research"],"location_code":2276,"language_code":"de"}

给 MCP 客户端的示例指令（仅用于准备）：

为德国市场的以下两个词条准备 Keyword Metrics，语言为德语。说明当前价格和输出字段。将 AI Search Volume 作为单独的可选建模信号提供。未获我批准工具和总预算前，不要购买任一结果。缺失数据应保留为未知；结果不明确时，不要重试付款。

免费方案或此提示词均不授权付款。准备阶段请保持 X402_MAX_USD=0，且不要提供钱包。单次调用上限不等于合并预算。我们不保证排名或收入；请检查部分结果和无法获取的结果。

其他目录服务包括网站审计、反向链接、短信验证、仅接收的收件箱、在德国托管的 LLM 聊天，以及 x402 卖家检查。

无需账户，也无需 API 密钥。付费调用通过 x402 使用 Base 上的 USDC。免费端点（报价、目录、状态、地点）完全不需要钱包。

源码与已发布的软件包

版本 0.3.3 为通用工具名称添加了清晰的前缀，并移除了工具描述中重复的“（免费）”。重命名后的工具：jobs/jobs_get、claim、deliver、close 现为 board_jobs/board_jobs_get、board_claim、board_deliver、board_close；site、site_renew、site_stats 现为 analytics_site、analytics_site_renew、analytics_site_stats；prose 现为 conformance_prose，status_json 现为 service_status，exchange 现为 agent_exchange。端点、价格和支付行为均未更改；按名称调用这些工具的客户端需要使用新名称。 版本 0.3.2 新增了关键词优先指南和可选的发现渠道衡量功能。 版本 0.3.1 更新了 MCP SDK 和存在漏洞的传递依赖。 支付协议和支出保护机制与 0.3.0 版本相同；该版本引入了下文所述的 v2 支付客户端和持久化购买保护机制。更早的 0.2.1 安装使用不同的支付客户端； 不要假定该版本具备这些保护措施。安装前，请查看 npm 最新版本 和 官方 MCP Registry。不指定版本的 npx 命令会选择 npm 已发布的版本， 不一定是当前的 GitHub 源码。要使用此处检出的版本，请使用源码设置。GitHub、npm、Registry 和 Glama 是独立的发布渠道。

此仓库提供三个入口：

形式	适用对象	安装方式
MCP 服务（index.mjs）	Claude Code、Claude Desktop、Cursor、Codex、OpenClaw、Hermes，以及任何 MCP 客户端	已发布的 npm 软件包；请检查其版本，或使用源码设置
Skill（skills/connskill-growth/）	Claude Code、Codex、OpenClaw、Hermes（agentskills.io 格式）	复制文件夹，或从此仓库安装
独立脚本（skills/connskill-growth/scripts/x402-call.mjs）	任何能够运行 node 的 Agent	node x402-call.mjs GET /v1/local-market-check-quote（免费）

MCP 进程首次读取目录时，会根据服务当前的 OpenAPI 目录 和 x402 价格生成工具。 可用工具集会随这些文档变化；标记为排除的端点和钱包签名操作不会纳入此适配器。重启 MCP 进程即可加载更新后的目录。

首次购买：先准备，再启用付款

先在没有钱包且禁用付款的情况下开始。对于接受 mcpServers 的 MCP 客户端，请使用此固定配置（Node.js 22 或更高版本）：

{
  "mcpServers": {
    "connskill-growth": {
      "command": "npx",
      "args": ["-y", "@connskill/[email protected]"],
      "env": { "X402_MAX_USD": "0", "X402_DISCOVERY_SOURCE": "github" }
    }
  }
}

1. 查看免费目录、输入内容和当前报价。HTTP 402 是价格报价，不是付款，也不是需要通过重试来解决的错误。
2. 批准确切的工具、输入内容和价格。仅通过 MCP 客户端的安全本地配置设置 X402_WALLET_KEY，并使用一个在 Base 主网上持有 USDC 的专用钱包。切勿将密钥或助记词粘贴到聊天中。
3. 将 X402_MAX_USD 从 0 改为已批准的单次调用金额，然后重启 MCP 进程，使其读取新的配置。仅配置钱包并不代表批准购买。先调用一次 keyword_metrics。可选的 ai_search_volume 是单独的购买，不包含在该批准中。
4. 保存结果和购买参考编号。如果付款情况不明确或缺少结果，请使用钱包支持；不要再次付款。之后如需仅进行准备而不付款，请将上限恢复为 0 并重启。

此上限是每次调用的上限，不是总预算，也不是只能调用一次的计数器。客户端还必须强制执行已批准的范围。客户端／网络费用可能另行产生。托管 MCP 可以检查免费工具，但不会提供钱包，也不会自动将每个 MCP 客户端变成 x402 付款客户端。对于此客户端支持的自动付款流程，请使用此本地适配器。

付款模式

以下内容适用于 0.3.3 版本，不适用于更早的 0.2.1 安装。

• 免费端点无需钱包即可使用。
• 付费端点需要 X402_WALLET_KEY，即一个持有 USDC 的 Base 钱包的私钥。官方 x402 v2 软件包会为所选请求签署 EIP-3009 授权。客户端仅允许 Base 主网、官方 USDC 和已配置的商家。它会检查完整资源 URL，并拒绝重定向。 如果没有密钥，付费 MCP 工具会返回明确提示，而不会发起购买。
• X402_MAX_USD（默认值为 1.00）是精确的 USDC 十进制数值，最多支持六位小数。空值、负数、科学计数法和十六进制值均会被拒绝。0 会禁用付款。这是单次调用的授权上限，不是每日预算。
• 请求具有时长和 JSON 请求／响应大小上限。已签名的请求最多发送一次。发送后发生超时表示结果未知，并不能证明商家拒绝了付款。
• 已接受的后台任务（202）会记录为已接受，并附上购买参考编号和经过身份验证的状态 URL。它不会被报告为已交付结果。
• 付款尝试会在发送前持久化。默认情况下，重复相同的规范化请求不会产生另一笔付款。若要有意再次购买已交付的请求，必须使用 MCP 参数 confirmNewPurchase: true 或 CLI 标志 --new-purchase。这两个选项都不能覆盖已接受或情况不明确的购买。
• 请将私有状态目录及其父目录一起保留。父目录中包含一个引导标记，用于检测存储缺失。状态损坏或不完整时会阻止付款，绝不会被静默重置。若父目录及标记全部丢失，新进程无法将其与首次使用区分开来。不要为了重试购买而删除它们。不同客户端或容器必须共享同一份持久状态，才能共用此保护机制。

MCP 响应会在 _meta["io.connskill/payment"] 中包含付款状态；结果不确定时，文本结果还会包含购买参考编号和 doNotPayAgain。尝试存储中不会保存授权签名或私钥。此客户端使用购买参考编号来获取支持；它不会自动重放付款标头，也不会签署替代付款以恢复响应。

⚠️ 此密钥可能会花费真实的 USDC。请使用专用钱包，并且只向其中存入 Agent 可支出的金额。切勿使用主钱包。

安装

0.3.3 源码要求 Node.js 22 或更高版本。锁文件包含需要 Node 22 的运行时依赖。 以下 npx 示例会选择已发布的 npm 版本；请先确认其版本。 完成源码设置后，要运行检出的源码，请使用 node 和 index.mjs 的绝对路径。 免费发现无需钱包。

Claude Code

claude mcp add connskill-growth -s user -e X402_WALLET_KEY=0x... -e X402_MAX_USD=0.50 -- npx -y @connskill/mcp-growth-services

或者安装 GitHub 插件及其技能（这是与 npm 不同的源码安装途径；通过客户端配置钱包凭据）：

claude plugin marketplace add CONN-SKILL/connskill-growth-mcp
claude plugin install connskill-growth@connskill

Codex

codex mcp add connskill-growth --env X402_WALLET_KEY=0x... --env X402_MAX_USD=0.50 -- npx -y @connskill/mcp-growth-services

仅安装技能：将完整的 skills/connskill-growth 文件夹复制到 ~/.agents/skills/。其中的脚本共用本地模块；仅复制 x402-call.mjs 并不够。

Cursor / Claude Desktop (mcpServers)

{
  "mcpServers": {
    "connskill-growth": {
      "command": "npx",
      "args": ["-y", "@connskill/mcp-growth-services"],
      "env": { "X402_WALLET_KEY": "0x...", "X402_MAX_USD": "0.50" }
    }
  }
}

OpenClaw

openclaw mcp add connskill-growth --command npx --arg -y --arg @connskill/mcp-growth-services

技能：将 skills/connskill-growth 复制到 ~/.agents/skills/（或工作区的 skills/）， 并在 openclaw.json 的 skills.entries.connskill-growth.env 中设置 X402_WALLET_KEY。

Hermes（NousResearch hermes-agent）

hermes skills tap add CONN-SKILL/connskill-growth-mcp
hermes skills install connskill-growth

或者在 ~/.hermes/config.yaml 的 mcp_servers: 下配置 MCP，设置 command: npx、 args: [-y, @connskill/mcp-growth-services]、env: {X402_WALLET_KEY: ...}。

从源码安装

git clone https://github.com/CONN-SKILL/connskill-growth-mcp
cd connskill-growth-mcp
npm ci
node index.mjs            # MCP over stdio
node test-smoke.mjs       # lists tools, calls a free endpoint, checks the paid guard (never spends)

从源码构建容器

在此目录中使用检出的锁文件和固定版本的官方 Node 镜像进行构建：

docker build --tag connskill-growth-mcp:local .
docker run --rm -i connskill-growth-mcp:local

容器以非特权 node 用户身份运行，并通过 STDIO 通信。 保持 stdin 开启（-i）；不会暴露端口。免费端点无需钱包即可使用。 如需付费使用，请将父目录保存在命名卷中，并通过运行时环境提供钱包：

docker run --rm -i \
  --mount type=volume,src=connskill-growth-state,dst=/home/node/.local/state \
  --env X402_WALLET_KEY --env X402_MAX_USD=0.50 \
  connskill-growth-mcp:local

复用同一卷可在替换容器后保留尝试记录。临时容器文件系统无法保证这一点。仅在运行时提供设置。构建上下文仅包含明确允许的包文件；不包含凭据和本地依赖项。

本地容器候选版本与已发布的 Glama 版本是分开的。Glama 要求构建测试成功，并通过现有维护者界面发布。

复制后的独立技能只需 Node 即可进行未签名调用。如需付费调用， 请从此源码树安装锁定的包依赖，或在 Node 能够解析它们的父级 包目录中安装 @x402/[email protected]、@x402/[email protected]、@x402/[email protected] 和 viem。 SDK 导入采用延迟加载；免费发现无需钱包或支付存储。

环境

变量	默认值	含义
X402_ORIGIN	https://agent.connskill.com	HTTPS 源站地址；不含凭据、路径、查询参数或片段
X402_WALLET_KEY	–	持有 USDC 的 Base 私钥（启用付费调用）
X402_MAX_USD	1.00	每次付费调用的 USDC 精确限额，最多六位小数
X402_PAY_TO	默认源站的 CONNSKILL 商户	预期的 Base 收款方；自定义源站必须显式配置
X402_STATE_DIR	~/.local/state/connskill-mcp	私有尝试存储的绝对路径；保留其父目录和标记

销售内容（摘录）

当前金额和档位列于 x402 发现文档。 实际支付挑战会绑定所选请求的金额。

• GET /v1/local-market-check-quote（免费），然后执行一次获批的 POST /v1/local-market-check
• POST /v1/ranked-keywords
• POST /v1/keyword-ideas
• POST /v1/keyword-metrics（关联的入门指南将任务限制为选取 1–10 个关键词；API 限制请查看实时架构）
• POST /v1/keyword-metrics-multi（最多 30 个地点，一次支付）
• POST /v1/serp-report（自然搜索结果 + AI 概览、PAA、精选摘要）
• POST /v1/site-audit（Labs + 反向链接 + 实际页面抓取）
• POST /v1/trust-check（审查 x402 卖家：实时 402、资金流入、自我交易）
• POST /sms/v1/sms-order（先获取报价，免费）
• POST /mail/v1/mail-inbox（仅接收邮件的收件箱，保留 7 天）
• POST /ai/v1/eu-chat（托管于德国，支持工具调用）

缺少什么？POST /v1/wishlist 免费，内容由人工查看。

许可证

MIT。由德国特劳恩施泰因的 CONNSKILL GmbH & Co. KG 构建。

可选的发现渠道衡量

此 MCP 适配器发起的调用会在 User-Agent 标头中将软件标识为 connskill-growth-mcp。 也可选择设置 X402_DISCOVERY_SOURCE，注明你实际发现它的渠道：github、npm、glama、mcp-registry、x402scan、402index、 x402-list、agenstry 或 website。如果未知，请留空。此功能不会添加访客 ID、 IP 地址或钱包密钥。现有支付协议仍会使用付款方的钱包结算购买。

商家会将此信息作为自报渠道单独报告，与 MCP 客户端的使用情况区分开来。仅有成功的 HTTP 请求不会被计为销售：报告要求存在匹配的付款记录和已存储的成功交付记录。缺失或冲突的渠道证据仍视为未知。通过 npm 安装并不能证明买家是由 npm 带来的。此衡量方式不会更改端点 URL、已签名资源和购买请求正文。