Comex Stat Brasil — Importação e Exportação por NCM, País, UF e Porto

Desenvolvido e mantido por Guilherme Kodama · GitHub: github.com/guilhermeKodama

Quanto o Brasil importa ou exporta de um produto, de quais países, por quais estados e portos, a que preço — e como isso mudou em relação ao ano passado? Este actor consulta a base oficial do Comex Stat (MDIC/SECEX) e entrega uma tabela pronta por NCM / SH6 / SH4 / capítulo, com US$ FOB, US$ CIF, frete, seguro, kg líquido, quantidade estatística, preço médio US$/kg e US$/unidade, participação por país e variação % contra o mesmo período do ano anterior.

Para quem

• Importadores e distribuidores: de onde o Brasil compra o seu produto e a que preço médio CIF/FOB por unidade.
• Exportadores e tradings: quais países e UFs puxam as vendas, quem cresceu e quem caiu no ano.
• Despachantes, comissárias e consultorias de comex: relatório por NCM e porto (URF) em segundos.
• Indústria e varejo: monitorar a concorrência importada (volume e preço) do seu segmento.
• Analistas e jornalistas: séries mensais oficiais sem planilha manual.

O que entrega

Uma linha por produto × quebra (país, bloco, UF, via, URF) × período: fluxo, periodo, codigoProduto, produto, pais, blocoEconomico, uf, via, urf, fobUsd, kgLiquido, quantidadeEstatistica + unidadeEstatistica (NCM), freteUsd, seguroUsd, cifUsd (importação), precoMedioUsdKg, precoMedioUsdUnidade, participacaoNoProdutoPct, fobUsdAnoAnterior, kgAnoAnterior, precoMedioUsdKgAnoAnterior, variacaoFobPct, variacaoKgPct, variacaoPrecoKgPct, novoNoPeriodo, ultimaCompetenciaDisponivel.

No key-value store, a chave RESUMO traz totais por fluxo, variação anual, top produtos, top países/UFs/portos e avisos.

Diferenciais

• Períodos que cruzam o ano (ex.: últimos 12 meses out→set): a API oficial devolve vazio; o actor divide e soma.
• Comparação automática com o ano anterior (valor, peso e preço médio).
• Preço médio por kg e por unidade estatística (ex.: US$ por smartphone importado).
• Busca de NCM por palavra (productSearch), sem precisar saber o código.
• Modo alerta mensal (onlyIfNewMonth): agende diário; só entrega dados quando o MDIC publica um mês novo.
• Respeita o limite da API pública (pausas e novas tentativas automáticas).

Como usar

• products: códigos com 8 (NCM), 6 (SH6), 4 (SH4) ou 2 (capítulo) dígitos; pontos são ignorados.
• productSearch: termos com acento, ex.: "café", "máquinas automáticas de venda".
• flows: import, export ou os dois. periodFrom/periodTo (AAAA-MM; vazio = últimos 12 meses).
• breakdownBy: country, economicBlock, state, via, urf. monthly: série mês a mês.
• countries (nome PT/EN ou código), ufs, minFobUsd, maxRows, language (pt/en).

Exemplos:

• Smartphones importados por país, 12 meses, com variação anual: {"products":["85171300"],"flows":["import"],"breakdownBy":["country"]}
• Café exportado por país e UF em 2026: {"products":["0901"],"flows":["export"],"breakdownBy":["country","state"],"periodFrom":"2026-01","minFobUsd":1000000}
• Máquinas de venda automática, mês a mês por país e porto: {"productSearch":["máquinas automáticas de venda"],"breakdownBy":["country","urf"],"monthly":true}
• Alerta mensal (agende diário): {"products":["8471"],"flows":["import","export"],"onlyIfNewMonth":true,"stateKey":"informatica"}

Observações honestas

• O Comex Stat publica por mês, em geral na primeira semana do mês seguinte; o mês corrente não existe ainda.
• Dados são agregados: não há nomes de empresas importadoras/exportadoras (o MDIC não divulga por NCM).
• Quantidade estatística e preço por unidade só existem no nível NCM (8 dígitos).
• A "UF do produto" é a UF de origem na exportação e a UF de destino/domicílio do importador na importação (regra do MDIC).

Privacidade (LGPD)

Estatística oficial agregada. Nenhum dado pessoal ou de empresa identificada é coletado.

Fonte

Ministério do Desenvolvimento, Indústria, Comércio e Serviços (MDIC) / SECEX — Comex Stat, API pública https://api-comexstat.mdic.gov.br (site: https://comexstat.mdic.gov.br). Sem chave, sem login.

---

English summary

Brazil official import & export statistics (Comex Stat / MDIC). Query by NCM/HS code (8, 6, 4 or 2 digits) or keyword and get US$ FOB, CIF, freight, insurance, net kg, statistical quantity, average price per kg and per unit, broken down by country, trade bloc, Brazilian state, transport mode and port of clearance (URF), with automatic year-over-year comparison, monthly series, rolling 12-month periods across calendar years, and a monthly alert mode. Aggregated official data — no personal data.