Vaneform

vaneform-mcp

AI アシスタントやターミナルからウェブサイトのトラフィックを調べられます。このリポジトリには、Vaneform（無料のウェブサイトトラフィックチェッカー）向けの MCP サーバー、小型 CLI、エージェントスキルが含まれています。

アシスタントに「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	エージェントスキル（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から利用できます。

Free と Pro

	Free	Pro
月間クレジット数	100	10,000
API キー、MCP、CLI	✓	✓
ドメインの検索と比較（ドメインごとに 1 クレジット、24 時間以内の再検索は無料）	✓	✓
キーワード概要（60 クレジット）		✓
サイトのキーワードランキング（200 クレジット）		✓

各キーでは、1 分あたり 60 件、1 日あたり 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。

エージェントスキル

トラフィックデータを使うタイミングと引用方法をアシスタントが把握できるように、スキルをコピーしてください。

# 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 フォルダーを読み込むその他のエージェントでは、そのエージェントのスキルディレクトリ（たとえば、プロジェクト内の .agents/skills/）に配置してください。Vaneform は、より低レベルの API スキルも vaneform.com/skill.md で提供しています。

数値の読み方

• 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 が提供するサードパーティの推定値です。