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
| Produto | Volume mínimo no mês | Série da Pink Sheet |
|---|---|---|
| Ureia | 20.000 t | Urea |
| Sulfato de amônio | 20.000 t | – |
| KCl | 20.000 t | Potassium chloride |
| MAP | 20.000 t | DAP (aproximação) |
| DAP | 20.000 t | DAP |
| TSP | 20.000 t | TSP |
| NPK | 20.000 t | – |
| Enxofre | 40.000 t | – |
| Rocha fosfática | 40.000 t | Phosphate 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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
- Dados abertosas tabelas em CSV, Parquet e JSON, com o dicionário de campos e como citar
- GlossárioFOB, CIF, preço implícito, spread, relação de troca e os outros termos
- Produtospreço, volume e origens de cada fertilizante
- Método no painelo mesmo método, no fim do painel