🌾 Global Agri Decision Engine — Jenko Analytics

The decision engine for the global farmer, trader, and policymaker. Powered by NASA satellites (any lat/lng on Earth), USDA + FAO production data, World Bank prices, and Jenko proprietary metrics. Every metric ships with inline formula, calculation breakdown, verdict scale, and benchmark comparisons.

Status: Production-ready. 10 modes operational. 8 Jenko metrics (JCR, JGS, JCY, JLE, JAQ, JFS, JPM, JTR). Zero API keys required.

---

🇬🇧 English

What it is

Complete agricultural decision API integrating 3 layers:

Layer	What it does	Source
🌍 LOCAL	Farm-level climate (lat/lng → rainfall, temperature, drought)	NASA POWER (satellite)
📊 COMMODITY	Global production, yield, trade flows	USDA FAS + FAO derived
💰 MARKET	Prices, momentum, cycle position	World Bank Pink Sheet

Who it's for

• 👨‍🌾 Farmers and growers on every continent — plant/sell decisions
• 🐄 Ranchers and dairy producers — JLE efficiency analysis, beef/milk price cycles
• 🐟 Aquaculturists — JAQ for salmon, shrimp, tilapia, carp
• 🏢 Traders, macro funds, cooperatives — liquid global commodities
• 🏛️ Governments, multilateral agencies, NGOs — food security mapping
• 🏦 Development banks and crop insurers — quantified climate + supply risk
• 🌱 Researchers, consultancies, journalists — structured analytical data

Where it works

Anywhere on Earth. NASA POWER covers the globe via lat/lng (50km grid, 40+ years of history). Macro coverage spans 57 countries across all continents: Africa (13), Middle East (7), Asia (13), Europe (11), Americas (11), Oceania (2).

10 Available modes

🌟 Premium (1):

• farm_decision_engine — lat/lng + commodity → integrated PLANT/SELL recommendation

🌍 Climate layer (2):

• farm_climate_profile — JCR for one lat/lng (30d rain, anomaly, drought)
• regional_climate_risk — JCR for multiple locations or preset regions

📊 Outlook layer (3):

• crop_outlook — JCY for 12 crops
• livestock_outlook — JLE for 8 livestock categories
• aquaculture_outlook — JAQ for salmon, shrimp, tilapia, carp

💰 Market & macro (4):

• food_security_dashboard — JFS ranking 57 countries
• commodity_market_signal — JPM for 12 commodities
• trade_flow_analysis — JTR (exporters/importers + geopolitical flags)
• agri_commodities_dashboard — overview ranked by JPM

8 Jenko proprietary metrics

Every metric returns score, verdict, interpretation, formula (equation + human readable), calculation_breakdown (each component with raw input, weight, contribution, explanation), verdict_scale (tiers with meaning), and example_comparison (benchmarks for context).

Metric	What it measures
JCR	Climate Risk for a lat/lng (drought + temp + rainfall vs 30yr normal)
JGS	Growing Score (current climate vs crop's optimal range)
JCY	Crop Yield Outlook (production + concentration + weather)
JLE	Livestock Efficiency (FCR + growth + export diversification)
JAQ	Aquaculture Score (FCR + growth + concentration + climate)
JFS	Food Security Index (self-sufficiency + imports + staples + stockpile)
JPM	Price Momentum (YoY + MoM + cycle position + supply tightness)
JTR	Trade Risk (exporter/importer concentration + geopolitical flags)

Commodity coverage

Crops (12): soybeans, corn, wheat, rice, coffee, sugarcane, cotton, palm_oil, barley, cocoa, sorghum, canola

Livestock (8): cattle, dairy_cattle, poultry_broiler, swine_pork, sheep, buffalo, eggs_poultry, goats

Aquaculture (4): atlantic_salmon, tilapia, shrimp, carp

Region Presets (27): Iowa corn, Mato Grosso soy, Indian Punjab, Sahel sorghum, Mekong rice, Argentine Pampas, China North Plain, Sumatra palm, Ethiopian coffee, Ivory Coast cocoa, and more

Usage examples

🌟 Complete decision for any lat/lng:

{
  "mode": "farm_decision_engine",
  "latitude": -12.55,
  "longitude": -55.72,
  "commodity": "soybeans"
}

🌍 Climate for any point:

{
  "mode": "farm_climate_profile",
  "latitude": 42.03,
  "longitude": -93.62
}

🗺️ Climate risk for preset region:

{"mode": "regional_climate_risk", "region": "sahel_sorghum"}

🌱 Global coffee outlook:

{"mode": "crop_outlook", "commodity": "coffee"}

🐟 Atlantic salmon:

{"mode": "aquaculture_outlook", "commodity": "atlantic_salmon"}

🍞 Most vulnerable countries:

{"mode": "food_security_dashboard", "top_n": 10, "sort_by": "vulnerable"}

🌍 Food security by continent:

{"mode": "food_security_dashboard", "region_filter": "Africa", "top_n": 13}

Pricing

• US$ 5 per 1,000 records

Data sources (100% commercial-friendly)

Source	Coverage	License
NASA POWER API	Global climate by lat/lng, 40+ years	Public Domain
USDA FAS PSD	Production/trade for 200+ commodities	Public Domain
FAO FAOSTAT (derived)	Agriculture/livestock/aquaculture	derived metrics only
World Bank Pink Sheet	Monthly commodity prices	CC BY 4.0

Disclaimer

⚠️ NOT a substitute for a local agronomist or financial advisor. Jenko metrics are analytical signals.

---

🇧🇷 Português

O que é

API completa de decisão agrícola integrando 3 camadas:

Camada	O que faz	Fonte
🌍 LOCAL	Clima da fazenda (lat/lng → chuva, temperatura, drought)	NASA POWER (satélite)
📊 COMMODITY	Produção mundial, rendimento, fluxos de comércio	USDA FAS + FAO derived
💰 MARKET	Preços, momentum, posição de ciclo	World Bank Pink Sheet

Para quem é

• 👨‍🌾 Fazendeiros e produtores rurais em todos os continentes
• 🐄 Pecuaristas e produtores de leite — análise de eficiência (JLE)
• 🐟 Aquicultores — JAQ para salmão, camarão, tilápia, carpa
• 🏢 Traders, fundos macro e cooperativas — commodities líquidas globais
• 🏛️ Governos, agências multilaterais e ONGs — vulnerabilidade alimentar
• 🏦 Bancos de desenvolvimento e seguradoras agrícolas — risco quantificado
• 🌱 Pesquisadores, consultorias e jornalistas — dados estruturados

Onde funciona

Em qualquer lugar do planeta. NASA POWER cobre o globo via lat/lng (grid 50km, 40+ anos histórico). Cobertura macro: 57 países em todos os continentes — África (13), Oriente Médio (7), Ásia (13), Europa (11), Américas (11), Oceania (2).

10 Modes

🌟 Premium (1): farm_decision_engine — recomendação completa

🌍 Climate (2): farm_climate_profile, regional_climate_risk

📊 Outlook (3): crop_outlook, livestock_outlook, aquaculture_outlook

💰 Market & macro (4): food_security_dashboard, commodity_market_signal, trade_flow_analysis, agri_commodities_dashboard

8 Métricas Jenko proprietárias

Cada métrica retorna score, verdict, interpretation, formula (equação + tradução humana), calculation_breakdown (cada componente com entrada, peso, contribuição, explicação), verdict_scale (tiers com significado) e example_comparison (benchmarks).

Métrica	O que mede
JCR	Climate Risk para uma lat/lng
JGS	Growing Score (clima vs faixa ótima do cultivo)
JCY	Crop Yield Outlook global
JLE	Livestock Efficiency (FCR + growth + export)
JAQ	Aquaculture Score
JFS	Food Security Index
JPM	Price Momentum
JTR	Trade Risk

Cobertura de commodities

Crops (12): soybeans, corn, wheat, rice, coffee, sugarcane, cotton, palm_oil, barley, cocoa, sorghum, canola
Livestock (8): cattle, dairy_cattle, poultry_broiler, swine_pork, sheep, buffalo, eggs_poultry, goats
Aquaculture (4): atlantic_salmon, tilapia, shrimp, carp
Region Presets (27): zonas agrícolas-chave globais

Tarifação

• US$ 5 por 1.000 records

Disclaimer

⚠️ NÃO substitui agrônomo local ou consultor financeiro. Métricas Jenko são sinais analíticos.

---

🛠️ Local development

pip install -r requirements.txt
echo '{"mode":"farm_decision_engine","latitude":-12.55,"longitude":-55.72,"commodity":"soybeans"}' > input.json
python -m src.main

---

Built by Jenko Systems.