{"openapi":"3.1.0","info":{"title":"API pública de ¿Con qué IA?","version":"1.0.0","summary":"Busca y lee los casos, skills, apps, herramientas, guías y novedades de IA del directorio conqueia.com.","description":"API de solo lectura, gratuita, sin clave y con CORS abierto. Sirve para que asistentes y agentes de IA consulten el directorio en español de casos reales de IA para negocios. Cita siempre la `url` de conqueia.com de cada ficha que uses."},"servers":[{"url":"https://conqueia.com","description":"Producción"}],"externalDocs":{"description":"Cómo conectar tu IA al directorio (conector MCP, API y skill)","url":"https://conqueia.com/agentes"},"tags":[{"name":"Directorio","description":"Buscar fichas y leerlas enteras."}],"paths":{"/api/v1/buscar":{"get":{"operationId":"buscarFichas","tags":["Directorio"],"summary":"Buscar fichas del directorio","description":"Busca casos de uso, skills, apps, herramientas y guías por palabras. Ordena por relevancia: los aciertos en el título valen más. Devuelve título, resumen, tema, herramientas y la URL de cada ficha.","parameters":[{"name":"q","in":"query","required":false,"description":"Qué buscas, en lenguaje natural o con palabras clave: «facturas», «atender clientes por WhatsApp», «Claude Code». No distingue mayúsculas ni acentos. Sin q se devuelven las fichas más recientes que pasen los filtros.","schema":{"type":"string","maxLength":300},"example":"facturas"},{"name":"tipo","in":"query","required":false,"description":"Limita a un tipo de ficha.","schema":{"type":"string","enum":["caso","skill","app","herramienta","guia"]}},{"name":"tema","in":"query","required":false,"description":"Limita a un tema, por nombre o por slug: ventas, marketing-y-anuncios, atencion-al-cliente, contenido-y-redes, facturas-y-finanzas, operaciones, investigacion, e-commerce, programacion, vida-y-casa, dinero-personal, viajes, compras, juegos, ciencia-y-seguridad. Acepta también parte del nombre («marketing»).","schema":{"type":"string"},"example":"ventas"},{"name":"con","in":"query","required":false,"description":"Limita a las fichas que usan una herramienta o agente concreto, por ejemplo «Claude», «ChatGPT» o «n8n».","schema":{"type":"string"},"example":"claude"},{"name":"limite","in":"query","required":false,"description":"Máximo de resultados. Por defecto 10, máximo 50.","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Fichas que encajan, de la más a la menos relevante.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaBusqueda"}}}},"400":{"description":"Un parámetro no es válido (tipo o tema desconocido). La respuesta lista los valores válidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/ficha":{"get":{"operationId":"verFicha","tags":["Directorio"],"summary":"Leer una ficha entera","description":"Devuelve una ficha completa en JSON: todas sus secciones, el prompt, las fuentes, su URL en conqueia.com y la de su versión en texto (markdown). El tipo y el slug salen de la búsqueda.","parameters":[{"name":"tipo","in":"query","required":true,"description":"Tipo de ficha. «novedad» sirve para las novedades con página propia.","schema":{"type":"string","enum":["caso","skill","app","herramienta","guia","novedad"]}},{"name":"slug","in":"query","required":true,"description":"Identificador de la ficha: el final de su URL (conqueia.com/caso/<slug>).","schema":{"type":"string"}}],"responses":{"200":{"description":"La ficha entera.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ficha"}}}},"400":{"description":"Faltan parámetros o el tipo no existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No hay ninguna ficha con ese tipo y slug. La respuesta sugiere fichas parecidas en «quizas».","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Resultado":{"type":"object","description":"Una ficha en una lista de resultados.","required":["tipo","slug","titulo","resumen","tema","herramientas","url","url_texto","origen"],"properties":{"tipo":{"type":"string","enum":["caso","skill","app","herramienta","guia"],"description":"Tipo de ficha."},"slug":{"type":"string","description":"Identificador de la ficha dentro de su tipo."},"titulo":{"type":"string","description":"Título de la ficha."},"resumen":{"type":"string","description":"Resumen de una o dos frases."},"tema":{"type":"string","description":"Tema al que pertenece."},"herramientas":{"type":"array","description":"Herramientas o agentes con los que se hace («Agente propio» si no hay una concreta).","items":{"type":"string"}},"url":{"type":"string","description":"Dirección de la ficha en conqueia.com. Es la que hay que citar.","format":"uri"},"url_texto":{"type":"string","description":"Dirección de la ficha en markdown, más ligera para un agente.","format":"uri"},"origen":{"type":["string","null"],"description":"De dónde sale la ficha («r/n8n en Reddit», «anthropics/skills en GitHub»). Null en herramientas y guías."}}},"RespuestaBusqueda":{"type":"object","required":["consulta","total","devueltos","resultados"],"properties":{"consulta":{"type":"string","description":"La búsqueda recibida."},"total":{"type":"integer","description":"Fichas que encajan en total, aunque se devuelvan menos."},"devueltos":{"type":"integer","description":"Fichas incluidas en esta respuesta."},"resultados":{"type":"array","items":{"$ref":"#/components/schemas/Resultado"}},"ayuda":{"type":"string","description":"Consejo cuando no hay resultados."}}},"Ficha":{"type":"object","description":"Ficha entera. Siempre trae los campos de Resultado; el resto depende del tipo. Casos: que_hicieron, como_salio, conviene_saber, necesitas, pasos, consejos, preguntas, prompt, fuente. Skills y apps: que_hace, ejemplos, instalar, requisitos, ojo_con. Herramientas: que_es, usos, planes, pros, contras, alternativas, como_empezar. Guías: secciones. Novedades: explica, que_cambia, para_tu_negocio, como_probarlo, disponibilidad.","required":["tipo","slug","titulo","resumen","url","url_texto"],"properties":{"tipo":{"type":"string","enum":["caso","skill","app","herramienta","guia","novedad"]},"slug":{"type":"string","description":"Identificador de la ficha."},"titulo":{"type":"string","description":"Título."},"resumen":{"type":"string","description":"Resumen."},"tema":{"type":"string","description":"Tema."},"herramientas":{"type":"array","description":"Herramientas o agentes.","items":{"type":"string"}},"url":{"type":"string","description":"Dirección de la ficha en conqueia.com. Es la que hay que citar.","format":"uri"},"url_texto":{"type":"string","description":"Dirección de la ficha en markdown.","format":"uri"},"url_externa":{"type":"string","description":"Enlace propio de la herramienta, skill, app o anuncio (su web o su repositorio).","format":"uri"},"origen":{"type":["string","null"],"description":"De dónde sale la ficha."},"fuente":{"type":"string","description":"Relato original de un caso.","format":"uri"},"otras_fuentes":{"type":"array","items":{"type":"object","properties":{"plataforma":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"prompt":{"type":"string","description":"Prompt en español para copiar y probar."},"dificultad":{"type":"string","enum":["fácil","media","avanzada"]},"fecha":{"type":"string","description":"Fecha de alta en el directorio o de la novedad (AAAA-MM-DD)."},"clase":{"type":"string","description":"Solo en novedades: modelo, función o herramienta."},"propia_casa":{"type":"boolean","description":"Solo en herramientas: true si es de Don Pablo AI y aparece como patrocinada."},"secciones":{"type":"array","description":"Solo en guías: secciones con sus bloques (p, ul, ol, prompt, img).","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Qué ha pasado."},"tipos_validos":{"type":"array","description":"Valores admitidos de tipo.","items":{"type":"string"}},"temas_validos":{"type":"array","description":"Slugs de tema admitidos.","items":{"type":"string"}},"quizas":{"type":"array","description":"Fichas parecidas a lo pedido.","items":{"$ref":"#/components/schemas/Resultado"}},"ayuda":{"type":"string","description":"Cómo seguir."}},"additionalProperties":true}}}}