{
  "openapi": "3.1.0",
  "info": {
    "title": "Sitio Cero — API pública y capa de ejecución para agentes de IA",
    "version": "2.0.0",
    "summary": "Servicios, estimación de proyectos web, portafolio, blog, contacto y solicitud de cotización de Sitio Cero (Puebla, México).",
    "description": "Especificación de https://sitiocero.mx, estudio de diseño y desarrollo de páginas web en Puebla, México. Pensada para Function Calling de agentes de IA (ChatGPT Actions, Claude, Gemini, LangChain, LlamaIndex): cada herramienta tiene un operationId igual a su nombre en MCP y WebMCP. Los precios son los publicados en el sitio; cuando no hay cifra publicada la API responde \"a cotizar\" en lugar de inventarla. Las estimaciones son orientativas y no vinculantes. Para contactar a una persona el canal prioritario es WhatsApp (obtener_contacto devuelve el enlace con mensaje prellenado).",
    "contact": {
      "name": "Enrique Rosas",
      "email": "contacto@sitiocero.mx",
      "url": "https://sitiocero.mx"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://sitiocero.mx/terminos-de-servicio"
    }
  },
  "servers": [
    {
      "url": "https://sitiocero.mx",
      "description": "Producción (Cloudflare Edge)"
    }
  ],
  "tags": [
    {
      "name": "Herramientas",
      "description": "Consulta de servicios, estimación, portafolio, blog, mapa del sitio y contacto (solo lectura)."
    },
    {
      "name": "Leads",
      "description": "Envío de solicitudes de cotización con rate limit por IP."
    },
    {
      "name": "MCP",
      "description": "Endpoint Model Context Protocol."
    }
  ],
  "externalDocs": {
    "description": "Contexto completo para LLMs",
    "url": "https://sitiocero.mx/llms-full.txt"
  },
  "paths": {
    "/api/tools/listar_servicios": {
      "get": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Listar servicios de desarrollo web",
        "description": "Lista los servicios de Sitio Cero (páginas web para PYMEs, e-commerce a medida, plataformas y software a medida, y auditoría de sitios existentes) con qué incluye cada uno, el precio publicado en MXN y el plazo. Úsala primero para recomendar el servicio adecuado a lo que el usuario necesita. No requiere parámetros.",
        "operationId": "listar_servicios_get",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Listar servicios de desarrollo web",
        "description": "Lista los servicios de Sitio Cero (páginas web para PYMEs, e-commerce a medida, plataformas y software a medida, y auditoría de sitios existentes) con qué incluye cada uno, el precio publicado en MXN y el plazo. Úsala primero para recomendar el servicio adecuado a lo que el usuario necesita. No requiere parámetros.",
        "operationId": "listar_servicios",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      }
    },
    "/api/tools/estimar_proyecto_web": {
      "post": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Estimar costo y plazo de un proyecto web",
        "description": "Estima precio (en MXN) y plazo de un proyecto web de Sitio Cero a partir de los rangos publicados en el sitio: landing page desde $8,000, sitio institucional con CMS de $12,000 a $25,000, e-commerce desde $20,000; plataformas a medida y mejora de sitios se cotizan tras un diagnóstico. Devuelve qué incluye, condiciones de pago, garantía y un enlace de WhatsApp con el resumen ya escrito. La estimación es orientativa y no vinculante. Úsala cuando el usuario pregunte cuánto cuesta o cuánto tarda una página web, tienda en línea o sistema.",
        "operationId": "estimar_proyecto_web",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tipo_proyecto": {
                    "type": "string",
                    "enum": [
                      "landing_page",
                      "sitio_institucional",
                      "ecommerce",
                      "plataforma_a_medida",
                      "mejora_sitio_existente"
                    ],
                    "description": "Tipo de proyecto: \"landing_page\" (una sola página), \"sitio_institucional\" (varias páginas con CMS editable), \"ecommerce\" (tienda en línea), \"plataforma_a_medida\" (sistema, portal, ERP/CRM o dashboard) o \"mejora_sitio_existente\" (auditar o rehacer un sitio que ya existe)."
                  },
                  "numero_paginas": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100,
                    "description": "Número aproximado de páginas del sitio (opcional). Una landing page es una sola página."
                  },
                  "funcionalidades": {
                    "type": "array",
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "enum": [
                        "blog",
                        "multi_idioma",
                        "pasarela_pagos",
                        "catalogo_productos",
                        "reservas_citas",
                        "facturacion_cfdi",
                        "area_clientes",
                        "integracion_erp_crm",
                        "panel_administrativo"
                      ]
                    },
                    "description": "Funcionalidades adicionales requeridas (opcional): \"blog\" (Blog o sección de artículos); \"multi_idioma\" (Sitio en varios idiomas); \"pasarela_pagos\" (Cobro en línea (Stripe, Conekta, Mercado Pago, SPEI)); \"catalogo_productos\" (Catálogo de productos con búsqueda y filtros); \"reservas_citas\" (Reservas o agenda de citas); \"facturacion_cfdi\" (Facturación electrónica CFDI); \"area_clientes\" (Área privada de clientes con inicio de sesión); \"integracion_erp_crm\" (Integración con ERP, CRM u otros sistemas); \"panel_administrativo\" (Panel administrativo a medida)."
                  },
                  "tiene_sitio_actual": {
                    "type": "boolean",
                    "description": "Indica si el negocio ya tiene un sitio web que se quiere reemplazar o mejorar (opcional)."
                  },
                  "ciudad": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Ciudad o estado del cliente (opcional). El trabajo es 100% remoto en toda la República Mexicana."
                  }
                },
                "required": [
                  "tipo_proyecto"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      }
    },
    "/api/tools/ver_portafolio": {
      "get": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Ver proyectos del portafolio",
        "description": "Devuelve los proyectos del portafolio de Sitio Cero (sitios para PYMEs, e-commerce y plataformas) con descripción, tecnologías y métricas reportadas. Úsala para dar pruebas de experiencia o ejemplos relevantes al tipo de negocio del usuario.",
        "operationId": "ver_portafolio_get",
        "parameters": [
          {
            "name": "categoria",
            "in": "query",
            "required": false,
            "description": "Filtra por categoría: \"pyme\" (sitios y PYMEs), \"ecomm\" (tiendas en línea) o \"plataforma\" (sistemas y plataformas). Omitir para ver todos.",
            "schema": {
              "type": "string",
              "enum": [
                "pyme",
                "ecomm",
                "plataforma"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Ver proyectos del portafolio",
        "description": "Devuelve los proyectos del portafolio de Sitio Cero (sitios para PYMEs, e-commerce y plataformas) con descripción, tecnologías y métricas reportadas. Úsala para dar pruebas de experiencia o ejemplos relevantes al tipo de negocio del usuario.",
        "operationId": "ver_portafolio",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "categoria": {
                    "type": "string",
                    "enum": [
                      "pyme",
                      "ecomm",
                      "plataforma"
                    ],
                    "description": "Filtra por categoría: \"pyme\" (sitios y PYMEs), \"ecomm\" (tiendas en línea) o \"plataforma\" (sistemas y plataformas). Omitir para ver todos."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      }
    },
    "/api/tools/buscar_articulos": {
      "get": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Buscar artículos del blog técnico",
        "description": "Busca en el blog de Sitio Cero artículos sobre desarrollo web, e-commerce, SEO técnico (Core Web Vitals) y sistemas empresariales a medida. Devuelve título, resumen, categoría y URL para citar o recomendar. Úsala para resolver dudas técnicas del usuario con fuentes del propio estudio.",
        "operationId": "buscar_articulos_get",
        "parameters": [
          {
            "name": "consulta",
            "in": "query",
            "required": false,
            "description": "Palabras clave a buscar en título, descripción, etiquetas y categoría (opcional; si se omite devuelve los más recientes).",
            "schema": {
              "type": "string",
              "maxLength": 100
            }
          },
          {
            "name": "categoria",
            "in": "query",
            "required": false,
            "description": "Filtra por pilar temático (opcional).",
            "schema": {
              "type": "string",
              "enum": [
                "desarrollo-web",
                "ecommerce",
                "seo-tecnico",
                "sistemas-empresariales"
              ]
            }
          },
          {
            "name": "limite",
            "in": "query",
            "required": false,
            "description": "Máximo de artículos a devolver (1 a 10, por defecto 5).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 5
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Buscar artículos del blog técnico",
        "description": "Busca en el blog de Sitio Cero artículos sobre desarrollo web, e-commerce, SEO técnico (Core Web Vitals) y sistemas empresariales a medida. Devuelve título, resumen, categoría y URL para citar o recomendar. Úsala para resolver dudas técnicas del usuario con fuentes del propio estudio.",
        "operationId": "buscar_articulos",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "consulta": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "Palabras clave a buscar en título, descripción, etiquetas y categoría (opcional; si se omite devuelve los más recientes)."
                  },
                  "categoria": {
                    "type": "string",
                    "enum": [
                      "desarrollo-web",
                      "ecommerce",
                      "seo-tecnico",
                      "sistemas-empresariales"
                    ],
                    "description": "Filtra por pilar temático (opcional)."
                  },
                  "limite": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10,
                    "default": 5,
                    "description": "Máximo de artículos a devolver (1 a 10, por defecto 5)."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      }
    },
    "/api/tools/mapa_del_sitio": {
      "get": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Mapa del sitio para navegar",
        "description": "Devuelve las páginas y secciones clave de sitiocero.mx (servicios, metodología, portafolio, contacto, FAQ, blog, sobre mí y legales) con su URL y para qué sirve cada una. Úsala para decidir a dónde navegar sin recorrer todo el sitio.",
        "operationId": "mapa_del_sitio_get",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Mapa del sitio para navegar",
        "description": "Devuelve las páginas y secciones clave de sitiocero.mx (servicios, metodología, portafolio, contacto, FAQ, blog, sobre mí y legales) con su URL y para qué sirve cada una. Úsala para decidir a dónde navegar sin recorrer todo el sitio.",
        "operationId": "mapa_del_sitio",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      }
    },
    "/api/tools/obtener_contacto": {
      "get": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Obtener canales de contacto",
        "description": "Devuelve cómo contactar a Sitio Cero: WhatsApp directo (canal prioritario, con enlace wa.me y mensaje prellenado), correo, formulario web, horario de atención y ubicación. Úsala cuando el usuario quiera hablar con una persona, agendar la auditoría gratuita o dar el siguiente paso.",
        "operationId": "obtener_contacto_get",
        "parameters": [
          {
            "name": "mensaje",
            "in": "query",
            "required": false,
            "description": "Mensaje inicial para prellenar en WhatsApp (opcional). Por ejemplo, un resumen del proyecto del usuario.",
            "schema": {
              "type": "string",
              "maxLength": 600
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Herramientas"
        ],
        "summary": "Obtener canales de contacto",
        "description": "Devuelve cómo contactar a Sitio Cero: WhatsApp directo (canal prioritario, con enlace wa.me y mensaje prellenado), correo, formulario web, horario de atención y ubicación. Úsala cuando el usuario quiera hablar con una persona, agendar la auditoría gratuita o dar el siguiente paso.",
        "operationId": "obtener_contacto",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mensaje": {
                    "type": "string",
                    "maxLength": 600,
                    "description": "Mensaje inicial para prellenar en WhatsApp (opcional). Por ejemplo, un resumen del proyecto del usuario."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resultado de la herramienta en JSON (mismos datos que devuelven MCP y WebMCP).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Argumentos inválidos. El cuerpo explica qué valor corregir.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolError"
                }
              }
            }
          }
        }
      }
    },
    "/api/contact": {
      "post": {
        "tags": [
          "Leads"
        ],
        "summary": "Enviar solicitud de cotización o mensaje de contacto",
        "description": "Registra una solicitud de cotización o propuesta técnica para proyectos de desarrollo web, tiendas online o software a medida. Dispara notificaciones automáticas y canaliza la atención con Enrique Rosas.",
        "operationId": "submitContactLead",
        "requestBody": {
          "required": true,
          "description": "Datos de contacto y requerimientos del proyecto web",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ContactRequest"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/ContactRequest"
              }
            },
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ContactRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Mensaje recibido y procesado con éxito",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SuccessResponse"
                },
                "example": {
                  "success": true,
                  "message": "Mensaje recibido y enviado con éxito."
                }
              }
            }
          },
          "400": {
            "description": "Solicitud inválida o faltan campos obligatorios",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "success": false,
                  "error": "Faltan campos obligatorios: nombre, correo electrónico y mensaje."
                }
              }
            }
          },
          "413": {
            "description": "Carga útil excede el límite máximo permitido (10 KB)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Límite de envíos excedido (máximo 5 por IP cada 10 minutos)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "success": false,
                  "error": "Has alcanzado el límite de envíos. Por favor espera antes de intentar de nuevo."
                }
              }
            }
          },
          "500": {
            "description": "Error interno del servidor",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Servicio de recepción temporalmente no disponible",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/mcp": {
      "post": {
        "tags": [
          "MCP"
        ],
        "summary": "Endpoint Model Context Protocol (JSON-RPC 2.0, Streamable HTTP sin sesión)",
        "description": "Acepta mensajes JSON-RPC de MCP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list y prompts/get. Las notificaciones responden 202. Transporte SSE heredado en /api/mcp/sse.",
        "operationId": "mcpJsonRpc",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "method"
                ],
                "properties": {
                  "jsonrpc": {
                    "const": "2.0"
                  },
                  "id": {
                    "type": [
                      "string",
                      "integer"
                    ]
                  },
                  "method": {
                    "type": "string",
                    "examples": [
                      "tools/list",
                      "tools/call"
                    ]
                  },
                  "params": {
                    "type": "object",
                    "additionalProperties": true
                  }
                }
              },
              "example": {
                "jsonrpc": "2.0",
                "id": 1,
                "method": "tools/list"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Respuesta JSON-RPC.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "202": {
            "description": "Notificación aceptada (sin cuerpo)."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ContactRequest": {
        "type": "object",
        "required": [
          "nombre",
          "email",
          "mensaje"
        ],
        "properties": {
          "nombre": {
            "type": "string",
            "minLength": 2,
            "maxLength": 100,
            "description": "Nombre de la persona de contacto o representante",
            "example": "Mariana Gómez"
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 120,
            "description": "Correo electrónico válido donde se enviará la propuesta o respuesta",
            "example": "mariana@constructora.com"
          },
          "empresa": {
            "type": "string",
            "maxLength": 120,
            "description": "Nombre de la empresa, negocio o marca",
            "example": "Gómez & Asociados"
          },
          "tipo": {
            "type": "string",
            "enum": [
              "pyme",
              "ecomm",
              "plataforma",
              "mejora",
              "otro"
            ],
            "description": "Tipo o categoría del proyecto web solicitado",
            "example": "pyme"
          },
          "otro_servicio": {
            "type": "string",
            "maxLength": 200,
            "description": "Detalle del servicio si el campo 'tipo' es 'otro'",
            "example": "Integración con sistema ERP existente"
          },
          "mensaje": {
            "type": "string",
            "minLength": 10,
            "maxLength": 3000,
            "description": "Descripción de los requerimientos, alcance o preguntas del proyecto",
            "example": "Hola, nos interesa renovar la página web de nuestra empresa con entrega rápida y buen SEO local en Puebla."
          },
          "utm_source": {
            "type": "string",
            "description": "Fuente de tráfico o canal de procedencia (ej. 'chatgpt', 'agent', 'google')",
            "example": "ai_agent"
          },
          "utm_medium": {
            "type": "string",
            "description": "Medio de adquisición (ej. 'api', 'cpc', 'social')",
            "example": "openapi"
          },
          "utm_campaign": {
            "type": "string",
            "description": "Nombre de la campaña o iniciativa",
            "example": "lead_directo"
          },
          "utm_content": {
            "type": "string",
            "description": "Contenido específico o variante del enlace"
          },
          "utm_term": {
            "type": "string",
            "description": "Palabras clave asociadas"
          }
        }
      },
      "SuccessResponse": {
        "type": "object",
        "required": [
          "success",
          "message"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "example": true
          },
          "message": {
            "type": "string",
            "example": "Mensaje recibido y enviado con éxito."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "Faltan campos obligatorios: nombre, correo electrónico y mensaje."
          }
        }
      },
      "ToolError": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "Qué argumento corregir y los valores permitidos."
          },
          "alternativa_whatsapp": {
            "type": "string",
            "format": "uri",
            "description": "Enlace de WhatsApp como alternativa."
          }
        }
      }
    }
  }
}