VNCNT Labs SEO & Search Data

npx add-mcp 'https://mcp.apify.com/?tools=vncntlabs/keyword-search-volume,vncntlabs/keyword-ideas,vncntlabs/domain-seo-data,vncntlabs/google-trends-search-volume,vncntlabs/ai-search-visibility-tracker,vncntlabs/google-maps-rank-tracker,vncntlabs/google-ads-transparency,vncntlabs/google-news-scraper'

Ejemplos de Apify de VNCNT Labs

Código mínimo y ejecutable para tres tutoriales sobre cómo obtener datos de SEO y búsqueda a través de la API de Apify. Cada carpeta tiene la misma llamada de cuatro formas: curl, Python (apify-client), Node.js (apify-client) y, donde el tutorial lo usa, un flujo de trabajo de n8n. La carpeta mcp/ conecta Claude, ChatGPT o Cursor a los mismos Actors a través del servidor MCP de Apify.

Carpeta	Tutorial	Actor de Apify
01-keyword-search-volume	Volumen de búsqueda masivo de palabras clave en Google + Amazon (tutorial)	Keyword Search Volume
02-competitor-seo-report	Un informe SEO de la competencia para cualquier dominio (tutorial próximamente)	Domain SEO Data
03-google-trends-volume	Google Trends con números reales de búsquedas mensuales (tutorial próximamente)	Google Trends with Search Volume

Configuración

Necesitas una cuenta de Apify y un token de API (Apify Console > Settings > API & Integrations).

export APIFY_TOKEN=your_apify_token_here   # or copy .env.example to .env and load it; never commit it

pip install -r requirements.txt             # Python 3.10+
npm install                                 # Node 18+

Cada ejemplo lee el token de la variable de entorno APIFY_TOKEN. Nada en este repositorio contiene un token real.

Ejecutar

# Python
python 01-keyword-search-volume/python_example.py
# Node
node 01-keyword-search-volume/node_example.mjs
# curl (synchronous: returns the dataset rows as JSON)
./01-keyword-search-volume/curl.sh

Cada script de Python y Node usa la entrada del tutorial por defecto. Pasa un archivo JSON para usar tu propia entrada:

python 02-competitor-seo-report/python_example.py my-input.json

test-inputs/ contiene la entrada útil más pequeña para cada Actor (1 palabra clave, 1 dominio, 1 término). scripts/smoke_test.sh ejecuta los seis ejemplos de Python y Node con ellos.

Nota para Python: apify-client 3.x devuelve un objeto Run, por lo que el ID del dataset es run.default_dataset_id. El código escrito para 1.x/2.x usa run["defaultDatasetId"] en su lugar.

n8n

Importa 01-keyword-search-volume/n8n-workflow.json (Workflows > Import from file). Luego crea una credencial Header Auth con el nombre Authorization y el valor Bearer <your token>, y selecciónala en el nodo HTTP Request. Cada palabra clave se convierte en un elemento de n8n.

Claude, ChatGPT, Cursor (MCP)

Archivo	Úsalo cuando
mcp/remote-oauth.json	Tu cliente admite servidores MCP remotos. Inicias sesión en Apify en el navegador y no se coloca ningún token en el archivo.
mcp/remote-bearer.json	Prefieres usar un token. Los clientes que expanden variables de entorno leen ${APIFY_TOKEN}. De lo contrario, pega tu token.
mcp/local-stdio.json	Tu cliente solo admite servidores locales (necesita Node 18+). Reemplaza el token de marcador de posición.

Cada configuración carga solo los tres Actors anteriores más las herramientas de búsqueda de Actors de Apify. Luego pregunta algo como "Obtén el volumen de búsqueda de Google y Amazon en EE. UU. para estas 40 palabras clave y ordénalas por volumen por punto de KD."

Costos

Los tres Actors son de pago por evento, y solo pagas por los resultados devueltos. Los precios actuales están en la página de la tienda de cada Actor, y puedes limitar una ejecución con maxTotalChargeUsd (entrada de Keyword Search Volume) o la configuración de cargo máximo en cualquier ejecución.

Licencia

MIT, ver LICENSE. Los datos provienen de los proveedores de los Actors bajo sus términos. No está afiliado con Google o Amazon.