A BNCC como dependência: npm install @bncc/dados

As 1.721 aprendizagens da Base e do complemento de Computação, verificadas contra os documentos oficiais, com a fonte dentro de cada registro. Instale, conecte por MCP ou chame a API REST.

0 API keys 0 cadastros CC BY 4.0 dados MIT código

$ npm install @bncc/dados

import { porCodigo, buscar } from '@bncc/dados';

porCodigo('EF67LP08').texto
// "Identificar os efeitos de sentido devidos à escolha de ima…"

buscar('frações', { etapa: 'EF', ano: 5 })
// [EF05MA03, EF05MA04] · tipado, offline, zero rede

$ pip install bncc

import bncc

bncc.por_codigo('EF67LP08')['texto']
bncc.buscar('frações', etapa='EF', ano=5)

bncc.para_dataframe()
# tudo num DataFrame pandas, pronto para análise

# remoto: cole a URL no Claude, ChatGPT ou Cursor
https://mcp.bncc.dev/mcp

# local, offline e sem limite de requisições:
{ "mcpServers": { "bncc":
    { "command": "npx", "args": ["-y", "@bncc/mcp"] } } }

# Seu agente passa a consultar a BNCC real
# em vez de alucinar códigos.

$ curl https://api.bncc.dev/v1/aprendizagens/EF67LP08

$ curl 'https://api.bncc.dev/v1/busca?q=frações&etapa=EF&ano=5'

$ curl https://api.bncc.dev/v1/openapi.json
# JSON com CORS aberto · OpenAPI publicada · sem key

$ git clone https://github.com/bncc-dev/bncc-dados

dados/           # JSON canônicos · CC BY 4.0
derivados/       # CSVs e SQL prontos para uso
pipeline/        # extração reprodutível, roda em CI
DECISOES.md      # cada interpretação, documentada

Uma fonte, cinco interfaces

O dado é o mesmo em todas: escolha pela sua stack. Nenhuma exige key, cadastro ou aceite de termos.

@bncc/dadosnpm · TypeScript Node e browser: dados embutidos no bundle, consultas prontas (porCodigo, buscar, decodificar) e tipos completos. Sem chamadas de rede. bnccPyPI · Python Notebooks e pipelines: dicionários Python e para_dataframe() para quem vive no pandas. mcp.bncc.devMCP · agentes de IA Claude, ChatGPT, Cursor e afins: sete ferramentas de consulta, remoto (cole a URL) ou local (npx); o agente responde com dados reais em vez de inventar códigos. api.bncc.devREST · qualquer stack Sem instalar nada: JSON com CORS aberto, OpenAPI publicada, hospedada na borda. bncc-dadosGitHub · fonte canônica Auditoria e ETL: os JSON canônicos, CSVs e SQL derivados, o pipeline de extração e o histórico de decisões.

O modelo de dados

Todo código de aprendizagem é decomponível; decodificar() faz isso em código. E vale a regra de ouro: se um código não está nos dados, ele não existe na BNCC (a numeração oficial tem lacunas legítimas).

EFetapa

67bloco de anos

LPcomponente

08sequência

EF · 67 · LP · 08

As três etapas têm formatos distintos por definição, e o schema modela cada um deles, mais o complemento de Computação como documento próprio com vigência:

EI02TS01

Educação Infantil

objetivos por campo de experiências e grupo etário

EF67LP08

Ensino Fundamental

habilidades por componente e ano, com objetos de conhecimento

EM13LGG103

Ensino Médio

habilidades por área, sem seriação, ligadas a competências

EF06CO02

Computação

complemento de 2022, por eixo, com vigência própria

// GET api.bncc.dev/v1/aprendizagens/EF06CO02 · registro real, resumido
{
  "codigo": "EF06CO02",
  "texto": "Elaborar algoritmos que envolvam instruções sequenciais,
           de repetição e de seleção usando uma linguagem de programação.",
  "documento": "computacao-2022",
  "anos": [6],
  "vigencia": { "status": "vigente", "desde": "dados-2026.07" },
  "fonte": {
    "arquivo": "anexo-ao-parecer-cneceb-no-2-2022-bncc-computacao.pdf",
    "localizador_pdf": "página PDF 42"
  }
}

Garantias de engenharia

Confiança aqui não é adjetivo, é infraestrutura: cada afirmação abaixo corresponde a um artefato público que você pode inspecionar.

1.721aprendizagens

100%com fonte citável (arquivo + página)

1.576 + 141textos idênticos aos PDFs oficiais

2licenças abertas · CC BY 4.0 + MIT

Extração reprodutível: o pipeline é público e a reprodutibilidade é um teste que roda em CI a cada mudança.
Fonte em cada registro: todo objeto carrega fonte com o arquivo oficial e o localizador da página.
Decisões registradas: toda decisão de interpretação sobre as fontes oficiais vira entrada em DECISOES.md, com justificativa.
Versionamento previsível: semver para o schema, data-version para o conteúdo (dados-2026.07). Mudanças do CNE são evoluções esperadas, não quebras.
Licenças abertas de verdade: CC BY 4.0 nos dados, MIT no código.

Regra de ouro, por escrito: dados, pacotes e servidor MCP são abertos e livres, sem key. Nada sai da coluna aberta para uma comercial: o compromisso está no repositório.

Construindo com IA

O site inteiro foi desenhado para ser lido por modelos, não só por gente. Se você constrói com Lovable, Replit ou Claude Code, aponte a IA para cá.

llms.txt e llms-full.txt: índice e conteúdo completo na spec que os modelos já conhecem: bncc.dev/llms.txt
Toda página de aprendizagem tem versão .md: troque a barra final por .md e receba markdown limpo: bncc.dev/habilidade/EF67LP08.md
MCP como cidadão de primeira classe: cole mcp.bncc.dev/mcp no seu cliente (ou rode local com npx -y @bncc/mcp) e seu agente consulta em vez de alucinar.

prompt-para-seu-builder.txt

Use os dados de bncc.dev como única fonte das habilidades da BNCC. Nunca invente códigos nem enunciados: consulte a API api.bncc.dev/v1 ou o pacote npm @bncc/dados. Linke cada habilidade citada para bncc.dev/habilidade/{codigo}.

Como atribuir

A licença CC BY 4.0 pede só uma coisa: atribuição. Uma linha resolve, no rodapé ou no seu "sobre":

Dados da BNCC por <a href="https://bncc.dev">bncc.dev</a> (CC BY 4.0),
a partir dos documentos oficiais do MEC e do CNE.