La API de SEOClave

Empieza en 2 minutos

1. Entra en tu cuenta y abre API (en el menú).
2. Pulsa Crear clave y cópiala: solo se ve una vez.
3. Pruébala (no gasta créditos):

curl https://seoclave.com/api/v1/cuenta/ \
  -H "Authorization: Bearer sc_TU_CLAVE"

{
  "plan": "Pro",
  "saldo": 150,
  "plan_vence": "2026-12-02T14:00:00+00:00",
  "limites": { "por_minuto": 10, "peticiones_dia": 1000, "creditos_dia": 50 },
  "hoy": { "peticiones": 1, "creditos": 0 }
}

Autenticación

Cada petición lleva la cabecera Authorization: Bearer sc_…. La clave nunca va en la URL (quedaría en historiales y registros) y no funciona desde la sesión de la web. Trátala como una contraseña: quien la tenga gasta tus créditos. Puedes tener hasta 3 y revocar cualquiera al momento; cuando creas una, te avisamos por correo.

Límites por plan

Por cuenta, sumando todas tus claves. Son obligatorios: protegen tus créditos y el servicio de todos.

Cada respuesta trae X-RateLimit-Limit y X-RateLimit-Remaining (este minuto); si te pasas, la respuesta es 429 con Retry-After en segundos. Lo rechazado por límite no se cobra.

Rutas

curl https://seoclave.com/api/v1/palabras/ \
  -H "Authorization: Bearer sc_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"modo": "ideas", "texto": "abogado de inmigración", "pais": "us", "limite": 50, "max_creditos": 1}'

{
  "id": 812, "modo": "ideas", "en_cache": false, "vacia": false,
  "resultado": { "filas": [
    { "palabra": "abogado de inmigración cerca de mí", "volumen": 9900, "cpc": 18.4,
      "dificultad": 31, "intencion": "commercial", "tendencia": [ … ] }
  ] },
  "creditos": 1, "saldo": 149, "avisos": []
}

Cuánto cuesta

Cómo no quemar créditos

• Pon siempre max_creditos. Si tu script arma mal una petición, no gasta más de eso.
• Pide solo las filas que vas a usar. limite: 50 cuesta 1 crédito; 1.000 filas, 7.
• Mide en lote. Una lista de 60 palabras en volumen cuesta 1 crédito; 60 peticiones sueltas, 60.
• No uses refrescar en bucles. Lo repetido ya es gratis 30 días; y si lo refrescas antes de 24 h, te devolvemos la que tienes sin cobrar.
• Guarda el id. Volver a leer /palabras/{id}/ es gratis.
• Baja tu tope diario en API mientras pruebas.
• Ante un 429, espera lo que diga Retry-After: reintentar al momento no sirve.

Errores

Siempre {"error": {"codigo": "…", "mensaje": "…"}}. El codigo no cambia: decide con él; el mensaje es para la persona.

Conector MCP: Claude, Cursor y más

MCP es el estándar abierto con el que los asistentes de IA usan herramientas externas. Conecta SEOClave y tu IA consulta Google sola cuando la conversación lo necesita: «¿cuánto se busca abogado en Houston?», «¿en qué puesto estoy para botas de cuero?». Usa tu misma clave, gasta los mismos créditos y respeta los mismos límites (solo cuentan las consultas, no el saludo ni la lista de herramientas).

Dirección del conector: https://seoclave.com/api/v1/mcp

claude mcp add --transport http seoclave https://seoclave.com/api/v1/mcp   --header "Authorization: Bearer sc_TU_CLAVE"

{
  "mcpServers": {
    "seoclave": {
      "url": "https://seoclave.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer sc_TU_CLAVE" }
    }
  }
}

Pronto: el botón «Conectar» en claude.ai (web y móvil) y en ChatGPT, entrando con tu cuenta de SEOClave sin copiar claves.

Conéctala con tu IA y tus herramientas

• ChatGPT (GPT personalizado): en Acciones, importa el esquema desdehttps://seoclave.com/api/v1/openapi.json y elige autenticación «API Key» tipo «Bearer» con tu clave. Tu GPT podrá medir palabras y ver el top 10 de hoy por sí solo.
• n8n o Make: un nodo HTTP Request con la cabecera Authorization: Bearer sc_….
• Claude y otros asistentes: con el conector MCP, tu IA consulta SEOClave sola.

import requests

r = requests.post("https://seoclave.com/api/v1/palabras/",
    headers={"Authorization": "Bearer sc_TU_CLAVE"},
    json={"modo": "volumen", "texto": "zapatos\nbotas de cuero\nsandalias", "max_creditos": 1},
    timeout=60)
r.raise_for_status()
for fila in r.json()["resultado"]["filas"]:
    print(fila["palabra"], fila["volumen"], fila["cpc"])

const r = await fetch("https://seoclave.com/api/v1/palabras/", {
  method: "POST",
  headers: { Authorization: "Bearer sc_TU_CLAVE", "Content-Type": "application/json" },
  body: JSON.stringify({ modo: "serp", texto: "abogado en houston", pais: "us", max_creditos: 1 }),
});
const datos = await r.json();
if (!r.ok) throw new Error(datos.error.codigo);
console.log(datos.resultado.organicos.slice(0, 3));

¿Dudas o algo que te falta? Escríbenos desde el centro de ayuda. Al usar la API aceptas los términos.