Cómo usar Claude para SEO: guía práctica con API

Antes de generar nada, prepara tu entorno. Instala el SDK oficial y guarda tu API key como variable de entorno (nunca la escribas en el código). En España y LATAM funciona igual, solo necesitas conexión a la consola de Anthropic. Crea la key en console.anthropic.com > API Keys y expórtala en tu terminal. El SDK de Python simplifica las llamadas y maneja reintentos automáticamente. Verifica que la instalación funciona con una llamada mínima antes de construir prompts complejos: así aíslas problemas de autenticación de problemas de prompt.

pip install anthropic

# En tu terminal (Linux/Mac)
export ANTHROPIC_API_KEY='sk-ant-...'

# En Windows PowerShell
$env:ANTHROPIC_API_KEY='sk-ant-...'

Antes de nada, comprueba que la autenticación y el modelo responden. Usa el modelo claude-opus-4-8 como motor por defecto para tareas de SEO donde la calidad del razonamiento importa. Esta llamada mínima confirma que tu key es válida, que tienes crédito y que el SDK está bien instalado. El parámetro system define el rol persistente del modelo: aquí lo convertimos en un especialista SEO, lo que mejora la consistencia de todas las respuestas posteriores sin repetir instrucciones en cada mensaje.

import anthropic

client = anthropic.Anthropic()

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=300,
    system="Eres un consultor SEO senior especializado en el mercado hispanohablante (España y LATAM).",
    messages=[{
        "role": "user",
        "content": "Confirma en una frase que estás listo para trabajar en SEO."
    }]
)
print(resp.content[0].text)

El primer trabajo real de SEO es agrupar keywords por intención (informacional, comercial, transaccional). Pide a Claude salida en JSON para poder procesarla directamente. Fuerza el formato indicando la estructura exacta y añadiendo un prefijo de respuesta con 'assistant'. Esto reduce la verborrea y te da datos limpios para volcar en una hoja de cálculo o CMS. Parte siempre de una keyword semilla concreta de tu nicho.

seed = "software de facturación"

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1500,
    system="Eres un consultor SEO senior para el mercado hispanohablante.",
    messages=[
        {"role": "user", "content": f"Genera 15 keywords para '{seed}' agrupadas por intención. Devuelve SOLO JSON con esta forma: {{\"clusters\": [{{\"intencion\": \"...\", \"keywords\": [\"...\"]}}]}}"},
        {"role": "assistant", "content": "{"}
    ]
)
print("{" + resp.content[0].text)

Con el cluster elegido, genera un brief que un redactor pueda ejecutar. Un buen brief SEO incluye título propuesto, intención objetivo, estructura de encabezados H2/H3, preguntas frecuentes (para featured snippets) y entidades relacionadas que refuerzan la relevancia temática. Pasa la keyword principal y las secundarias como contexto. Este paso ahorra horas de planificación y garantiza cobertura semántica completa, algo que Google premia más que la densidad de keywords.

prompt = '''Crea un brief SEO para la keyword principal "software de facturación para autónomos".
Incluye:
1. Título H1 optimizado (máx 60 caracteres)
2. Intención de búsqueda
3. Estructura de H2 y H3
4. 5 preguntas FAQ para snippets
5. Entidades y términos LSI a incluir
Contexto: mercado España, público autónomos y pymes.'''

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=2000,
    system="Eres un estratega de contenidos SEO.",
    messages=[{"role": "user", "content": prompt}]
)
print(resp.content[0].text)

Los meta títulos y descripciones son de los factores on-page con mayor impacto en el CTR. Automatiza su generación respetando límites de caracteres (título ~60, descripción 140-155) e incluyendo la keyword. Puedes procesar una lista de URLs en bucle. Pide siempre que la descripción contenga un beneficio claro y una llamada a la acción suave, no solo keywords apiladas.

paginas = [
    {"url": "/facturacion-autonomos", "keyword": "software facturación autónomos"},
    {"url": "/facturas-electronicas", "keyword": "facturas electrónicas"}
]

for p in paginas:
    r = client.messages.create(
        model="claude-opus-4-8",
        max_tokens=300,
        system="Eres experto en copywriting SEO. Respeta límites de caracteres estrictos.",
        messages=[{"role": "user", "content": f"Keyword: {p['keyword']}. Genera meta título (máx 60 chars) y meta descripción (140-155 chars). Devuelve como 'Titulo: ... | Desc: ...'"}]
    )
    print(p['url'], '->', r.content[0].text)

Cierra el flujo auditando un texto ya publicado. Pega el contenido y pide a Claude que evalúe cobertura de la keyword, legibilidad, entidades ausentes y oportunidades de enlazado interno. Esto convierte a Claude en un revisor SEO permanente. Guarda el prompt como plantilla reutilizable para auditar todo tu sitio de forma sistemática y priorizar mejoras por impacto.

texto = """<pega aquí tu artículo o los primeros 1000 caracteres>"""

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1500,
    system="Eres auditor SEO. Sé concreto y accionable, prioriza por impacto.",
    messages=[{"role": "user", "content": f"Audita este contenido para la keyword 'gestión de facturas':\n\n{texto}\n\nEvalúa: cobertura de keyword, entidades ausentes, legibilidad y 3 mejoras priorizadas."}]
)
print(resp.content[0].text)