Biblioteca de CEP

Consulta de CEP com fallback automático.

Uma única API para ViaCEP, BrasilAPI, OpenCEP e AwesomeAPI. Quando um serviço cai, a unicep troca para o próximo sozinha e sempre devolve o mesmo objeto.

Instalação

npm install @unicep/core

Exemplo

import { Unicep, defaultProviders } from '@unicep/core';

const unicep = new Unicep({ providers: defaultProviders() });

const address = await unicep.lookup('01310-100');
// { cep: '01310100', street: 'Avenida Paulista', city: 'São Paulo',
//   state: 'SP', provider: 'viacep', ... }

Fallback automático

Tenta os provedores em ordem e devolve sempre o mesmo objeto Address.

Circuit breaker

Detecta serviços instáveis e pula o provedor até ele se recuperar.

Pronta para o seu framework

Core em TypeScript puro, com bindings para React, Vue e Angular.

Feita para agentes

llms.txt, páginas em Markdown e prompts prontos para implementar com IA.