SDK TypeScript

npm install @brazilvisible/sdk

import { bcb, ibge } from "@brazilvisible/sdk";
 
// Banco Central — taxa Selic
const selic = await bcb.sgs({ serie: 11, inicio: "2024-01-01", fim: "2024-12-31" });
console.log(selic);
 
// IBGE — dados agregados
const populacao = await ibge.agregados({ tabela: 1301, periodos: "2022", localidades: "N1" });
console.log(populacao);

import { cgu, configure } from "@brazilvisible/sdk";
 
// Opção 1: configuração no código
configure({ apiKeys: { cgu: "sua-chave-aqui" } });
 
// Opção 2: variável de ambiente
// export BV_CGU_API_KEY=sua-chave-aqui
 
const contratos = await cgu.contratos({ orgao: "25000", ano: 2024 });
const sancionadas = await cgu.ceis();

import { cgu } from "@brazilvisible/sdk";
 
// Empresas sancionadas que ainda vencem licitações
const sancionadas = await cgu.ceis();
const contratos = await cgu.contratos({ ano: 2024 });
 
const cnpjsSancionados = new Set(sancionadas.map((s) => s.cnpj));
const irregulares = contratos.filter((c) => cnpjsSancionados.has(c.cnpj));
console.log(`${irregulares.length} contratos com empresas sancionadas`);

import { tse, receita } from "@brazilvisible/sdk";
 
// TSE — candidaturas (baixa ZIP, descompacta, retorna array tipado)
const candidatos = await tse.candidaturas({ ano: 2022, estado: "SP" });
console.log(`${candidatos.length} candidaturas em SP`);
 
// Receita Federal — dados de empresas
const empresas = await receita.empresas({ chunk: 0 });

import { configure } from "@brazilvisible/sdk";
 
configure({
  timeout: 60000,       // timeout em ms (padrão: 30000)
  maxRetries: 5,        // tentativas de retry (padrão: 3)
  apiKeys: {
    cgu: "sua-chave",   // API keys por fonte
  },
});