{"openapi":"3.0.3","info":{"title":"ComerCia Digital API","description":"API pública A2A (Agent-to-Agent) de ComerCia Digital · REINPIA SAS. Permite a agentes IA descubrir y consultar catálogos de comercios mexicanos operando en la plataforma. Optimizada para AI agents (ChatGPT, Claude, Gemini, Perplexity).","version":"1.0.0","contact":{"name":"REINPIA SAS","email":"legal@comerciadigital.com.mx","url":"https://comerciadigital.com.mx"},"license":{"name":"ComerCia Terms","url":"https://comerciadigital.com.mx/legal/terminos-y-condiciones"},"x-business-location":"Querétaro, México"},"servers":[{"url":"https://comerciadigital.com.mx","description":"Producción"}],"paths":{"/api/kakao/inquire":{"post":{"summary":"Endpoint conversacional A2A — consulta comercial","description":"Pregunta a un comercio específico de ComerCia. Devuelve respuesta JSON-LD con productos relevantes, pitch, contacto.","operationId":"kakaoInquire","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"comercio_id":{"type":"string","description":"Subdominio del comercio (default: comerciadigital)","example":"bandasbaleros"},"message":{"type":"string","description":"Tu consulta en lenguaje natural","example":"Necesito bandas industriales SKF para motor 5HP en CDMX"}}}}}},"responses":{"200":{"description":"Respuesta JSON-LD A2A con productos relevantes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespuestaA2A"}}}},"403":{"description":"Bloqueado por escudo anti-injection"},"429":{"description":"Rate limit excedido"}}}},"/api/kakao/catalog":{"get":{"summary":"Catálogo público en formato schema.org OfferCatalog","operationId":"kakaoCatalog","parameters":[{"name":"comercio","in":"query","schema":{"type":"string"},"example":"bandasbaleros"}],"responses":{"200":{"description":"OfferCatalog JSON-LD"}}}},"/api/kakao/inventory":{"get":{"summary":"Inventario en tiempo real","operationId":"kakaoInventory","parameters":[{"name":"comercio","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Lista de items con stock"}}}},"/llms.txt":{"get":{"summary":"Mapa para LLMs (formato Markdown estándar emergente)","operationId":"llmsTxt","responses":{"200":{"description":"Markdown con sitemap, endpoints, palabras clave","content":{"text/plain":{}}}}}},"/.well-known/agents.json":{"get":{"summary":"Manifiesto A2A descubrible por crawlers IA","operationId":"agentsManifest","responses":{"200":{"description":"Manifest con endpoints, capabilities, rate limits"}}}},"/mcp":{"get":{"summary":"Model Context Protocol manifest (opt-in tool para Claude/ChatGPT/Cursor)","operationId":"mcpManifest","responses":{"200":{"description":"MCP server info + tools + resources"}}}}},"components":{"schemas":{"RespuestaA2A":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"respuesta":{"type":"object","properties":{"@context":{"type":"string","example":"https://schema.org"},"@type":{"type":"string","example":"Response"},"comercio":{"type":"string"},"mensaje":{"type":"string","description":"Respuesta en lenguaje natural lista para mostrar al usuario humano"},"productos_relevantes":{"type":"array","items":{"type":"object"}},"pitch":{"type":"string"},"trust_signals":{"type":"array","items":{"type":"string"}},"contacto":{"type":"object","properties":{"whatsapp":{"type":"string"},"url":{"type":"string"}}}}}}}}}}