Vaneform

Comprobador gratuito de tráfico web para agentes de IA: visitas mensuales estimadas, fuentes de tráfico, principales países y comparación de dominios lado a lado. Endpoint alojado en https://vaneform.com/mcp.

GitHub

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

vaneform-mcp

Consultas de tráfico web para asistentes de IA y la terminal. Este repositorio contiene un servidor MCP, una pequeña CLI y una habilidad de agente para Vaneform, un verificador gratuito de tráfico web.

Pregúntale a tu asistente "¿cuánto tráfico recibe notion.so?" o "compara figma.com y canva.com" y responderá con visitas mensuales estimadas, cambio mes a mes, ranking, principales países, fuentes de tráfico y datos de registro. Las cifras de tráfico son estimaciones de tráfico de terceros; consulta la metodología de Vaneform.

中文说明

Qué contiene

Pieza	Qué es
Servidor MCP alojado	`https://vaneform.com/mcp` (Streamable HTTP). Sin instalación, y la opción recomendada.
`vaneform-mcp`	Servidor MCP stdio local para clientes que solo ejecutan comandos locales. Actúa como proxy del servidor alojado, por lo que las herramientas nunca se desincronizan.
CLI `vaneform`	`vaneform notion.so`, `vaneform compare a.com b.com`, `vaneform tld name`. Comparte el mismo cliente.
`skills/website-traffic-lookup`	Habilidad de agente (formato Claude / Agent Skills) que indica al asistente cuándo consultar el tráfico y cómo leer y citar el resultado.

Herramientas

Estos nombres y descripciones de herramientas provienen del tools/list del servidor alojado:

Herramienta	Qué hace	Costo
`lookup_domain`	Instantánea en caché de un dominio: visitas (de todo el sitio o de búsqueda), registro, perfil del sitio, popularidad por ranking de enlaces	0 puntos
`compare_bulk`	Comparación lado a lado de visitas y registro para varios dominios; obtiene el tráfico cuando falta	0 puntos
`compare_tld`	Un nombre en varios sufijos (por defecto `com,ai,io`)	0 puntos
`get_account`	Plan y puntos restantes	gratis
`lookup_keyword`	Resumen de palabras clave en EE. UU.: volumen, dificultad, CPC, ocupación de Google (Pro)	4 puntos en fallo de caché

Clave de API

El descubrimiento (initialize, tools/list) es abierto. Las llamadas a herramientas necesitan una clave de API de Vaneform.

La API está incluida con Vaneform Pro. Crea una clave en vaneform.com/account/api. Las consultas y comparaciones de dominios no cuestan puntos; cada clave permite 60 solicitudes por minuto y 5,000 por día (429 lookup_rate_exceeded por encima de eso). Los 1,000 puntos mensuales de Pro solo cubren datos de palabras clave (lookup_keyword, rankings de palabras clave).
Pasa la clave como Authorization: Bearer vf_live_… (remoto) o VANEFORM_API_KEY (servidor local y CLI).

Si no se establece ninguna clave, las herramientas aún se listan. Una llamada devuelve un enlace de registro y un enlace de navegador como https://vaneform.com/?q=notion.so, donde obtienes 3 consultas gratuitas al día sin cuenta (999 con una cuenta gratuita). Cuando se agotan los puntos, el error apunta a precios.

Instalación

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 (o .cursor/mcp.json en un proyecto):

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

Claude Desktop (stdio local)

La configuración más simple de Claude Desktop que pasa tu clave es el proxy local. Edita 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_…" }
    }
  }
}

El paquete aún no está en npm, por lo que npx lo instala desde GitHub. El primer inicio tarda un poco más porque compila una vez. Si npx sale de inmediato en un sistema npm antiguo (el npm 9.2 empaquetado de Debian hace esto con paquetes de GitHub), ejecuta npm install -g github:jiangqizheng/vaneform-mcp y usa "command": "vaneform-mcp" sin argumentos.

Codex

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

Cualquier otro cliente MCP

Remoto: URL https://vaneform.com/mcp, transporte Streamable HTTP, encabezado Authorization: Bearer vf_live_…
Local: comando npx -y github:jiangqizheng/vaneform-mcp, entorno 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

Salida real contra producción el 2026-10-08, sin clave establecida:

$ 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).

Con una clave, vaneform <domain> imprime visitas, cambio MoM, ranking, principales países, fuentes, fechas de registro y el enlace del informe, seguido de Data: Vaneform (third-party traffic estimates).

Habla directamente con el servidor alojado

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

La misma clave funciona para la API REST: docs, OpenAPI.

Habilidad de agente

Copia la habilidad para que tu asistente sepa cuándo recurrir a los datos de tráfico y cómo citarlos:

# 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 otros agentes que leen carpetas SKILL.md, colócala en el directorio de habilidades de ese agente (por ejemplo, .agents/skills/ en un proyecto). Vaneform también ofrece una habilidad de API de nivel inferior en vaneform.com/skill.md.

Lectura de los números

status: "missing" significa que Vaneform aún no ha almacenado en caché ese dominio. No significa tráfico cero. compare_bulk lo obtiene.
Cada estimación lleva su mes (as_of) y una etiqueta confidence. Cítalos.
Cita los resultados como "Vaneform (estimaciones de tráfico de terceros)".

Desarrollo

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

El runtime no tiene dependencias y requiere Node 18 o superior. Este repositorio contiene solo el cliente. Aquí no hay código de recopilación de datos.

Licencia

MIT. La licencia cubre solo este código, no los datos devueltos por la API. Las cifras de tráfico son estimaciones de terceros servidas por Vaneform.