Cómo Usar Claude Code + AgentKit para Contenido SEO (2026)

por Jasmine, una desarrolladora que escribe contenido de SEO con Claude Code casi todos los días de trabajo.

La mayoría de las guías de "IA para SEO" te enseñan a analizar datos o a optimizar una página que ya existe. Casi ninguna muestra la parte en la que de verdad invierto mi tiempo: convertir una palabra clave en un artículo terminado y listo para publicar. Ese es justo el propósito de esta guía: el ciclo de escritura completo, con los prompts reales que uso, notas honestas sobre lo que falla y dónde una skill ya lista te ahorra una tarde entera de configuración.

¿Qué AgentKit? (30 segundos para no confundirte)

Antes de seguir, hay algo que hace tropezar cada búsqueda sobre este tema. "AgentKit" ahora significa dos productos que no tienen nada que ver entre sí:

Esta guía usa AgentKit for Claude Code: el kit en agentkit.best, instalado mediante la CLI ak, que incluye una skill seo y una skill ak-copywriting. No es el AgentKit de OpenAI (Agent Builder más ChatKit, lanzado el 2025-10-06), que es una plataforma distinta para construir agentes. También existe una skill gratuita de nombre casi idéntico en GitHub (AgriciDaniel/claude-seo). Esa es un único script de la comunidad; las skills de AgentKit que uso son un par mantenido, con actualizaciones. Lo menciono para que no instales lo que no es y te preguntes por qué los comandos son distintos.

¿Por qué usar Claude Code para contenido de SEO (en vez de una ventana de chat)?

Por supuesto que puedes escribir borradores de SEO en una ventana de chat. Yo lo hice durante un año. El problema es que un chat no tiene memoria de tus archivos ni "manos". Cada artículo es un ritual de copiar y pegar desde cero: pegas la voz de la marca, pegas las notas de la competencia, pegas el esquema, copias el borrador de vuelta, lo reformateas y lo haces todo otra vez la semana siguiente.

Claude Code es un agente de terminal de Anthropic que se ejecuta dentro de la carpeta de tu proyecto. Eso cambia la forma del trabajo de tres maneras concretas:

• Lee y escribe archivos reales. La voz de tu marca vive en un archivo CLAUDE.md, tus briefs están en /briefs, tus borradores aterrizan como .md o .html. El agente los abre, edita sobre la marcha y guarda. Sin idas y vueltas de copiar y pegar.
• Ejecuta comandos. Puede hacer grep en tus posts existentes para buscar objetivos de enlazado interno, contar caracteres en una meta description o comprobar que dos artículos no apunten a la misma palabra clave.
• Es repetible. Como las instrucciones viven en archivos y skills, el mismo pipeline se ejecuta igual en el artículo n.º 1 y en el n.º 40. Un prompt de chat que reescribes no es un flujo de trabajo; una skill que invocas, sí.

Si eres totalmente nueva en la herramienta, escribí una introducción en lenguaje sencillo sobre qué es Claude Code y en qué se diferencia de un plugin de editor. En corto: se parece más a un compañero júnior al que instruyes con archivos que a una casilla de autocompletar. Ese enfoque es lo que hace posible el pipeline de SEO de más abajo.

El trade-off honesto: una ventana de chat es más rápida para un párrafo suelto. Claude Code gana en el momento en que escribes contenido con regularidad y quieres el mismo estándar de calidad cada vez.

Lo que necesitas antes de empezar

Cinco cosas. Puedes empezar con las tres primeras y añadir el resto después.

• Claude Code instalado y con sesión iniciada. Un plan de pago de Claude (Pro cuesta US$ 20/mes; los niveles Max son US$ 100 y US$ 200/mes) hace cómodas las sesiones largas de artículo; hay un nivel gratuito limitado para probar el flujo.
• Una skill de SEO + copywriting. O te la armas tú (una carpeta de instrucciones que el agente carga) o usas una mantenida. Si el concepto es nuevo para ti, aquí tienes cómo funcionan las skills de Claude Code: son paquetes de instrucciones reutilizables que el agente activa cuando hacen falta. AgentKit incluye una skill seo y una skill ak-copywriting ya conectadas para exactamente este pipeline; más sobre eso luego.
• Un CLAUDE.md con la voz y las reglas de tu marca. Este es el archivo de mayor palanca. Pon aquí tu tono, las frases prohibidas, el nivel de lectura objetivo, los límites de longitud de meta title y meta description y las convenciones de enlazado interno. Cada sesión lo lee automáticamente.
• Datos de palabras clave. Claude Code no puede navegar por los resultados de búsqueda en vivo, así que le pasas tú los datos: la palabra clave objetivo, unas cuantas URLs de la competencia y cualquier métrica que tengas de Google Search Console, Semrush, Ahrefs o de una revisión manual de la SERP.
• Una estructura de carpetas de contenido. Algo tan simple como /briefs, /drafts y /published basta para que el agente no se pierda.

El flujo completo: de la palabra clave al artículo publicado

Esta es la columna vertebral: seis pasos, cada uno con un prompt o comando real, lo que el agente devuelve y dónde encaja una captura de pantalla. Los ejecuto como una secuencia, guardando cada salida en un archivo para que el siguiente paso pueda leerla.

Paso 1: Investigar la palabra clave y la intención de búsqueda

Claude Code no tiene acceso a la SERP en vivo, así que soy yo quien le entrega la materia prima. Pego la palabra clave objetivo y las URLs de la competencia mejor posicionada (copio el texto visible de la página a un archivo, o uso un paso de fetch/scrape si lo tengo montado) y le pido que haga el análisis que yo haría a mano.

Target keyword: "claude code for seo content"
I've saved the top 5 competitor pages to /research/competitors.md.

Read that file and give me:
1. The dominant search intent (informational / commercial / transactional)
2. Every H2 each competitor uses, grouped by theme
3. Topics ALL of them cover (table stakes)
4. Topics NONE of them cover well (my opening)
5. Rough word count of the top 3

Lo que vuelve es una clasificación estructurada de la intención más una lista de huecos. Esa lista de huecos es el oro: me dice dónde puedo añadir información que a las páginas bien posicionadas les falta, que es exactamente como te ganas un lugar en una SERP madura en vez de escribir la novena guía idéntica.

Paso 2: Generar el brief de contenido

Después convierto esa investigación en un brief que el paso de redacción pueda seguir a ciegas. Pido recuentos de palabras por sección, colocación de palabras clave, los huecos de la competencia mapeados a H2 concretos y un plan de schema.

Using /research/intent.md, write a content brief to /briefs/brief.md with:
- H1 + meta title (≤60 chars) + meta description (130-150 chars)
- A full H2/H3 outline with a word-count target per section
- Where the primary + 2 secondary keywords go
- Which competitor gap each section fills
- The schema to add (FAQPage if there's an FAQ)
Keep every claim checkable - mark anything you're unsure of as.

Una pequeña nota meta que construye credibilidad de verdad: el artículo que estás leyendo se escribió a partir de un brief estructurado exactamente así: recuentos de palabras por sección, huecos de la competencia, colocación de palabras clave, un plan de schema. El pipeline no es teórico; está produciendo esta página.

Paso 3: Redactar el artículo (anti-relleno)

Este es el paso que todo el mundo hace mal. Apunta una IA a un brief y dile "escríbelo" y obtienes relleno: introducciones huecas, "en el mundo acelerado de hoy", ideas repetidas, estadísticas falsas dichas con total seguridad. La solución es un prompt duro y específico más la voz de marca de tu CLAUDE.md.

Este es el prompt anti-relleno que de verdad uso:

Draft /drafts/article.md from /briefs/brief.md. Follow CLAUDE.md for voice.
Rules:
- No filler openings, no "in today's world", no throat-clearing. First
 sentence answers the question.
- Every claim is either checkable or marked. Invent NO statistics,
 prices, or study citations.
- Include at least one concrete, real example per major section.
- State limitations and trade-offs honestly - don't oversell.
- Vary sentence length. No paragraph over 4 sentences.
- Where I should add first-hand experience or a screenshot, leave a marker instead of faking it.

Las dos líneas que más importan son "no inventes estadísticas" y "deja un marcador en vez de inventar". Juntas, convierten al modelo de un fabulador seguro de sí mismo en un redactor cuidadoso que señala sus propios huecos. Aun así editarás mucho, pero estarás editando un esqueleto de verdad, no borrando relleno.

Paso 4: Optimización on-page

Como el borrador es un archivo, puedo optimizar los elementos on-page en la misma sesión en vez de pegar en otra herramienta. Pido todo de una pasada y —esto es clave— hago que el agente cuente los caracteres, porque los modelos son notoriamente malos con los límites de longitud a menos que les digas que verifiquen.

Optimize /drafts/article.md for on-page SEO:
- Meta title ≤60 chars - print the character count next to it
- Meta description 130-150 chars - print the count
- Check heading hierarchy (one H1, logical H2/H3)
- Suggest 3-5 internal links from /published (grep for related topics)
- Write descriptive alt text for each image placeholder
- Draft an FAQ (5-6 Q&A) and the matching FAQPage JSON-LD

La instrucción "imprime el recuento de caracteres" es la diferencia entre un título de 68 caracteres que sale truncado en los resultados y uno limpio de 54. Confía en el recuento y luego revísalo tú misma con la vista.

Hacer el on-page en la misma sesión tiene un segundo beneficio: las sugerencias de enlaces internos se apoyan en archivos que sí existen. Cuando le pido al agente que haga grep en /published buscando temas relacionados, propone enlaces a URLs reales y activas de mi sitio en lugar de inventar slugs de apariencia plausible, un error fácil de pasar por alto cuando optimizas en otra herramienta y pegas los enlaces a mano.

Paso 5: Edición humana, verificación de datos y E-E-A-T

Innegociable. Aquí es donde el artículo deja de ser salida de IA y pasa a ser tuyo. Hago cuatro cosas:

• Resolver cada marcador . Abro la fuente, confirmo el número o la fecha y sustituyo el marcador. Si no lo puedo verificar, se elimina.
• Rellenar cada marcador con una captura de pantalla real o una nota genuina de primera mano, no una invención de apariencia plausible.
• Añadir la experiencia que el modelo no puede tener: qué se rompió de verdad, qué me sorprendió, el trade-off que solo conozco por haberlo hecho.
• Citar y fechar. Para cualquier afirmación sobre una función o un lanzamiento, enlazo la fuente oficial con la fecha: la documentación de Anthropic para las funciones de Claude Code, o la página del proveedor para un dato de producto.

La propia guía de Google dice que el contenido debe demostrar experiencia, pericia, autoridad y confianza; consulta el Google Search Essentials sobre contenido útil y centrado en las personas (consultado en 08/2026). Un primer borrador de IA, por defecto, no tiene nada de eso. Lo inyectas tú aquí, o el artículo se queda genérico.

Paso 6: Publicar y hacer seguimiento

El último paso depende de tu stack. Yo escribo en Markdown o HTML, así que publicar es un push al CMS —Strapi, en mi caso—, pero el mismo flujo basado en archivos le sirve a WordPress (mediante un importador) o a un sitio estático. Después:

• Envía o deja que el sitemap avise a los motores de búsqueda.
• Anota la palabra clave objetivo y la fecha de publicación para poder medir el artículo más tarde.
• Vuelve a mirar en 2 a 4 semanas los rankings y cualquier aparición en AI Overview, y realimenta el siguiente brief con lo que aprendas.

Si quieres ejecutar todo este ciclo como un proceso repetible y gobernado por el agente —briefs, borradores y revisión como pasos definidos en vez de prompts improvisados—, desgloso ese patrón en mi guía sobre el flujo de desarrollo con IA usando AgentKit. El mismo ritmo de idear-planificar-construir-publicar que funciona para el código funciona para el contenido.

Hazlo más rápido: las skills de SEO + copywriting ya listas de AgentKit

Todo lo anterior funciona con skills que te armas tú misma. La trampa es que armarlas bien —el formato del brief, las reglas anti-relleno, las comprobaciones on-page, el plan de schema— lleva tiempo e iteración de verdad. Si prefieres saltarte el montaje, aquí es donde un kit mantenido demuestra su valor.

AgentKit incluye una skill seo y una skill ak-copywriting (parte de su kit de Marketing) que llegan ya conectadas con un pipeline como el de este artículo: briefs de contenido con recuentos de palabras por sección, puntuación de la competencia, orientación de colocación de palabras clave y fórmulas de copy de conversión. La configuración se hace mediante la CLI ak en menos de cinco minutos, y las skills reciben actualizaciones de por vida, así que el flujo sigue el ritmo de las herramientas a medida que cambian. Es la diferencia entre un único script gratuito de github y un par mantenido que se mantiene al día.

¿Quieres el pipeline sin la configuración? El kit de Marketing (que incluye las skills seo + ak-copywriting) cuesta US$ 99, y el sitio no indica una cuota recurrente para los kits; el bundle Engineer + Marketing sale por US$ 149. Hay garantía de devolución del dinero (el sitio no indica una duración fija). Para el panorama completo, lee mi análisis completo de AgentKit o mira los precios de AgentKit (20 % de descuento con el enlace) y vuelve a comprobar las cifras actualizadas antes de comprar.

Para que quede claro por qué pagas: las skills no eliminan el Paso 5. Sigues verificando datos y añadiendo experiencia. Eliminan la configuración de los Pasos 1 a 4, que es la parte tediosa.

Ejemplo real: un artículo, de principio a fin

Déjame mostrarte el pipeline con una pieza real en vez de describirlo en abstracto. Escribí una guía sobre enlazado interno usando exactamente los seis pasos de arriba.

Pasos 1-2 (investigación + brief): Metí cinco URLs de la competencia. El análisis de huecos señaló que toda página bien posicionada explicaba qué son los enlaces internos, pero ninguna mostraba una auditoría repetible de un sitio existente. Ese pasó a ser mi ángulo, y el brief montó el esquema alrededor de él.

Paso 3 (borrador): Con el prompt anti-relleno, el primer borrador volvió con tres marcadores en estadísticas que se negó a inventar y dos marcadores donde correspondía una captura de pantalla. Esa negativa es el comportamiento que quieres: es honesto sobre sus propios puntos ciegos.

Paso 4 (on-page): El meta title inicial volvió con 63 caracteres. Como había pedido el recuento impreso, el exceso quedó evidente y lo recorté a 55 en una sola edición, en vez de enterarme semanas después por un snippet truncado.

Paso 5 (la parte honesta): Aquí fue donde más tiempo invertí. La sección del borrador "por qué importan los enlaces internos" era técnicamente correcta pero genérica: puro libro de texto. La reescribí con un error concreto que yo había cometido (páginas huérfanas tras una migración de sitio) que ningún modelo podría haber sabido. También corté una subsección entera que el modelo rellenó y que no aportaba nada. Alrededor del 40 % del artículo terminado fue edición humana. Eso es normal, y quien te diga que el contenido de IA sale listo al 95 % te está vendiendo algo.

Resultado: un artículo listo para publicar en aproximadamente un tercio del tiempo que habría llevado la versión totalmente manual, con la puerta de calidad intacta porque una persona sostuvo el último paso. Si quieres ejecutar este mismo ciclo con las skills ya montadas, puedes probar el flujo ya listo y adaptar los briefs a tu propia voz.

Buenas prácticas: automatizar vs. mantener humano

El modelo mental más útil aquí es una línea clara entre lo que el agente hace bien y lo que debe quedarse contigo. Cruza esa línea y la calidad cae rápido.

Regla general: automatiza lo mecánico y repetitivo; conserva el juicio y la experiencia. El valor que aportas como redactora es precisamente la columna de la derecha, así que protégela.

Limitaciones honestas

Si una guía solo te vende lo bueno, desconfía. Esto es lo que de verdad sale mal:

• Sin acceso a la SERP en vivo. Claude Code no ve los resultados de búsqueda actuales. Todo lo que "sabe" sobre la competencia es lo que tú le das. Una entrada desactualizada o pobre equivale a un brief débil.
• Estadísticas y citas alucinadas. Sin un prompt estricto, inventará una estadística o un estudio con total seguridad. Las reglas anti-relleno lo reducen; no lo eliminan. Debes verificar cada número.
• Relleno por defecto. El borrador base tiende a lo genérico. Una buena salida es función de un buen prompt más un CLAUDE.md fuerte, no del modelo por sí solo.
• Costo y límites. Las sesiones largas de artículo consumen uso del plan o tokens de API. Los equipos de mucho contenido deberían presupuestar un plan Max o vigilar el gasto de API (Opus y Sonnet se cobran por millón de tokens).
• El tiempo de verificación es real. El pipeline acelera la redacción, no la verificación de datos. El Paso 5 no se comprime. Si acaso, hacerlo bien es el impuesto honesto por usar IA.

Nada de esto convierte a la herramienta en una mala idea. La convierte en una herramienta: una que recompensa a quien la opera con habilidad y castiga a quien es perezoso.

Preguntas frecuentes (FAQ)

¿Claude Code puede escribir contenido de SEO de verdad?

Sí, cuando lo gobiernas como un pipeline basado en archivos: investiga la palabra clave, genera un brief, redacta con reglas anti-relleno, ejecuta la optimización on-page y luego edita a mano. Maneja bien la síntesis de investigación, la redacción y la mecánica on-page. No puede reemplazar la verificación de datos ni la experiencia de primera mano, así que una persona sigue siendo dueña del paso final.

¿El contenido escrito por IA va contra las directrices de Google?

No. La guía de Google apunta al contenido de baja calidad y poco útil, sin importar cómo se produjo, no al uso de IA en sí. El contenido que demuestra experiencia, pericia y precisión reales puede posicionarse, haya ayudado la IA a escribirlo o no. Los pasos de edición humana y verificación de datos son los que lo mantienen del lado correcto de esa línea.

¿Necesito un plan de pago o un kit de pago?

Necesitas un plan de Claude (existe un nivel gratuito limitado; el Pro, a US$ 20/mes, es cómodo para escribir con regularidad). Un kit de pago es opcional: puedes armar tus propias skills de SEO y copywriting gratis. Un kit como AgentKit solo te ahorra el tiempo de configuración al entregar esas skills ya conectadas.

Claude Code vs. ChatGPT para contenido de SEO: ¿cuál es mejor?

ChatGPT (una ventana de chat) es más rápido para un párrafo suelto. Claude Code gana en la producción repetible y basada en archivos, porque lee y escribe tus archivos de contenido reales, ejecuta comandos y puede gobernarse con una skill reutilizable, así que el mismo estándar de calidad se aplica a cada artículo, no solo al que tienes delante.

¿Qué AgentKit usa esta guía?

AgentKit for Claude Code (agentkit.best, CLI ak), que incluye las skills seo y ak-copywriting. Este no es el AgentKit de OpenAI (Agent Builder y ChatKit), que es una plataforma de construcción de agentes sin relación, lanzada en octubre de 2025.

¿Puede publicar directo en WordPress o Strapi?

El flujo produce archivos Markdown o HTML, que encajan directo en un sitio estático o en Strapi, y en WordPress mediante un importador o la REST API. Claude Code no hace push a tu CMS de forma automática por defecto, pero, como la salida es un archivo simple, el paso de publicación es un push o import sencillo.

Conclusión y próximos pasos

El método entero cabe en un ciclo: investigar la palabra clave, generar un brief, redactar con reglas anti-relleno, optimizar el on-page, editar a mano y verificar los datos, y luego publicar y hacer seguimiento. La magia no es el modelo: es tratar el contenido como archivos y mantener humano el último paso. Arma las skills tú misma, o sáltate la configuración con un kit mantenido y dedica tu tiempo a lo que cuenta.

¿Nueva por aquí? Empieza con qué es Claude Code, luego lee el análisis completo de AgentKit y la guía del flujo de desarrollo con IA para ejecutar esto como un sistema repetible.