# API da Lista de Agências

API JSON para consultar o diretório de agências digitais do Brasil e enviar pedidos de orçamento. Os dados e as regras de visibilidade são os mesmos do site.

Página: https://www.listadeagencias.com.br/api/docs
Especificação OpenAPI 3.1: https://www.listadeagencias.com.br/api/v1/openapi.json

## Acesso

A API é oferecida mediante contratação (fale com fale@maturidade.digital). Todo endpoint, exceto a especificação OpenAPI, exige `Authorization: Bearer {token}`; sem token, a resposta é 401. O token libera os campos restritos da agência (site, LinkedIn, Instagram e entidades associadas). E-mail, telefone e WhatsApp de agência nunca aparecem, com ou sem token. Condições de uso: [termos de uso](https://www.listadeagencias.com.br/termos.md).

## Endpoints

Base: `https://www.listadeagencias.com.br/api/v1`

- `GET /agencies`: agências publicadas, 24 por página (`per_page` de 1 a 50). Filtros: `q`, `category`, `service`, `state` (UF), `city` (slug), `platform`, `member` e `page`.
- `GET /agencies/{slug}`: perfil de uma agência, com serviços e plataformas parceiras.
- `GET /services` e `GET /services/{slug}`: serviços digitais, com o conteúdo completo e as perguntas frequentes no detalhe.
- `GET /categories`: as 5 categorias de serviço.
- `GET /states`: UFs com agências publicadas.
- `POST /quote-requests`: envia um pedido de orçamento. Responde 202; o pedido fica pendente até a confirmação pelo link enviado ao e-mail informado.

Valores aceitos em `platform`: nuvemshop, loja-integrada, magazord, tray, edrone, shopify, rd-station. `member=true` traz só agências membro da Lista de Agências (selo pago de destaque).

## Limites

- Leitura: 60 requisições por minuto por conta (ou por IP).
- Token inválido ou expirado: 30 tentativas por minuto por IP.
- Pedidos de orçamento: 5 requisições de POST a cada 10 minutos por IP e até 3 pedidos aceitos a cada 10 minutos por IP, somando site, API e MCP.

As respostas trazem `X-RateLimit-Limit` e `X-RateLimit-Remaining`. Ao passar do limite, 429 com `Retry-After`.

## Servidor MCP

O servidor MCP em https://www.listadeagencias.com.br/mcp (streamable HTTP) responde sem token, com os dados públicos do diretório, e aceita pedidos de orçamento pela tool `submit_quote_request`. Descoberta em https://www.listadeagencias.com.br/.well-known/mcp.json; o passo a passo do pedido está em [orcamento.md](https://www.listadeagencias.com.br/orcamento.md).