A BNCC inteira em uma API pública, gratuita e auditável

A Base Nacional Comum Curricular inteira em uma API pública e gratuita. Dado curricular é público: tem que estar à disposição de quem constrói.

Abrir bncc.api.br Ver no GitHub

1.703

habilidades da BNCC

etapas de ensino cobertas

MIT

licença, código aberto

O problema

Quem constrói software para educação no Brasil precisa da BNCC — e ela mora em PDFs de centenas de páginas. Cada edtech, cada sistema de gestão e cada secretaria acaba refazendo a mesma extração, do zero, com o mesmo risco de erro.

O que existia de pronto era pago, incompleto ou fechado. Dado curricular é público por natureza: quem paga por ele já pagou uma vez, via imposto.

O que o produto faz

As três etapas completas: Educação Infantil, Fundamental e Médio
1.703 habilidades, 10 competências gerais e a taxonomia oficial inteira
As 140 habilidades do Complemento de Computação, com seus três eixos
Busca semântica com IA, além dos filtros determinísticos
Documentação automática em Swagger e ReDoc, mais um guia para quem não é da área técnica
Portal de contas e chaves de API, com limite de uso por chave
Licença MIT: dá para clonar, auditar e rodar por conta própria

Arquitetura e decisões

API

Python 3.11
FastAPI
Pydantic v2

Dados

SQLAlchemy 2.0 async
Alembic
PostgreSQL

Busca

ChromaDB
sentence-transformers
Gemini ou OpenAI

Segurança

JWT
Argon2
Rate limiting
Chaves com hash

Web

Jinja2
Tailwind CSS
Swagger
ReDoc

Infra

Cloud Run
Docker
Cloud Build
Firebase Hosting

Extração determinística e versionada, com checksum da fonte

Os dados saem dos PDFs oficiais por um pipeline reprodutível que publica um snapshot único com o checksum de cada documento de origem, mais um script de auditoria que aponta divergências. Qualquer pessoa consegue refazer a extração e chegar ao mesmo arquivo — é isso que separa uma base auditável de uma cópia em que se acredita.

A camada de IA degrada sem derrubar a API

A busca semântica é um extra. Se o provedor de IA cair, os endpoints determinísticos continuam servindo normalmente. Uma API pública gratuita não pode ficar de pé apenas enquanto uma dependência externa colaborar.

Contas de operação publicadas na home

A página inicial mostra o valor real cobrado pelo Google Cloud e o volume de requisições atendidas, atualizados sozinhos. Se o projeto pede apoio para se manter público, quem apoia tem o direito de ver a conta antes.

Cloud Run atrás do Firebase Hosting

A API roda em contêiner no Cloud Run na região de São Paulo, com o Firebase Hosting na frente cuidando de domínio e borda. Escala a zero quando ninguém chama, o que é o que torna um serviço gratuito sustentável de manter no ar.

Onde está hoje

No ar, aberto e mantido como bem público. Código sob licença MIT, cobertura de testes exigida no pipeline, análise de segurança automatizada e canal aberto para reportar divergência em relação ao documento oficial.

Ver funcionando em bncc.api.br

Precisa de algo assim na sua operação?

Se você tem escola, comece pelo diagnóstico gratuito para entender o momento atual. Se é empresa ou startup, chame no WhatsApp e me conte o contexto.

Diagnóstico gratuito em 3 min Falar no WhatsApp

Quer ver os outros? Volte para a lista de produtos