openapi: 3.1.0
info:
  title: Marra Web — Agentic API
  version: "1.0.0"
  description: |
    Endpoints públicos navegáveis por agentes de IA (ChatGPT Atlas, Claude, Perplexity Comet, etc).
    A Marra Web é uma agência de marketing digital brasileira com +23 anos.
  contact:
    name: Marra Web
    url: https://www.marraweb.com.br
    email: contato@marraweb.com.br
servers:
  - url: https://www.marraweb.com.br
paths:
  /:
    get:
      operationId: getHome
      summary: Página principal com catálogo de serviços
      responses:
        "200": { description: HTML da home }
  /franquia/{cidade}/{servico}:
    get:
      operationId: getServiceByCity
      summary: Página de serviço otimizada por cidade brasileira
      parameters:
        - in: path
          name: cidade
          required: true
          schema: { type: string }
          example: joinville
        - in: path
          name: servico
          required: true
          schema: { type: string }
          example: seo-avancado
      responses:
        "200": { description: HTML da página cidade × serviço }
  /blog:
    get:
      operationId: listBlog
      summary: Lista de artigos do blog
      responses:
        "200": { description: HTML do índice do blog }
  /contato:
    get:
      operationId: getContact
      summary: Página de contato com formulário e canais
      responses:
        "200": { description: HTML de contato }
x-agent-actions:
  contact_whatsapp:
    description: Iniciar conversa no WhatsApp com mensagem pré-preenchida
    url_template: "https://wa.me/5508001300033?text={message}"
    method: GET
    confirmation_required: true
