Vaneform

vaneform-mcp

为 AI 助手和终端提供网站流量查询。本仓库包含一个 MCP 服务、一个轻量级 CLI，以及一个适用于 Vaneform 的 Agent 技能。Vaneform 是一款免费的网站流量检查工具。

询问你的助手“notion.so 的流量有多少？”或“比较 figma.com 和 canva.com”，它就会提供预估月访问量、环比变化、排名、热门国家、流量来源和注册信息。流量数据是第三方流量估算值；请参阅 Vaneform 方法说明。

中文说明

包含内容

部分	说明
托管 MCP 服务	https://vaneform.com/mcp（Streamable HTTP）。无需安装，且为推荐选项。
vaneform-mcp	面向只能运行本地命令的客户端的本地 stdio MCP 服务。它会代理托管服务，因此工具始终保持一致。
vaneform CLI	vaneform notion.so、vaneform compare a.com b.com、vaneform tld name。它与服务端共用同一个客户端。
skills/website-traffic-lookup	Agent 技能（Claude / Agent Skills 格式），用于告知助手何时查询流量，以及如何阅读并引用结果。

工具

以下工具名称和说明来自托管服务的 tools/list：

工具	功能	费用
lookup_domain	域名的缓存快照：访问量（全站或搜索）、注册信息、网站简介、链接排名热度	1 个积分
compare_bulk	并排比较多个域名的访问量和注册信息；缺少流量数据时会获取数据	每个域名 1 个积分
compare_tld	比较同一个名称在不同后缀下的情况（默认为 com,ai,io）	每个域名 1 个积分
get_account	套餐和剩余积分	免费
lookup_keyword	美国关键词简报：搜索量、难度、CPC、Google 占位情况（Pro）	60 个积分

24 小时内重复查询同一域名免费。网站关键词排名（Pro，200 个积分）可通过带有 include=search 的 API 获取。

免费版与 Pro 版

	免费版	Pro 版
每月积分	100	10,000
API 密钥、MCP 和 CLI	✓	✓
域名查询和比较（每个域名 1 个积分，24 小时内重复查询免费）	✓	✓
关键词简报（60 个积分）		✓
网站关键词排名（200 个积分）		✓

每个密钥每分钟可发送 60 个请求，每天可发送 5,000 个请求（超过限制时返回 429 lookup_rate_exceeded）。请参阅定价。

获取免费 API 密钥

服务发现（initialize、tools/list）开放使用。调用工具需要 Vaneform API 密钥。

1. 在 vaneform.com 登录，并前往 vaneform.com/account/api 创建密钥。免费账户即可。
2. 远程使用：发送 Authorization: Bearer vf_live_… 或 X-API-Key: vf_live_…。本地服务和 CLI：设置 VANEFORM_API_KEY。

没有密钥时，工具列表仍会显示；调用工具会返回注册链接以及类似 https://vaneform.com/?q=notion.so 的浏览器链接。

安装

Claude Code（远程）

claude mcp add --transport http --scope user vaneform https://vaneform.com/mcp \
  --header "Authorization: Bearer vf_live_…"

Cursor（远程）

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "vaneform": {
      "url": "https://vaneform.com/mcp",
      "headers": { "Authorization": "Bearer vf_live_…" }
    }
  }
}

Claude Desktop（本地 stdio）

最简单的 Claude Desktop 配置方式是使用本地代理来传递密钥。编辑 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "vaneform": {
      "command": "npx",
      "args": ["-y", "github:vaneform/vaneform-mcp"],
      "env": { "VANEFORM_API_KEY": "vf_live_…" }
    }
  }
}

该软件包尚未发布到 npm，因此 npx 会从 GitHub 安装。首次启动会稍久一些，因为需要先构建一次。如果在旧版系统 npm 上运行时 npx 立即退出（Debian 打包的 npm 9.2 在使用 GitHub 软件包时会出现这种情况），请运行 npm install -g github:vaneform/vaneform-mcp，并使用 "command": "vaneform-mcp"，不带任何参数。

Codex

export VANEFORM_API_KEY=vf_live_…
codex mcp add vaneform --url https://vaneform.com/mcp --bearer-token-env-var VANEFORM_API_KEY

其他 MCP 客户端

• 远程：URL https://vaneform.com/mcp，传输方式为 Streamable HTTP，标头 Authorization: Bearer vf_live_…（或 X-API-Key: vf_live_…）
• 本地：命令 npx -y github:vaneform/vaneform-mcp，环境变量 VANEFORM_API_KEY

CLI

npx -p github:vaneform/vaneform-mcp vaneform --help
# or clone, then: npm install && npm link
export VANEFORM_API_KEY=vf_live_…
vaneform notion.so                       # traffic overview
vaneform compare notion.so coda.io       # side by side
vaneform tld vaneform --suffixes com,ai,io
vaneform account                         # plan and remaining credits (free)
vaneform notion.so --json                # raw API JSON

未设置密钥时的输出：

$ vaneform tools
lookup_domain   Read a cached Vaneform domain snapshot: scale (full-site or search visits), registry, site profile, and link-rank popularity.
get_account     Read the caller plan, website lookup allowance, and credit balance.
lookup_keyword  Read a US/EN keyword brief: monthly searches, difficulty, CPC, and Google occupancy.
compare_bulk    Compare domains side by side.
compare_tld     Compare the same registrable name across suffixes.

$ vaneform github.com
VANEFORM_API_KEY is not set, so this tool cannot call the Vaneform API.
Create a free API key at https://vaneform.com/account/api (100 credits a month; 1 credit per domain).
Check it in a browser instead: https://vaneform.com/?q=github.com

设置密钥后，vaneform <domain> 会打印访问量、环比变化、排名、主要国家/地区、来源、注册日期和报告链接，随后显示 Data: Vaneform (third-party traffic estimates)。

直接连接托管服务

curl -s https://vaneform.com/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

同一个密钥也可用于 REST API：文档、OpenAPI。

Agent 技能

复制该技能，让你的助手了解何时获取流量数据，以及如何引用数据：

# Claude Code (user-wide)
mkdir -p ~/.claude/skills/website-traffic-lookup
curl -fsSL https://raw.githubusercontent.com/vaneform/vaneform-mcp/main/skills/website-traffic-lookup/SKILL.md \
  -o ~/.claude/skills/website-traffic-lookup/SKILL.md

对于其他会读取 SKILL.md 文件夹的 Agent，请将其放入该 Agent 的技能目录（例如项目中的 .agents/skills/）。Vaneform 还在 vaneform.com/skill.md 提供了更底层的 API 技能。

解读数据

• status: "missing" 表示 Vaneform 尚未缓存该域名的数据，并不代表流量为零。compare_bulk 会获取该域名的数据。
• 每个估算值都带有对应月份（as_of）和 confidence 标签。引用时请一并注明。
• 引用结果时请写作 “Vaneform（第三方流量估算）”。

开发

npm install        # also builds dist/
npm run lint       # biome + tsc
npm test           # unit tests + a stdio test with the official MCP SDK client
VANEFORM_MCP_URL=http://localhost:3000/mcp node dist/bin/vaneform.js tools   # point at another server

运行时没有依赖项，需要 Node 18 或更新版本。此仓库仅包含客户端，不含任何数据采集代码。

许可证

MIT。该许可证仅适用于此代码，不适用于 API 返回的数据。流量数据由 Vaneform 提供，属于第三方估算。