Vaneform

Verificador gratuito de tráfego de sites para agentes de IA: visitas mensais estimadas, fontes de tráfego, principais países e comparação lado a lado de domínios. Endpoint hospedado https://vaneform.com/mcp.

GitHub

Servidor MCP hospedado

npx add-mcp 'https://vaneform.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

vaneform-mcp

Consultas de tráfego de sites para assistentes de IA e terminal. Este repositório contém um servidor MCP, um pequeno CLI e uma habilidade de agente para o Vaneform, um verificador gratuito de tráfego de sites.

Pergunte ao seu assistente "quanto tráfego o notion.so recebe?" ou "compare figma.com e canva.com" e ele responderá com estimativas de visitas mensais, variação mês a mês, posição no ranking, principais países, fontes de tráfego e dados de registro. Os números de tráfego são estimativas de tráfego de terceiros; consulte a metodologia do Vaneform.

中文说明

O que está incluído

Componente	O que é
Servidor MCP hospedado	`https://vaneform.com/mcp` (Streamable HTTP). Sem instalação, e a opção recomendada.
`vaneform-mcp`	Servidor MCP stdio local para clientes que só executam comandos locais. Ele faz proxy do servidor hospedado, então as ferramentas nunca divergem.
CLI `vaneform`	`vaneform notion.so`, `vaneform compare a.com b.com`, `vaneform tld name`. Ele compartilha o mesmo cliente.
`skills/website-traffic-lookup`	Habilidade de agente (formato Claude / Agent Skills) que informa ao assistente quando verificar tráfego e como ler e citar o resultado.

Ferramentas

Estes nomes e descrições de ferramentas vêm do tools/list do servidor hospedado:

Ferramenta	O que faz	Custo
`lookup_domain`	Snapshot em cache de um domínio: visitas (site completo ou busca), registro, perfil do site, popularidade no ranking de links	0 pontos
`compare_bulk`	Visitas lado a lado e registro para vários domínios; busca tráfego quando estiver ausente	0 pontos
`compare_tld`	Um nome em vários sufixos (padrão `com,ai,io`)	0 pontos
`get_account`	Plano e pontos restantes	gratuito
`lookup_keyword`	Resumo de palavras-chave nos EUA: volume, dificuldade, CPC, ocupação no Google (Pro)	4 pontos em cache miss

Chave de API

Descoberta (initialize, tools/list) é aberta. Chamadas de ferramentas precisam de uma chave de API do Vaneform.

A API está incluída no Vaneform Pro. Crie uma chave em vaneform.com/account/api. Consultas e comparações de domínios não custam pontos; cada chave permite 60 requisições por minuto e 5.000 por dia (429 lookup_rate_exceeded acima disso). Os 1.000 pontos mensais do Pro pagam apenas por dados de palavras-chave (lookup_keyword, rankings de palavras-chave).
Passe a chave como Authorization: Bearer vf_live_… (remoto) ou VANEFORM_API_KEY (servidor local e CLI).

Se nenhuma chave for definida, as ferramentas ainda aparecem na lista. Uma chamada retorna um link de cadastro e um link de navegador como https://vaneform.com/?q=notion.so, onde você obtém 3 consultas gratuitas por dia sem conta (999 com conta gratuita). Quando os pontos acabam, o erro aponta para preços.

Instalação

Claude Code (remoto)

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

Cursor (remoto)

~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

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

Claude Desktop (stdio local)

A configuração mais simples do Claude Desktop que passa sua chave é o proxy local. Edite claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

O pacote ainda não está no npm, então npx o instala a partir do GitHub. A primeira inicialização demora um pouco mais porque compila uma vez. Se npx sair imediatamente em um sistema npm antigo (o npm 9.2 empacotado no Debian faz isso com pacotes do GitHub), execute npm install -g github:jiangqizheng/vaneform-mcp e use "command": "vaneform-mcp" sem argumentos.

Codex

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

Qualquer outro cliente MCP

Remoto: URL https://vaneform.com/mcp, transporte Streamable HTTP, cabeçalho Authorization: Bearer vf_live_…
Local: comando npx -y github:jiangqizheng/vaneform-mcp, env VANEFORM_API_KEY

CLI

npx -p github:jiangqizheng/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                         # remaining points (free)
vaneform notion.so --json                # raw API JSON

Saída real contra produção em 2026-10-08, sem chave definida:

$ 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 point 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.
API access is included with Pro. Create an API key at https://vaneform.com/account/api (domain lookups cost no points).
Check it in a browser instead: https://vaneform.com/?q=github.com (3 free lookups a day without an account, 999 with a free account).

Com uma chave, vaneform <domain> imprime visitas, variação MoM, posição no ranking, principais países, fontes, datas de registro e o link do relatório, seguido por Data: Vaneform (third-party traffic estimates).

Fale diretamente com o servidor hospedado

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"}'

A mesma chave funciona para a API REST: docs, OpenAPI.

Habilidade de agente

Copie a habilidade para que seu assistente saiba quando recorrer aos dados de tráfego e como citá-los:

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

Para outros agentes que leem pastas SKILL.md, coloque-a no diretório de habilidades desse agente (por exemplo, .agents/skills/ em um projeto). O Vaneform também oferece uma habilidade de API de nível inferior em vaneform.com/skill.md.

Lendo os números

status: "missing" significa que o Vaneform ainda não armazenou esse domínio em cache. Isso não significa tráfego zero. compare_bulk o busca.
Cada estimativa carrega seu mês (as_of) e um rótulo confidence. Cite-os.
Cite os resultados como "Vaneform (estimativas de tráfego de terceiros)".

Desenvolvimento

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

O runtime não tem dependências e precisa de Node 18 ou mais recente. Este repositório contém apenas o cliente. Nenhum código de coleta de dados está aqui.

Licença

MIT. A licença cobre apenas este código, não os dados retornados pela API. Os números de tráfego são estimativas de terceiros servidas pelo Vaneform.