Conecta Search Console a Claude Code con un solo comando
Claude Code
Para conectar Search Console a Claude Code, añade PaidSync.ai: ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, escribe /mcp e inicia sesión con tu cuenta de PaidSync.
Claude Code accede entonces a tus propiedades de Search Console mediante 6 herramientas: clics, impresiones, CTR y posición por consulta, página, país y dispositivo, además de la cobertura de indexación de sitemaps. Claude Code pregunta antes de ejecutar cada herramienta.
Nivel Watch. Search Console es de solo lectura en PaidSync, así que Claude Code lee tus datos de búsqueda y no cambia nada.
El comando
Claude Code se comunica con servidores MCP remotos mediante Streamable HTTP. PaidSync es uno de ellos. Añádelo una vez y la misma terminal que edita tu código puede informar sobre tus campañas de Search Console y gestionarlas.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor defecto, eso registra el servidor solo para el proyecto actual. Añade --scope user para que esté disponible en todos los proyectos de tu equipo.
Ejecuta claude mcp list para confirmar que está ahí, luego inicia una sesión y escribe /mcp para iniciar sesión.
Configuración en 5 pasos
1Regístrate en paidsync.ai/signup
Lleva 10 segundos. Inicio de sesión con Google o con correo. El plan gratuito incluye 100 tareas al mes, con un valor de $50, a $0, sin tarjeta.
2Conecta Search Console en el panel de PaidSync
Haz clic en Conectar en Search Console e inicia sesión con la cuenta de Google que tiene acceso a tus propiedades. Search Console se autoriza mediante Google OAuth y PaidSync nunca ve tu contraseña de Google.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_google_search_console. La herramienta devuelve un enlace para abrir en tu navegador.
3Elige la cuenta publicitaria en la que debe trabajar Claude Code
Dentro de una sesión, list_gsc_properties muestra todas las propiedades que tu acceso de Google puede abrir. Indica la propiedad en tu prompt.
4Añade PaidSync a Claude Code
En tu terminal, ejecuta:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicia una sesión, escribe /mcp, elige paidsync e inicia sesión con tu acceso de PaidSync en la ventana del navegador que se abre. Claude Code guarda el token OAuth por ti. No se pega ninguna clave en ningún sitio.
¿Lo configuras para un equipo? Sube un .mcp.json en la raíz del repositorio para que cada ingeniero reciba el mismo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}¿Prefieres una clave API, por ejemplo para ejecuciones sin interfaz? Envíala en una cabecera, nunca en la URL, donde acabaría en los registros:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"En un .mcp.json versionado, añade "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que la clave se quede en el entorno de cada ingeniero y nunca entre en git. Aplicar un cambio en Google Ads sigue requiriendo el inicio de sesión OAuth. En otras plataformas una clave también puede aplicar cambios, así que trátala como una contraseña y prefiere OAuth.
5Prueba la conexión
En una sesión de Claude Code pregunta: “¿Cuáles son mis 20 consultas orgánicas con más clics este mes, con la posición media de cada una?”
Claude Code devuelve clics, impresiones, CTR y posición media de cada consulta. La conexión está activa.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts de Search Console en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo de Search Console de PaidSync. Claude Code elige la herramienta. La última columna indica si la llamada puede cambiar algo en la cuenta publicitaria.
| Petición | Herramientas que llama | Cambia tu cuenta |
|---|---|---|
| “Lista mis propiedades de Search Console” | list_gsc_properties | No |
| “¿Cuáles son mis 20 consultas orgánicas con más clics este mes?” | get_gsc_search_analytics | No |
| “¿Qué páginas tienen muchas impresiones pero un CTR bajo?” | get_gsc_search_analytics | No |
| “¿Cuántas de las URL de mis sitemaps están indexadas?” | get_gsc_index_coverage | No |
| “Compara mi rendimiento orgánico de este mes con el del mismo mes del año pasado” | get_gsc_search_analytics | No |
| “¿Por qué palabras clave de Google Ads estoy pagando cuando ya posiciono entre los cinco primeros?” | analyze_paid_organic_overlap | No |
| “Desglosa mis clics e impresiones orgánicos por país de los últimos 90 días” | get_gsc_search_analytics | No |
Ejecútalo en modo headless con claude -p
El indicador -p ejecuta Claude Code sin la sesión interactiva. Inicia sesión una vez con /mcp y el token de OAuth guardado se mantiene. Un informe que termina en un archivo se ve así:
claude -p "Pull last 28 days Search Console top queries by clicks and list the pages with high impressions and low CTR." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/search-console-$(date +%F).jsonLas lecturas se ejecutan directamente, y las escrituras también. --allowedTools "mcp__paidsync" permite todas las herramientas de PaidSync, escrituras incluidas, sin aviso.
Para un trabajo desatendido, permite solo las herramientas de lectura que necesite, cada una por nombre como mcp__paidsync__tool_name.
Qué lee y qué escribe
Search Console es de solo lectura en PaidSync: ninguna de las 6 herramientas de Search Console puede escribir.
Cubren el listado de propiedades, el análisis de búsqueda por consulta, página, país y dispositivo, y la cobertura de indexación de sitemaps. Search Console conserva 16 meses de datos.
Leer más
Con MCP, el paso de aprobación es el propio aviso de Claude Code. Pregunta antes de ejecutar una herramienta, salvo que la hayas permitido con --allowedTools o en tus ajustes. PaidSync añade comprobaciones por su parte. Las eliminaciones, pausas y cambios de presupuesto requieren confirm_destructive, y una comprobación de reglas previa a la escritura bloquea los argumentos inseguros. La tarjeta de aprobación, y Undo en una tarjeta aplicada cuyo cambio tiene una inversa segura, solo se aplican en el espacio de trabajo de PaidSync.
Añadir a ChatGPT: abre PaidSync.ai en el directorio de plugins de ChatGPT, instálalo e inicia sesión.
Añadir a Claude: abre PaidSync.ai en el directorio de conectores de Claude, haz clic en Conectar e inicia sesión.
Lo que Claude Code no puede en Search Console
- PaidSync nunca modifica tu propiedad. La API propia de Google también puede enviar sitemaps y añadir sitios; PaidSync no.
- PaidSync no lee el informe de indexación de páginas ni la Inspección de URL.
- El análisis de búsqueda devuelve un desglose por solicitud, por ejemplo por país o por dispositivo.
- La cobertura de indexación de sitemaps compara el número de páginas enviadas con las indexadas de cada sitemap.
- Las comprobaciones de pago frente a orgánico requieren tener también Google Ads conectado.
Preguntas frecuentes
¿Cómo conecto Search Console con Claude Code?
Regístrate en paidsync.ai, conecta Search Console en el panel y ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp en tu terminal. Escribe /mcp dentro de una sesión, elige paidsync e inicia sesión con tu acceso de PaidSync.
¿Puede Claude Code modificar mi propiedad de Search Console?
No. Search Console es de solo lectura en PaidSync. Claude Code lee tus datos de búsqueda y nunca modifica tu propiedad.
¿Puede Claude Code comparar Search Console con Google Ads?
Sí. Con Google Ads también conectado, analyze_paid_organic_overlap estima el gasto mensual de las palabras clave en las que ya posicionas entre los cinco primeros, y Claude Code puede comparar las principales consultas orgánicas con tus palabras clave de pago.
¿Funciona en modo headless con claude -p?
Sí. Una vez que has iniciado sesión con /mcp, claude -p reutiliza el token de OAuth guardado. Las lecturas se ejecutan directamente. Las escrituras requieren cuidado. No hay nadie para responder al aviso de Claude Code, así que cualquier herramienta de escritura que hayas permitido con --allowedTools se ejecuta directamente. Para un trabajo desatendido, permite solo las herramientas de lectura que necesite.
Es gratis
Sí. El plan gratuito cuesta $0 por 100 tareas al mes, sin tarjeta. Pro empieza en $99 al mes y Team en $249 al mes.
Informes de Search Console. Un solo comando en Claude Code.