API y MCP para desarrolladores

El contenido público de CVclick —guías para hacer el currículum y buscar trabajo, los diseños de CV y el test que recomienda uno— se puede consultar desde programas y asistentes de IA. Es gratis, de solo lectura y no pide registro ni claves.

• • Solo contenido del sitio: nunca datos de usuarios ni sus currículums.
• • Crear y descargar un CV lo hace la persona en la web: no hay API para eso ni registro de agentes.
• • Idiomas: es, en, pt, fr, it, de. Categorías de guías: cv, profesion, empleo, entrevista, ia.

API REST

JSON con CORS abierto. Especificación OpenAPI 3.1: https://cvclick.app/openapi.json.

GET /api/v1/guides?lang=&q=&category=&limit=

Busca o lista guías. La búsqueda no distingue tildes ni mayúsculas.

GET /api/v1/guides/{lang}/{slug}

Una guía completa, con su texto en Markdown. 404 si no existe.

GET /api/v1/templates?lang=

Los 14 diseños de currículum y si son compatibles con ATS.

GET /api/v1/recommend-template?sector=&experience=&photo=&channel=

El test de «¿Qué diseño de CV va contigo?»: plantilla, alternativa y porqué.

GET /api/health

Estado de la API.

curl "https://cvclick.app/api/v1/guides?q=curriculum+camarero&limit=3"

Servidor MCP

Endpoint https://cvclick.app/mcp con transporte Streamable HTTP, sin estado y sin autenticación. Admite la revisión 2026-07-28 del protocolo (sin handshake, con server/discover) y las anteriores con initialize. Descripción previa a la conexión: Server Card.

• search_guides

  Busca guías de CVclick sobre cómo hacer un currículum, currículums por profesión, buscar trabajo, la entrevista y el trabajo con IA. Sin q devuelve todas. Devuelve título, descripción y URL.

• get_guide

  Devuelve una guía completa de CVclick en Markdown (respuesta directa, apartados, ejemplos y preguntas frecuentes) a partir de su slug, que da search_guides.

• list_templates

  Lista los 14 diseños de currículum de CVclick: nombre, para qué sirve, si es compatible con ATS (una columna) y URL de su ficha. Todos son gratis en PDF y Word.

• recommend_template

  Recomienda un diseño de currículum (y una alternativa) con el mismo test de cvclick.app/que-plantilla, según sector, experiencia, foto y cómo se enviará el CV.

{
  "mcpServers": {
    "cvclick": { "type": "http", "url": "https://cvclick.app/mcp" }
  }
}

Skill para agentes

La skill crear-curriculum-cvclick explica a un agente cómo ayudar a una persona a hacer su CV con CVclick: elegir diseño, usar las guías, el comprobador y el editor. Está en el índice de skills.

Descubrimiento

• /.well-known/api-catalog — catálogo de APIs (RFC 9727).
• /.well-known/ai-catalog.json — catálogo de recursos para agentes.
• /auth.md — acceso: público, sin credenciales.
• /llms.txt — resumen del sitio para modelos de lenguaje.

Límites y condiciones

• • Uso razonable. El servidor MCP admite 60 peticiones por minuto por IP; si se supera, responde 429.
• • Las respuestas de la API llevan caché pública de una hora: no hace falta pedir lo mismo una y otra vez.
• • Si muestras el contenido, enlaza la URL de la guía o plantilla que devuelve la API.
• • Dudas o problemas: contacto.