Brazilian CEP using the ViaCEP API

Data & APIs

Looks up address data for a Brazilian CEP using the ViaCEP API.

Install

openclaw skills install cep-lookup

CEP Lookup

Looks up the full address for a Brazilian postal code (CEP) using the public ViaCEP API. No authentication required.

Triggers

Use this skill when the user mentions a CEP in any of these formats:

  • cep 01001-000
  • CEP 20040020
  • details for CEP 30140-110

Output

The skill returns:

  • Street (logradouro)
  • Neighborhood (bairro)
  • City (localidade)
  • State (UF)
  • Complement, if available (complemento)

Error handling

  • Invalid CEP format → usage instruction
  • CEP not found in ViaCEP database → informative message
  • Network failure → generic error message