AI SEO In Detail

AI SEO In Detail › Módulo A · Fundamentos › Episodio 7

Episodio 7 · 7:03 · gratis

DataForSEO + Claude Code: tu primer análisis SEO

Describe un análisis de palabras clave y SERP en lenguaje natural, deja que Claude Code escriba el script, aprueba el coste, ejecútalo en DataForSEO y verifica los resultados.

Al reproducir el vídeo se carga desde YouTube (modo de privacidad mejorada). El vídeo está en inglés con subtítulos en tu idioma.

Checklist gratuita

Prompt del primer análisis + checklist de coste y verificación

El prompt del episodio 7 (diez palabras clave de café inventadas), los cuatro requisitos de la barrera de coste —qué, cuántas, coste estimado, esperar el GO— y la rutina de verificación de cinco minutos que detecta la trampa de la profundidad diez antes de que se convierta en una conclusión.

  • Primero, el plan — Pega el prompt. El asistente responde con un plan y un script: comprobar la caché, una tarea de volumen de búsqueda, diez páginas de resultados en vivo con profundidad 10 y volcado a las tablas que ya tienes. Lee el script antes de aprobarlo.
  • La barrera: qué, cuántas, coste, GO — Antes de cualquier llamada de pago muestra los endpoints y parámetros, el número de peticiones tras los aciertos de caché y el coste estimado, y luego espera tu GO. Unos doce céntimos en esta ejecución.
  • Verifica en cinco minutos — Lee los parámetros de la petición, cuenta los resultados orgánicos por palabra clave, abre a mano una respuesta sin procesar y pregúntate qué otra cosa podría explicar el resultado. La profundidad cuenta todos los elementos de la página, no solo los enlaces azules.
Descarga la checklist de una página

PDF · A4 · sin registro

Descarga el prompt

Texto plano · cópialo en Claude Code

Los archivos están en inglés.

Transcripción completa (traducida)

1,166 palabras · traducción de la narración del episodio.

Introducción

Tienes credenciales de DataForSEO del episodio tres. Tienes un espacio limpio del episodio seis. Ahora hagamos que hagan algo útil, rápido.

En este episodio describo un análisis pequeño en inglés simple, y Claude Code escribe el script, me muestra el plan, pregunta antes de gastar un centavo, lo ejecuta y resume el resultado. Unos diez minutos y unos doce centavos.

Pero la parte más importante viene después del resumen. Porque la primera vez que confié en un análisis escrito por IA sin verificar, me dijo algo que no era verdad. Te mostraré exactamente cómo pasó y cómo detectarlo.

La tarea, en lenguaje llano

Nuestra tienda demo es example-shop dot test, una tienda inventada que vende equipos de café. Tengo diez palabras clave que me importan. Molinillo de fresas. Máquina espresso para casa. Tetera cuello de cisne. Ese tipo.

La tarea que doy a Claude Code es un párrafo. Para estas diez palabras clave, obtener el volumen mensual de búsqueda y la página de resultados en vivo de Google en Estados Unidos. Guardar todo en la base de datos. Luego decirme quién rankea y qué funciones aparecen en cada página.

Nota qué NO dice el prompt. No dice qué endpoints usar, cómo analizar la respuesta, o cómo se llaman las tablas. El archivo de instrucciones ya tiene eso y las reglas: caché primero, claves intocables y sin llamadas pagas sin mi permiso.

Ese es el punto de la configuración del episodio seis. El prompt puede ser corto porque las reglas ya están escritas.

Primero, el plan

Claude Code no empieza llamando nada. Responde con un plan y un script.

El plan tiene cuatro pasos. Revisar el caché. Una tarea de volumen con las diez palabras en ella. Diez páginas de resultados en vivo, una por palabra, a profundidad diez. Luego analizar todo en las tablas que ya tenemos, y escribir un resumen breve.

Y leo el script. No cada línea en detalle, pero suficiente para tres preguntas. ¿Qué endpoints llama? ¿Cuántas veces? ¿Y dónde va la respuesta cruda antes de analizarse? Si no puedo responder esas tres del código, no lo apruebo.

La barrera de coste

Luego la compuerta. Antes de llamadas pagas, debe mostrarme qué llamará y qué costará.

Una tarea de volumen cubre hasta mil palabras, unos nueve centavos. Diez páginas de resultados a profundidad diez cuestan 0.3 centavos cada una, así que tres centavos. Total, unos doce centavos. Luego para y espera.

Doce centavos es nada. La compuerta no es por esta ejecución. Es por el hábito. El mismo prompt con diez mil palabras, o un bucle infinito, usa exactamente el mismo código. La compuerta hace que mires antes de que cueste dinero real.

Mi configuración va un paso más allá. La herramienta de IA que uso simplemente no puede gastar sola. Llamadas pagas necesitan mi permiso explícito, siempre. Recomiendo lo mismo para ti.

Caché y, después, ejecución

Tras mi permiso, ejecuta. Cada respuesta se guarda en la carpeta caché antes de analizarse, con palabra, ubicación, profundidad y fecha en el nombre del archivo.

Eso importa de inmediato. Si el analizador falla, o quiero otro resumen, o hago una pregunta de seguimiento, el script lee del caché. Nunca pago dos veces por la misma página. Ejecútalo un minuto después y la compuerta dice: diez aciertos de caché, cero llamadas pagas, cero costo.

Cómo leer el resumen

Y aquí está el resumen. Estos son números inventados para ilustración, no datos reales.

Para cada palabra, un volumen, los dominios en los primeros resultados, y las funciones en la página. Un párrafo breve arriba: competitor-a dot test aparece en siete de diez páginas. AI Overviews aparecen en palabras informacionales. Resultados de Shopping dominan las palabras de producto. Y example-shop dot test, nuestro sitio, está en el top diez solo en cuatro.

Hace diez minutos tenía una lista de palabras. Ahora tengo una base con volúmenes, diez páginas guardadas, y una primera imagen del mercado.

Aquí es donde la mayoría se detiene. Copian el resumen a un reporte y siguen. No lo hagas.

La IA escribe, tú verificas

Aquí está la regla para todo el curso. La IA escribe, tú verificas.

El modelo es muy bueno escribiendo un script que funciona. Es menos bueno notando cuando el script funciona bien pero mide lo incorrecto. Un resumen escrito en frases confiadas se ve igual si los números son correctos o incorrectos.

Así que antes de creer una conclusión, verificas dos cosas. El código: ¿cuenta lo que crees que cuenta? Y los números: ¿una respuesta cruda, abierta a mano, coincide con el resumen? Por eso soy estricto con esto.

La trampa de la profundidad diez

Esto me pasó, en uno de mis sitios, muy recientemente. Pedí el mismo análisis que acabas de ver. Nueve palabras. El reporte escrito por IA volvió con una conclusión clara: mi sitio no está en el top diez para cinco de las nueve.

Ese es un hallazgo serio. Suena como un problema de ranking y me habría hecho reescribir páginas.

Así que abrí las respuestas crudas. Y los números no cuadraban. Algunas páginas tenían solo seis o siete resultados orgánicos. No diez.

Por qué. La petición usó profundidad diez. Y profundidad cuenta cada elemento en la página, no solo los enlaces azules. Un AI Overview cuenta. Cada caja de "La gente también pregunta" cuenta. Así que en una página llena de funciones, profundidad diez me dio entre seis y nueve resultados orgánicos. Mi sitio no faltaba del top diez. Simplemente estaba fuera de lo que habíamos pedido.

La conclusión era un artefacto de la petición, no un hecho sobre los resultados de búsqueda.

Y el hallazgo real era diferente y más interesante. En varias palabras, mi sitio fue citado dentro del AI Overview mismo. Visible al tope de la página, en un lugar que el script nunca contó como ranking.

Cómo verificar en cinco minutos

Así que aquí está mi rutina de verificación. Toma unos cinco minutos.

Primero, lee los parámetros de petición en el código. Profundidad, ubicación, idioma, dispositivo. La mayoría de conclusiones incorrectas empiezan ahí.

Segundo, pide al modelo que cuente los resultados orgánicos por palabra. Si alguna página tiene menos de diez, la afirmación "no en top diez" no está probada.

Tercero, abre una respuesta cruda del caché tú mismo, y encuentra una fila del resumen en ella.

Cuarto, pregunta: ¿qué más podría explicar este resultado? Un ranking faltante puede ser página corta, ubicación diferente, o una función que retiene el sitio.

La solución en mi caso fue barata. Re-ejecutar solo las páginas cortas a profundidad veinte, 0.6 centavos cada una, y por la misma compuerta de costo.

Hacia dónde sigue esto

En el episodio 48 automatizamos todo el análisis: extracciones programadas, un reporte cada semana y la misma compuerta.

Pero mientras, el resto del curso enseña cada método a mano primero. No porque la IA no pueda, sino porque solo verificas lo que entiendes. Cuando el modelo diga algo sorprendente, sabrás dónde buscar.

Resumen final

Deja que la IA escriba el script, compuerta cada llamada paga, y verifica los números antes de creerlos. El prompt y la lista de compuerta están enlazados en la descripción. Próximo episodio: cómo leer Search Console bien, y qué significan clics, impresiones, CTR y posición. Nos vemos ahí.