Autocomplete de moradas para lojas online em Portugal

Sugere a rua enquanto o cliente escreve e devolve o código postal exato (CP7) para a etiqueta de envio. Grátis, sem chave de API.

Para lojas online, checkouts e sistemas de envio — via API ou widget JS; plugin para WooCommerce em breve no wordpress.org. Para agentes de IA — via MCP.

CP7

estrada malveira da serra 920 av liberdade lisboa 196 1000-098 sao joao estoril

Porque é que isto importa

O cliente desiste do pedido

Escrever uma morada completa à mão — rua, número de porta, código postal de 7 dígitos — é onde muitos checkouts param.

A encomenda vai para o sítio errado

Uma gralha na rua ou no código postal manda o estafeta para a morada errada. A encomenda volta, o cliente fica insatisfeito e a entrega paga-se duas vezes.

O Moradas resolve as duas

O cliente escolhe a morada nas sugestões e o código postal é preenchido com exatidão. O pedido conclui-se e a encomenda chega.

Integração em minutos

Tem um agente de IA? Peça-lhe.

Claude, Cursor, ChatGPT ou outro agente liga o Moradas ao seu checkout sozinho — a documentação e o servidor MCP foram feitos para serem lidos por máquinas. Copie o pedido e cole no seu agente:

Liga o autocomplete de moradas do Moradas (moradas.dev) ao checkout da minha loja. Documentação: https://moradas.dev/docs — servidor MCP: https://moradas.dev/mcp
O mesmo servidor MCP dá ao seu agente as moradas e os códigos postais como ferramentas.

Ou à sua maneira

API REST sem chave e widget JS para qualquer formulário; plugin para WooCommerce em breve no wordpress.org. Exemplos prontos a copiar em curl, JavaScript, PHP, Python e C# na documentação.

Ver documentação →

Perguntas frequentes

O que é o Moradas?

Um serviço gratuito de autocomplete de moradas e códigos postais (CP7) de Portugal para checkouts, formulários e sistemas de envio. Sugere a rua enquanto se escreve e devolve o código postal exato pelo número de porta.

É mesmo grátis? Preciso de chave de API?

Sim, é grátis, incluindo uso comercial, e não precisa de chave. Há um limite de utilização razoável por IP para proteger o serviço.

Funciona com WooCommerce?

O plugin para WooCommerce chega em breve ao wordpress.org. Até lá, o widget JS liga-se ao checkout clássico com um pequeno snippet — veja Autocomplete de moradas no WooCommerce. Noutras plataformas, use a API REST ou o widget JS em qualquer formulário onde possa incluir um script.

Como obtém o código postal exato?

Em Portugal uma rua pode ter vários códigos postais, por troços e paridade dos números. O Moradas escolhe o CP7 pelo número de porta; quando não é possível, mostra os troços para escolher.

Serve como alternativa ao GeoAPI.pt?

Sim. A consulta por código postal devolve localidade, concelho e distrito, e a pesquisa de ruas com número de porta é adicional. Veja Alternativa ao GeoAPI.pt.

Os dados dos clientes ficam guardados?

Não. O serviço não usa cookies nem guarda dados pessoais — só contagens agregadas de utilização.