> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-noaa-mar-900-create-self-partnership-provisioning.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Raspar

<div id="interactions">
  ## Interações
</div>

Para interações no navegador (clicar, digitar, navegar, extrair conteúdo dinâmico), use o [endpoint Interact](/pt-BR/features/interact). Primeiro, faça o scraping da página e, em seguida, chame `POST /v2/scrape/{scrapeId}/interact` com um prompt em linguagem natural ou código Playwright para executar ações na página.

Consulte a [documentação do Interact](/pt-BR/features/interact) para ver todos os detalhes e exemplos.

Opcionalmente, você também pode usar o parâmetro `actions`, embora ele não seja recomendado para interações complexas.

> Você é um agente de IA que precisa de uma API key do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para instruções de onboarding automatizado.


## OpenAPI

````yaml /pt-BR/api-reference/v2-openapi.json POST /scrape
openapi: 3.0.0
info:
  title: Firecrawl API
  version: v2
  description: >-
    API para interagir com os serviços do Firecrawl e executar tarefas de web
    scraping e crawling.
  contact:
    name: Firecrawl Support
    url: https://firecrawl.dev/support
    email: support@firecrawl.dev
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /scrape:
    post:
      tags:
        - Scraping
      summary: >-
        Fazer scraping de uma única URL e, opcionalmente, extrair informações
        usando um LLM
      operationId: scrapeAndExtractFromUrl
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
                - type: object
                  properties:
                    url:
                      type: string
                      format: uri
                      description: URL a ser raspada
                  required:
                    - url
                - $ref: '#/components/schemas/ScrapeOptions'
                - type: object
                  properties:
                    zeroDataRetention:
                      type: boolean
                      default: false
                      description: >-
                        Se definido como true, isso ativará a retenção zero de
                        dados para este scrape. Para habilitar esse recurso,
                        entre em contato com help@firecrawl.dev
      responses:
        '200':
          description: Resposta bem-sucedida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScrapeResponse'
        '402':
          description: Pagamento necessário
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Payment required to access this resource.
        '429':
          description: Muitas requisições
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
        '500':
          description: Erro no servidor
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  code:
                    type: string
                    example: UNKNOWN_ERROR
                  error:
                    type: string
                    example: An unexpected error occurred on the server.
      security:
        - bearerAuth: []
components:
  schemas:
    ScrapeOptions:
      type: object
      properties:
        formats:
          $ref: '#/components/schemas/Formats'
        onlyMainContent:
          type: boolean
          description: >-
            Retorne apenas o conteúdo principal da página, excluindo cabeçalhos,
            menus de navegação, rodapés etc. Este é um filtro determinístico em
            nível de HTML aplicado antes da geração do markdown; nenhum LLM é
            usado.
          default: true
        onlyCleanContent:
          type: boolean
          description: >-
            Beta. Executa uma etapa adicional baseada em LLM sobre o markdown
            gerado para remover boilerplate residual que `onlyMainContent` pode
            não detectar (banners de cookies, blocos de anúncios, widgets de
            compartilhamento em redes sociais, breadcrumbs, inscrições em
            newsletters, seções de comentários, listas de artigos relacionados).
            Títulos, listas, tabelas, blocos de código, referências de imagem e
            links inline são preservados. Pode ser combinado com
            `onlyMainContent` (a configuração mais comum) ou usado por conta
            própria. É ignorado com um aviso quando o markdown excede o limite
            de tokens de resultado do modelo de limpeza (o markdown original é
            preservado). Não é compatível com requests com retenção zero de
            dados.
          default: false
        includeTags:
          type: array
          items:
            type: string
          description: Tags a serem incluídas no resultado.
        excludeTags:
          type: array
          items:
            type: string
          description: Tags a serem excluídas da saída.
        maxAge:
          type: integer
          description: >-
            Retorna uma versão em cache da página se ela for mais recente do que
            essa idade em milissegundos. Se a versão em cache da página for mais
            antiga do que esse valor, a página será novamente coletada. Se você
            não precisa de dados extremamente atualizados, ativar isso pode
            acelerar suas coletas em até 500%. O padrão é 2 dias.
          default: 172800000
        minAge:
          type: integer
          description: >-
            Quando definido, a requisição verifica apenas o cache e nunca aciona
            uma nova extração. O valor está em milissegundos e especifica a
            idade mínima que os dados em cache devem ter. Se houver dados em
            cache correspondentes, eles serão retornados instantaneamente. Se
            nenhum dado em cache for encontrado, será retornado um 404 com o
            código de erro SCRAPE_NO_CACHED_DATA. Defina como 1 para aceitar
            qualquer dado em cache, independentemente da idade.
        headers:
          type: object
          description: >-
            Cabeçalhos a serem enviados na requisição. Podem ser usados para
            enviar cookies, user-agent etc.
        waitFor:
          type: integer
          description: >-
            Defina um atraso, em milissegundos, antes de buscar o conteúdo,
            permitindo que a página tenha tempo suficiente para carregar. Esse
            tempo de espera é somado ao recurso de espera inteligente do
            Firecrawl.
          default: 0
        mobile:
          type: boolean
          description: >-
            Defina como true se quiser emular a extração a partir de um
            dispositivo móvel. Útil para testar páginas responsivas e capturar
            screenshots da versão mobile.
          default: false
        skipTlsVerification:
          type: boolean
          description: Ignorar a verificação de certificado TLS ao realizar requisições.
          default: true
        timeout:
          type: integer
          description: >-
            Tempo limite, em milissegundos, para a solicitação. O mínimo é 1000
            (1 segundo). O padrão é 60000 (60 segundos). O máximo é 300000 (300
            segundos).
          default: 60000
          minimum: 1000
          maximum: 300000
        parsers:
          type: array
          description: >-
            Controla como os arquivos são processados durante o scraping. Quando
            "pdf" é incluído (padrão), o conteúdo do PDF é extraído e convertido
            em markdown, com cobrança baseada no número de páginas (1 crédito
            por página). Quando um array vazio é fornecido, o arquivo PDF é
            retornado em codificação base64 com uma taxa fixa de 1 crédito para
            todo o PDF.
          items:
            oneOf:
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - pdf
                  mode:
                    type: string
                    enum:
                      - fast
                      - auto
                      - ocr
                    default: auto
                    description: >-
                      Modo de processamento de PDFs. "fast": extração apenas
                      baseada em texto (usa o texto embutido, mais rápido).
                      "auto" (padrão): tenta primeiro a extração rápida e, se
                      necessário, recorre ao OCR. "ocr": força o processamento
                      via OCR em todas as páginas.
                  maxPages:
                    type: integer
                    minimum: 1
                    maximum: 10000
                    description: >-
                      Número máximo de páginas do PDF a serem processadas. Deve
                      ser um inteiro positivo de até 10.000.
                required:
                  - type
                additionalProperties: false
          default:
            - pdf
        actions:
          type: array
          description: Ações a serem executadas na página antes de extrair o conteúdo
          items:
            oneOf:
              - title: Wait
                oneOf:
                  - type: object
                    title: Wait by Duration
                    properties:
                      type:
                        type: string
                        enum:
                          - wait
                        description: Esperar um número específico de milissegundos
                      milliseconds:
                        type: integer
                        minimum: 1
                        description: Número de milissegundos a esperar
                    required:
                      - type
                      - milliseconds
                    additionalProperties: false
                  - type: object
                    title: Wait for Element
                    properties:
                      type:
                        type: string
                        enum:
                          - wait
                        description: Esperar até que um elemento específico apareça
                      selector:
                        type: string
                        description: Seletor CSS do elemento a esperar
                        example: '#my-element'
                    required:
                      - type
                      - selector
                    additionalProperties: false
              - type: object
                title: Screenshot
                properties:
                  type:
                    type: string
                    enum:
                      - screenshot
                    description: >-
                      Faça uma captura de tela. Os links estarão no array
                      `actions.screenshots` da resposta.
                  fullPage:
                    type: boolean
                    description: >-
                      Define se a captura de tela deve abranger a página inteira
                      (ignorando viewport.height) ou se deve ser limitada à
                      viewport atual.
                    default: false
                  quality:
                    type: integer
                    description: >-
                      A qualidade da captura de tela, de 1 a 100, onde 100 é a
                      mais alta qualidade.
                  viewport:
                    type: object
                    properties:
                      width:
                        type: integer
                        description: Largura da viewport em pixels
                      height:
                        type: integer
                        description: A altura da viewport, em pixels
                    required:
                      - width
                      - height
                required:
                  - type
              - type: object
                title: Click
                properties:
                  type:
                    type: string
                    enum:
                      - click
                    description: Clique em um elemento
                  selector:
                    type: string
                    description: Seletor para encontrar o elemento por
                    example: '#load-more-button'
                  all:
                    type: boolean
                    description: >-
                      Clica em todos os elementos que correspondem ao seletor,
                      não apenas no primeiro. Não lança um erro se nenhum
                      elemento corresponder ao seletor.
                    default: false
                required:
                  - type
                  - selector
              - type: object
                title: Write text
                properties:
                  type:
                    type: string
                    enum:
                      - write
                    description: >-
                      Digite o texto em um campo de entrada, área de texto ou
                      elemento com conteúdo editável. Observação: primeiro é
                      preciso colocar o foco no elemento usando uma ação de
                      “clique” antes de escrever. O texto será digitado
                      caractere por caractere para simular a entrada pelo
                      teclado.
                  text:
                    type: string
                    description: Texto a ser digitado
                    example: Hello, world!
                required:
                  - type
                  - text
              - type: object
                title: Press a key
                description: >-
                  Pressione qualquer tecla na página. Consulte
                  https://asawicki.info/nosense/doc/devices/keyboard/key_codes.html
                  para ver os códigos de tecla.
                properties:
                  type:
                    type: string
                    enum:
                      - press
                    description: Pressione qualquer tecla na página
                  key:
                    type: string
                    description: Tecla para pressionar
                    example: Enter
                required:
                  - type
                  - key
              - type: object
                title: Scroll
                properties:
                  type:
                    type: string
                    enum:
                      - scroll
                    description: Rolar a página ou um elemento específico
                  direction:
                    type: string
                    enum:
                      - up
                      - down
                    description: Sentido da rolagem
                    default: down
                  selector:
                    type: string
                    description: Seletor (query selector) do elemento a ser rolado
                    example: '#my-element'
                required:
                  - type
              - type: object
                title: Scrape
                properties:
                  type:
                    type: string
                    enum:
                      - scrape
                    description: Raspa o conteúdo da página atual e retorna a URL e o HTML.
                required:
                  - type
              - type: object
                title: Execute JavaScript
                properties:
                  type:
                    type: string
                    enum:
                      - executeJavascript
                    description: Executar código JavaScript na página
                  script:
                    type: string
                    description: Código JavaScript para executar
                    example: document.querySelector('.button').click();
                required:
                  - type
                  - script
              - type: object
                title: Generate PDF
                properties:
                  type:
                    type: string
                    enum:
                      - pdf
                    description: >-
                      Gerar um PDF da página atual. O PDF será retornado no
                      array `actions.pdfs` da resposta.
                  format:
                    type: string
                    enum:
                      - A0
                      - A1
                      - A2
                      - A3
                      - A4
                      - A5
                      - A6
                      - Letter
                      - Legal
                      - Tabloid
                      - Ledger
                    description: O tamanho da página do PDF gerado
                    default: Letter
                  landscape:
                    type: boolean
                    description: Se o PDF deve ser gerado em orientação horizontal
                    default: false
                  scale:
                    type: number
                    description: O fator de escala do PDF gerado
                    default: 1
                required:
                  - type
        location:
          type: object
          description: >-
            Configurações de localização da requisição. Quando definidas, será
            usado um proxy apropriado, se disponível, e serão emuladas as
            configurações correspondentes de idioma e fuso horário. O padrão é
            "US" se não for especificado.
          properties:
            country:
              type: string
              description: >-
                Código de país ISO 3166-1 alpha-2 (por exemplo, "US", "AU",
                "DE", "JP")
              pattern: ^[A-Z]{2}$
              default: US
            languages:
              type: array
              description: >-
                Idiomas e localidades preferidos para a requisição, em ordem de
                prioridade. Por padrão, usa o idioma da localização
                especificada. Consulte
                https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
              items:
                type: string
                example: en-US
        removeBase64Images:
          type: boolean
          description: >-
            Remove todas as imagens em base64 do resultado em markdown, que pode
            se tornar excessivamente longo. Isso não afeta os formatos html nem
            rawHtml. O texto alternativo da imagem permanece no resultado, mas a
            URL é substituída por um placeholder.
          default: true
        blockAds:
          type: boolean
          description: Habilita o bloqueio de anúncios e de pop-ups de cookies.
          default: true
        proxy:
          type: string
          enum:
            - basic
            - enhanced
            - auto
          description: |-
            Especifica o tipo de proxy a ser utilizado.

             - **basic**: Proxies para scraping de sites sem soluções anti‑bot ou apenas com soluções anti‑bot básicas. Rápido e geralmente funciona.
             - **enhanced**: Proxies avançados para scraping de sites com soluções anti‑bot avançadas. Mais lento, porém mais confiável em alguns sites. Pode custar até 5 créditos por requisição.
             - **auto**: O Firecrawl tentará automaticamente refazer o scraping com proxies enhanced se o proxy basic falhar. Se a nova tentativa com enhanced for bem-sucedida, 5 créditos serão cobrados pelo scraping. Se a primeira tentativa com basic for bem-sucedida, apenas o custo regular será cobrado.
          default: auto
        storeInCache:
          type: boolean
          description: >-
            Se definido como true, a página será armazenada no índice e no cache
            do Firecrawl. Definir isso como false é útil se sua atividade de
            scraping puder levantar preocupações relacionadas à proteção de
            dados. O uso de alguns parâmetros associados a scraping sensível
            (por exemplo, ações, headers) fará com que esse parâmetro seja
            definido automaticamente como false.
          default: true
        lockdown:
          type: boolean
          description: >-
            Se verdadeiro, atende à requisição apenas a partir do cache do
            Firecrawl e nunca faz uma solicitação externa para a URL de destino.
            Projetado para ambientes com restrições de conformidade ou isolados
            da rede, nos quais a própria requisição de scraping poderia expor
            informações sensíveis. Em caso de cache miss, retorna 404 com o
            código de erro SCRAPE_LOCKDOWN_CACHE_MISS (a URL nunca é registrada
            em caso de miss). As requisições de lockdown são tratadas com
            retenção zero de dados. O maxAge padrão é estendido para 2 anos,
            para que páginas já armazenadas em cache continuem elegíveis. São
            cobrados 5 créditos em caso de hit e 1 crédito em caso de cache
            miss.
          default: false
        profile:
          type: object
          description: >-
            Ative o armazenamento persistente do navegador em sessões de
            scraping e interação. Informe um perfil ao fazer scraping para
            preservar cookies, localStorage e dados de sessão. Sessões com o
            mesmo nome de perfil compartilham o estado do navegador.
          properties:
            name:
              type: string
              minLength: 1
              maxLength: 128
              description: >-
                Um nome para o perfil. Scrapings com o mesmo nome compartilham o
                estado do navegador (cookies, localStorage, sessões).
            saveChanges:
              type: boolean
              default: true
              description: >-
                Quando verdadeiro, o estado do navegador é salvo de volta no
                perfil quando a sessão de interação é encerrada. Defina como
                falso para carregar dados existentes sem gravar. Apenas uma
                sessão de salvamento é permitida por vez.
          required:
            - name
    ScrapeResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            markdown:
              type: string
            summary:
              type: string
              nullable: true
              description: Resumo da página se `summary` constar em `formats`
            html:
              type: string
              nullable: true
              description: >-
                HTML limpo da página, se `html` estiver incluído em `formatos`.
                Remove as tags `<script>`, `<style>`, `<noscript>`, `<meta>` e
                `<head>`; converte URLs relativas em absolutas; resolve o
                `srcset` de imagens responsivas para a versão de maior
                resolução. Respeita os filtros `onlyMainContent`, `includeTags`
                e `excludeTags`.
            rawHtml:
              type: string
              nullable: true
              description: >-
                O HTML exato, sem modificações, recebido da página quando
                `rawHtml` está em `formats`. Nenhuma limpeza ou filtragem é
                realizada.
            screenshot:
              type: string
              nullable: true
              description: >-
                Captura de tela da página se `screenshot` estiver incluído em
                `formats`. As capturas de tela expiram após 24 horas e não
                poderão mais ser baixadas.
            audio:
              type: string
              nullable: true
              description: >-
                URL assinada para o arquivo de áudio MP3 extraído, se `audio`
                estiver em `formatos`. A URL assinada expira em 1 hora.
            video:
              type: string
              nullable: true
              description: >-
                URL assinada para o arquivo de vídeo extraído, se `video`
                estiver em `formatos`. A URL assinada expira após 1 hora.
            answer:
              type: string
              nullable: true
              description: >-
                Resposta em linguagem natural à pergunta fornecida pelo formato
                `question`. Presente apenas se um objeto de formato `question`
                tiver sido incluído em `formats`.
            highlights:
              type: string
              nullable: true
              description: >-
                Texto-fonte relevante selecionado pelo formato `highlights`.
                Presente apenas se um objeto de formato `highlights` tiver sido
                incluído em `formats`.
            links:
              type: array
              items:
                type: string
              description: Lista de links da página se `links` estiver em `formatos`
            actions:
              type: object
              nullable: true
              description: >-
                Resultados das ações especificadas no parâmetro `actions`. Só
                estará presente se o parâmetro `actions` tiver sido fornecido na
                requisição
              properties:
                screenshots:
                  type: array
                  description: >-
                    URLs das capturas de tela, na mesma ordem das ações de
                    captura de tela fornecidas.
                  items:
                    type: string
                    format: url
                scrapes:
                  type: array
                  description: >-
                    Extraia o conteúdo na mesma ordem das ações de scraping
                    fornecidas.
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                      html:
                        type: string
                javascriptReturns:
                  type: array
                  description: >-
                    Valores de retorno em JavaScript, na mesma ordem das ações
                    executeJavascript fornecidas.
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      value: {}
                pdfs:
                  type: array
                  description: PDFs gerados, na mesma ordem das ações de PDF especificadas.
                  items:
                    type: string
            metadata:
              type: object
              properties:
                title:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Título extraído da página; pode ser uma string ou um array
                    de strings
                description:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Descrição extraída da página, que pode ser uma string ou um
                    array de strings
                language:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  nullable: true
                  description: >-
                    Idioma detectado na página; pode ser uma string ou um array
                    de strings
                sourceURL:
                  type: string
                  format: uri
                  description: >-
                    A URL original solicitada. Pode ser diferente da URL final
                    da página se houver redirecionamentos.
                url:
                  type: string
                  format: uri
                  description: >-
                    A URL final da página após seguir todos os
                    redirecionamentos.
                keywords:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Palavras-chave extraídas da página; pode ser uma string ou
                    um array de strings
                ogLocaleAlternate:
                  type: array
                  items:
                    type: string
                  description: Localidades alternativas para a página
                '<any other metadata> ':
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Outros metadados extraídos do HTML. Pode ser uma string ou
                    um array de strings
                statusCode:
                  type: integer
                  description: O código de status da página
                contentType:
                  type: string
                  description: >-
                    O tipo de conteúdo (MIME) da página, por exemplo, text/html,
                    application/pdf
                error:
                  type: string
                  nullable: true
                  description: Mensagem de erro da página
                concurrencyLimited:
                  type: boolean
                  description: >-
                    Se este scraping foi limitado devido aos limites de
                    concorrência da equipe
                concurrencyQueueDurationMs:
                  type: number
                  description: >-
                    Tempo, em milissegundos, que a solicitação aguardou na fila
                    de concorrência. Presente apenas quando concurrencyLimited é
                    true.
            warning:
              type: string
              nullable: true
              description: >-
                Pode ser exibida ao usar Extração com LLM. A mensagem de alerta
                informará sobre quaisquer problemas na extração.
            changeTracking:
              type: object
              nullable: true
              description: >-
                Informações de rastreamento de alterações se `changeTracking`
                estiver em `formats`. Somente presente quando o formato
                `changeTracking` for solicitado.
              properties:
                previousScrapeAt:
                  type: string
                  format: date-time
                  nullable: true
                  description: >-
                    O timestamp da raspagem anterior em relação à qual a página
                    atual está sendo comparada. Nulo se não houver raspagem
                    anterior.
                changeStatus:
                  type: string
                  enum:
                    - new
                    - same
                    - changed
                    - removed
                  description: >-
                    O resultado da comparação entre as duas versões da página:
                    'new' indica que esta página não existia antes, 'same'
                    indica que o conteúdo não mudou, 'changed' indica que o
                    conteúdo foi alterado e 'removed' indica que a página foi
                    removida.
                visibility:
                  type: string
                  enum:
                    - visible
                    - hidden
                  description: >-
                    A visibilidade da página/URL atual. "visible" significa que
                    a URL foi descoberta por meio de uma rota orgânica (links ou
                    sitemap); "hidden" significa que a URL foi descoberta a
                    partir da memória de rastreamentos anteriores.
                diff:
                  type: string
                  nullable: true
                  description: >-
                    Diff das alterações no estilo do Git ao usar o modo
                    `git-diff`. Só é retornado quando o modo está definido como
                    `git-diff`.
                json:
                  type: object
                  nullable: true
                  description: >-
                    Resultados da comparação em JSON ao usar o modo `json`.
                    Disponível apenas quando o modo está definido como `json`.
                    Isso gera uma lista de todas as chaves e seus valores das
                    coletas `previous` e `current`, com base no tipo definido no
                    `schema`. Exemplo [aqui](/features/change-tracking)
            branding:
              type: object
              nullable: true
              description: >-
                Informações de branding extraídas da página quando `branding`
                estiver em `formatos`. Inclui cores, fontes, tipografia,
                espaçamento, componentes e muito mais.
              properties:
                colorScheme:
                  type: string
                  enum:
                    - light
                    - dark
                  description: Esquema de cores detectado da página.
                logo:
                  type: string
                  nullable: true
                  description: URL do logotipo principal.
                colors:
                  type: object
                  nullable: true
                  description: Cores da marca extraídas da página.
                  properties:
                    primary:
                      type: string
                      description: Cor principal da marca (hex).
                    secondary:
                      type: string
                      description: Cor secundária da marca (hex).
                    accent:
                      type: string
                      description: Cor de destaque (hex).
                    background:
                      type: string
                      description: Cor de fundo (hex).
                    textPrimary:
                      type: string
                      description: Cor principal do texto (hex).
                    textSecondary:
                      type: string
                      description: Cor secundária do texto (hex).
                    link:
                      type: string
                      description: Cor dos links (hex).
                    success:
                      type: string
                      description: Cor de sucesso/estado positivo (hex).
                    warning:
                      type: string
                      description: Cor de aviso/alerta (hex).
                    error:
                      type: string
                      description: Cor de erro/perigo (hex).
                fonts:
                  type: array
                  nullable: true
                  description: Array de famílias de fontes usadas na página.
                  items:
                    type: object
                    properties:
                      family:
                        type: string
                        description: Nome da família de fontes.
                typography:
                  type: object
                  nullable: true
                  description: Informações detalhadas de tipografia.
                  properties:
                    fontFamilies:
                      type: object
                      description: Famílias de fontes por função.
                      properties:
                        primary:
                          type: string
                          description: Família de fontes primária.
                        heading:
                          type: string
                          description: Família de fontes para títulos (headings).
                        code:
                          type: string
                          description: Família de fontes para código/monoespaçada.
                    fontSizes:
                      type: object
                      description: Tamanhos de fonte para diferentes níveis tipográficos.
                      properties:
                        h1:
                          type: string
                        h2:
                          type: string
                        h3:
                          type: string
                        body:
                          type: string
                    fontWeights:
                      type: object
                      description: Definições de peso da fonte.
                      properties:
                        light:
                          type: integer
                        regular:
                          type: integer
                        medium:
                          type: integer
                        bold:
                          type: integer
                    lineHeights:
                      type: object
                      description: >-
                        Valores de altura de linha para diferentes tipos de
                        texto.
                      properties:
                        heading:
                          type: string
                        body:
                          type: string
                spacing:
                  type: object
                  nullable: true
                  description: Informações de espaçamento e layout.
                  properties:
                    baseUnit:
                      type: integer
                      description: Unidade base de espaçamento (em pixels).
                    borderRadius:
                      type: string
                      description: Raio de borda padrão.
                    padding:
                      type: object
                      description: Valores de padding.
                    margins:
                      type: object
                      description: Valores de margem.
                components:
                  type: object
                  nullable: true
                  description: Estilos de componentes de UI.
                  properties:
                    buttonPrimary:
                      type: object
                      description: Estilos do botão primário.
                      properties:
                        background:
                          type: string
                        textColor:
                          type: string
                        borderRadius:
                          type: string
                    buttonSecondary:
                      type: object
                      description: Estilos de botões secundários.
                      properties:
                        background:
                          type: string
                        textColor:
                          type: string
                        borderColor:
                          type: string
                        borderRadius:
                          type: string
                    input:
                      type: object
                      description: Estilos de campos de input.
                icons:
                  type: object
                  nullable: true
                  description: Estilos de ícones.
                images:
                  type: object
                  nullable: true
                  description: Imagens da marca.
                  properties:
                    logo:
                      type: string
                      description: URL da imagem do logotipo.
                    favicon:
                      type: string
                      description: URL do favicon.
                    ogImage:
                      type: string
                      description: URL da imagem Open Graph.
                animations:
                  type: object
                  nullable: true
                  description: Configurações de animação e transição.
                layout:
                  type: object
                  nullable: true
                  description: Configuração de layout (grid, alturas de cabeçalho/rodapé).
                personality:
                  type: object
                  nullable: true
                  description: >-
                    Traços de personalidade da marca (tom, energia,
                    público-alvo).
    Formats:
      type: array
      items:
        oneOf:
          - type: object
            title: Markdown
            properties:
              type:
                type: string
                enum:
                  - markdown
            required:
              - type
          - type: object
            title: Summary
            properties:
              type:
                type: string
                enum:
                  - summary
            required:
              - type
          - type: object
            title: HTML
            properties:
              type:
                type: string
                enum:
                  - html
            required:
              - type
          - type: object
            title: Raw HTML
            properties:
              type:
                type: string
                enum:
                  - rawHtml
            required:
              - type
          - type: object
            title: Links
            properties:
              type:
                type: string
                enum:
                  - links
            required:
              - type
          - type: object
            title: Images
            properties:
              type:
                type: string
                enum:
                  - images
            required:
              - type
          - type: object
            title: Screenshot
            properties:
              type:
                type: string
                enum:
                  - screenshot
              fullPage:
                type: boolean
                description: >-
                  Define se a captura de tela deve abranger a página inteira
                  (ignorando viewport.height) ou se deve ser limitada à viewport
                  atual.
                default: false
              quality:
                type: integer
                description: >-
                  Qualidade da captura de tela, de 1 a 100. 100 é a qualidade
                  máxima.
              viewport:
                type: object
                properties:
                  width:
                    type: integer
                    description: Largura da viewport em pixels
                  height:
                    type: integer
                    description: Altura da viewport em pixels
                required:
                  - width
                  - height
            required:
              - type
          - type: object
            title: JSON
            properties:
              type:
                type: string
                enum:
                  - json
              schema:
                type: object
                description: >-
                  O esquema a ser usado para a saída em JSON. Deve estar em
                  conformidade com o [JSON Schema](https://json-schema.org/).
              prompt:
                type: string
                description: O prompt a ser usado para gerar a saída em JSON
            required:
              - type
          - type: object
            title: Change Tracking
            properties:
              type:
                type: string
                enum:
                  - changeTracking
              modes:
                type: array
                items:
                  type: string
                  enum:
                    - git-diff
                    - json
                description: >-
                  O modo a ser usado para rastrear alterações. 'git-diff'
                  fornece um diff detalhado e 'json' compara os dados JSON
                  extraídos.
              schema:
                type: object
                description: >-
                  Esquema para extração de JSON ao usar o modo `json`. Define a
                  estrutura dos dados a serem extraídos e comparados. Deve estar
                  em conformidade com o [JSON Schema](https://json-schema.org/).
              prompt:
                type: string
                description: >-
                  Prompt a ser usado para rastreamento de alterações ao usar o
                  modo "json". Caso não seja fornecido, será usado o prompt
                  padrão.
              tag:
                type: string
                nullable: true
                default: null
                description: >-
                  Tag a ser usada para rastreamento de alterações. Tags podem
                  separar o histórico de rastreamento de alterações em
                  “branches” (ramificações) distintas, em que o rastreamento com
                  uma tag específica só vai comparar com coletas feitas na mesma
                  tag. Se não for fornecida, será usada a tag padrão (null).
            required:
              - type
          - type: object
            title: Branding
            properties:
              type:
                type: string
                enum:
                  - branding
            required:
              - type
          - type: object
            title: Audio
            description: >-
              Extrai áudio (MP3) de URLs de vídeo compatíveis, como YouTube.
              Retorna uma URL assinada do GCS.
            properties:
              type:
                type: string
                enum:
                  - audio
            required:
              - type
          - type: object
            title: Video
            description: >-
              Extrai o vídeo com a melhor qualidade de URLs de vídeo
              compatíveis, como YouTube ou TikTok. Retorna uma URL assinada do
              GCS.
            properties:
              type:
                type: string
                enum:
                  - video
            required:
              - type
          - type: object
            title: Question
            description: >-
              Faça uma pergunta em linguagem natural sobre a página. Retorna a
              resposta no campo `answer` da `response`.
            properties:
              type:
                type: string
                enum:
                  - question
              question:
                type: string
                maxLength: 10000
                description: >-
                  A pergunta a ser respondida sobre a página. Máximo de 10.000
                  caracteres.
            required:
              - type
              - question
          - type: object
            title: Highlights
            description: >-
              Encontre texto-fonte relevante na página. Retorna o texto
              selecionado no campo `highlights` da `response`.
            properties:
              type:
                type: string
                enum:
                  - highlights
              query:
                type: string
                maxLength: 10000
                description: >-
                  A consulta de seleção de texto a ser executada na página.
                  Máximo de 10.000 caracteres.
            required:
              - type
              - query
      description: >-
        Formatos de saída que devem ser incluídos na resposta. Você pode
        especificar um ou mais formatos, como strings (por exemplo,
        `'markdown'`) ou como objetos com opções adicionais (por exemplo, `{
        type: 'json', schema: {...} }`). Alguns formatos exigem que opções
        específicas sejam configuradas. Exemplo: `['markdown', { type: 'json',
        schema: {...} }]`.
      default:
        - markdown
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````