Pular para o conteúdo
GraaosFertilizantes

Referência · Metodologia

Metodologia: como os números são calculados

Atualizado em · dados até

Como o Graaos · Fertilizantes calcula cada número do painel, das páginas e do boletim: só com dados abertos oficiais (Comex Stat/MDIC, Pink Sheet do Banco Mundial e PTAX do BCB), por regras fixas do programa, com o código aberto no GitHub.

Como os números são calculados

  • Preço implícito = valor ÷ toneladas. HHI = soma dos quadrados dos shares por país de origem (0 a 10.000). Anos parciais são comparados com os mesmos meses do ano anterior.
  • Rotas: país de origem → URF de desembaraço, por ano. Na tabela de frete entram as rotas com pelo menos 50 mil t no ano (proporcional aos meses num ano parcial); a lista completa está em data/processed/rotas_ano.csv.
  • Relação de troca = preço CIF do fertilizante importado (KCl NCM 31042090, ureia 31021010, MAP 31054000) ÷ preço FOB da soja em grão exportada (NCM 12019000) no mesmo mês; média histórica = média simples dos meses da série. É medida no porto, não é o preço ao produtor.
  • Brasil x mercado internacional: preço implícito do Brasil (KCl NCM 31042090, ureia 31021010, MAP 31054000, DAP 310530, TSP 31031030 e 31031100) contra a Pink Sheet do Banco Mundial (CC BY 4.0); o MAP usa o DAP como referência. Spread comparável = FOB Brasil − benchmark quando o benchmark é FOB; CIF Brasil − benchmark quando ele é um preço no destino. CIF em reais pela PTAX venda média do mês (BCB, SGS 3698, ODbL).
  • Mapa: pontos gerados a partir do Natural Earth 1:110m (domínio público), em projeção equirretangular.
  • Custo por nutriente = preço CIF ÷ teor do nutriente no grau comercial usual (ureia 46% de N, sulfato de amônio 21% de N, nitrato de amônio 34% de N, MAP 11-52, DAP 18-46, TSP 46% de P₂O₅, KCl 60% de K₂O); no MAP e no DAP, o N é descontado pelo custo do N da ureia no mesmo mês. Em reais pela PTAX venda média do mês. A tabela completa está em data/processed/custo_nutriente_mensal.csv.
  • Insumos do fósforo (enxofre e rocha fosfática importados): Custo de insumo por tonelada de MAP = CIF do enxofre × 0,45 + CIF da rocha fosfática × 1,7, em US$ por tonelada de MAP, com o preço médio de cada insumo importado no mês. Coeficientes: 0,45 t de enxofre e 1,7 t de rocha fosfática por tonelada de MAP, uma aproximação técnica: o consumo real muda com o teor da rocha e o processo de cada fábrica. É uma aproximação, não o custo de nenhuma empresa: ficam de fora o nitrogênio do MAP, a energia, a conversão, os impostos e o frete interno. Razão = custo de insumo ÷ CIF do MAP importado (NCM 31054000) no mesmo mês. Preços CIF no porto (produto, frete e seguro até o Brasil), antes de impostos, frete interno e margens: não são o preço ao produtor. Só as importações entram: o insumo de origem nacional fica de fora. Rocha fosfática: FOB do Brasil x Pink Sheet do Banco Mundial (Phosphate rock, FOB Norte da África), FOB×FOB. A Pink Sheet é uma referência de outro lugar e de outro momento de contrato: o spread mistura origem, teor da rocha, prazo de contrato e defasagem. Não é ágio. Amostra pequena: mês com menos de 30 mil t de enxofre, 30 mil t de rocha fosfática ou 10 mil t de MAP; um navio decide o preço. Nesses meses o spread da rocha fica vazio e o custo de insumo fica marcado.
  • Estados: a UF do produto no Comex Stat, que na importação é a UF de destino da mercadoria, qualquer que seja a sede do importador (e não a do porto de chegada); a tabela completa está em data/processed/share_uf_ano.csv.

O mesmo texto do Método no painel. Os termos estão no glossário; o método completo, com as limitações de cada comparação, no README.

Fontes

Só dados abertos oficiais, de governo ou de organismos internacionais, com licença que permite redistribuir. Nenhuma fonte pede chave; a atualização é automática, todo mês, e um mês só entra quando todas as séries o têm. Os dados tratados saem sob CC BY 4.0, com o crédito “Graaos (github.com/mvsantos-dev/graaos)”.

Comex Stat/MDIC
Importações de fertilizantes e dos insumos do fósforo (enxofre e rocha fosfática), por mês, NCM, país de origem, UF de destino, via e URF, com FOB, peso, CIF, frete e seguro; exportação de soja em grão, por mês, com FOB e peso. Licença: dados abertos do MDIC; de jan/2015 a out/2026.
Banco Mundial (Pink Sheet)
Preços mensais de fertilizantes (ureia, DAP, TSP, cloreto de potássio e rocha fosfática), em US$/t nominais. A Pink Sheet é referência de outro lugar e de outro momento de contrato, não um preço do Brasil. Licença: CC BY 4.0; edição de 03/11/2026.
BCB/PTAX (SGS 3698)
PTAX de venda, média mensal: só para converter o CIF e o custo por nutriente em reais (R$ só pela PTAX venda média do mês). Licença: ODbL; de jan/2015 a out/2026.
Natural Earth
Base cartográfica do mapa: fronteiras, pontos de rótulo dos países e portos. Licença: domínio público.

Marcos de mercado (data/eventos.yml), quando há: eventos escolhidos à mão, cada um com a fonte, marcados por uma linha no mês do evento nos gráficos dos produtos citados. São anotações, não dados das fontes oficiais, e não dizem que o evento causou a variação.

Fonte: Comex Stat/MDIC; Banco Mundial (Pink Sheet); BCB/PTAX.

Cortes de volume

Os cortes são regras do programa, não dados de mercado: com poucas toneladas, um navio decide o preço médio. Os valores vêm do dashboard.json desta atualização (o das páginas de origem, das regras do site); os volumes mínimos dos sinais estão em Sinais.

Amostra pequena: custo por nutriente
10.000 t do produto no mês. Mês abaixo do corte fica fora do gráfico e das frases; continua na tabela e no CSV, marcado em amostra_pequena.
Amostra pequena: Brasil x mercado internacional
10.000 t do produto no mês. Mês abaixo do corte fica fora dos gráficos e do boletim; continua na tabela e no CSV, marcado em amostra_pequena.
Amostra pequena: enxofre
30.000 t no mês. Mês abaixo do corte fica fora das frases, das médias e do custo de insumo do MAP; no gráfico, ponto vazado ligado por trecho pontilhado.
Amostra pequena: rocha fosfática
30.000 t no mês. Mês abaixo do corte fica fora das frases, das médias e do custo de insumo do MAP; no gráfico, ponto vazado ligado por trecho pontilhado.
Amostra pequena: MAP no custo de insumo
10.000 t de MAP no mês. O custo de insumo do mês fica marcado e fora das frases e das médias.
Rota com volume relevante
50.000 t no ano; em 2026 (jan–out), 41.667 t. Só as rotas (país de origem → URF) com pelo menos isso entram na tabela de frete por rota e nos arcos do mapa ao abrir um país ou porto; num ano parcial, o corte é proporcional aos meses com dados. Abaixo dele, o frete por tonelada vem de cargas pequenas e é ruidoso.
Origem no mapa de fluxos
1.000 t no ano e no grupo. Origem com menos que isso entra em “outros” no mapa e no ranking.
Origem nas páginas de produto
1.000 t no ano e no produto. País com menos que isso entra em “Outros” na tabela de origens do produto.
País com página de origem
1% das toneladas do ano, num dos 3 anos mais recentes (o ano em curso a partir de 6 meses). Quem passa ganha uma página em Origens; a lista muda sozinha a cada atualização.

Sinais de preço e de volume

Alertas automáticos de preço e de volume de cada produto, calculados mês a mês por regras fixas do programa (src/sinais.py), sem IA e só com os dados até o mês: o histórico mostra o que teria disparado em cada mês, sem olhar o futuro. Os limites vêm do campo “limites” do data/sinais.json desta atualização (os padrões de src/config.py).

  • Média: CIF do mês 20% ou mais acima ou abaixo da média dos 12 meses anteriores, com pelo menos 9 deles válidos (forte a partir de 40%).
  • Variação: CIF 15% ou mais acima ou abaixo do de 3 meses antes (forte a partir de 30%).
  • Recorde: CIF acima do maior ou abaixo do menor de todos os meses válidos anteriores, com pelo menos 36 deles (forte se passa o recorde anterior por 5% ou mais).
  • Internacional na frente: a Pink Sheet do produto andou 10% ou mais em 2 meses (forte a partir de 20%) e o CIF do Brasil não acompanhou: no mesmo sentido, andou menos de 50% disso; o MAP usa o DAP. A Pink Sheet é referência de outro lugar e de outro momento de contrato, não um preço do Brasil.
  • Troca: relação de troca no porto acima do percentil 90 dos meses válidos anteriores, com pelo menos 36 deles (forte acima do percentil 97,5). A troca é no porto, em t de soja exportada por t de fertilizante importado. Não é o preço ao produtor.
  • Ritmo de importação: toneladas do mês 25% ou mais acima ou abaixo das do mesmo mês do ano anterior, quando ele tem o volume mínimo (forte a partir de 50%).
  • Contra o ruído: preço só nos meses com pelo menos 20 mil t do produto (enxofre e rocha fosfática: 40 mil t); os outros ficam fora das médias, dos recordes e das comparações.
  • Explicação: nos sinais fortes, o boletim mensal traz uma ou duas frases geradas por IA a partir dos dados do Graaos, com os números inseridos e conferidos pelo programa; sem ela, o sinal fica só com a frase das regras.

Produtos e volume mínimo

Produtos dos sinais
ProdutoVolume mínimo no mêsSérie da Pink Sheet
Ureia20.000 tUrea
Sulfato de amônio20.000 t–
KCl20.000 tPotassium chloride
MAP20.000 tDAP (aproximação)
DAP20.000 tDAP
TSP20.000 tTSP
NPK20.000 t–
Enxofre40.000 t–
Rocha fosfática40.000 tPhosphate rock

Como ler

  • Sinais calculados mês a mês só com os dados até o mês (sem olhar o futuro), por regras fixas em Python (src/sinais.py), sem IA. Os limites de cada regra estão em "limites".
  • Preço = CIF em US$/t (valor CIF ÷ toneladas importadas no mês). Só entram meses com o volume mínimo do produto; os outros ficam fora das médias, dos recordes e das comparações.
  • Relação de troca no porto: CIF do fertilizante ÷ FOB da soja exportada no mesmo mês, em t de soja por t. Não é o preço ao produtor, e não muda com o câmbio.
  • Pink Sheet (Banco Mundial): referência de outro lugar e de outro momento de contrato, não um preço do Brasil. O MAP usa o DAP como aproximação.
  • O histórico é recalculado a cada atualização com os dados atuais: uma revisão das fontes pode mudar o sinal de um mês passado. O id (mês/produto/tipo) não muda.

O histórico tem 1.615 sinais, de jan/2015 a out/2026, 768 deles fortes. Fonte: Comex Stat/MDIC; Banco Mundial (Pink Sheet).

Os sinais de cada mês estão no boletim do mês, no feed Atom e no data/sinais.json (dados abertos).

Como o boletim é gerado e conferido

Boletim do mês e explicação dos sinais fortes: texto gerado por IA uma vez por mês, no GitHub Actions, a partir de um resumo dos números do Graaos (volumes, preços, relação de troca, insumos e sinais). A IA cita números só por marcadores, que o programa troca pelos valores e confere antes de publicar: texto com número fora do resumo, previsão de preço, recomendação de compra ou causa que os dados não mostram é descartado, e o boletim anterior continua no ar; uma seção que não passa sai sozinha, e o boletim sai com as outras. A manchete, os intertítulos, o quadro Números do mês e a citação em destaque são do programa, não da IA. Os sinais vêm de regras fixas, sem IA; a explicação é um complemento e, quando não passa na conferência, o sinal fica só com a frase das regras.

  1. Pacote de fatos: o programa monta, a partir do dashboard.json, um pacote com cada número já formatado e uma chave com nome. A IA recebe só um resumo, de até 6.000 tokens estimados, escolhido por prioridade: nunca o dashboard.json nem o pacote inteiro.
  2. Marcadores: a IA escreve o lead e até 6 seções, numa ordem fixa (“O acumulado do ano”, “Os grupos no mês”, “Insumos do fósforo”, “Referência internacional”, “Relação de troca no porto” e “Origens e portos”), e só cita números por marcadores {chave}, que o programa troca pelos valores do pacote. A direção (alta, queda, acima, abaixo) também entra só por marcador, preenchido pelo programa a partir dos dados.
  3. Conferência: o lead e cada seção são validados à parte. Número fora de marcador, palavra de direção, previsão, recomendação, causa que os dados não mostram, contexto de fora, link ou formatação reprovam o texto; depois, todo número do texto final é conferido contra o resumo que a IA recebeu. Seção reprovada sai sozinha.
  4. Publicação: o boletim precisa de pelo menos 3 seções aprovadas, em até 2 tentativas (a segunda com os erros da primeira); sem isso, nada é publicado e o boletim anterior continua no ar. Texto reprovado é descartado.
  5. Do programa, nunca da IA: a manchete (até 70 caracteres, com a direção do marcador), o número da edição, os intertítulos, o quadro Números do mês e a citação em destaque, que é a frase de um sinal.
  6. Tamanho: lead de até 450 caracteres, seção de até 800 e texto inteiro de até 4.500, contados depois de trocar os marcadores; até 1.500 tokens de resposta.
  7. Explicação dos sinais fortes: no máximo 12 sinais por mês, até 200 tokens cada, numa chamada só; cada explicação tem até 2 frases e 280 caracteres, liga o sinal a outro fato do mesmo mês, sem causa nem previsão, e passa pela mesma conferência; a reprovada sai sozinha e o sinal fica só com a frase da regra.
  8. Quando: uma vez por mês, no GitHub Actions, no dia em que o mês entra. O site, o servidor e o navegador nunca chamam a IA.

O passo a passo completo, com cada regra da conferência, está no README; os boletins de todos os meses, no arquivo.

Perguntas frequentes

De onde vêm os dados do Graaos?

Só de dados abertos oficiais: as importações e exportações do Comex Stat/MDIC, os preços internacionais de fertilizantes da Pink Sheet do Banco Mundial e a PTAX do Banco Central. Fonte: Comex Stat/MDIC; Banco Mundial (Pink Sheet); BCB/PTAX.

Os números do Graaos são gerados por IA?

Não. Os números, as tabelas, os gráficos e os sinais saem de regras fixas do programa, a partir dos dados oficiais. A IA só escreve, uma vez por mês, o texto do boletim e as explicações dos sinais fortes, com os números inseridos e conferidos pelo programa.

O que é preço implícito?

Valor importado ÷ toneladas: a média ponderada pelo peso, e não o preço de um contrato.

A relação de troca é o preço ao produtor?

Não. A relação de troca mede as toneladas de soja exportada que pagam 1 t de fertilizante importado no mesmo mês, no porto, sem frete interno, impostos nem margens até a fazenda. Não é o preço ao produtor.

Veja também