usda_nass_get_production_forecasts
Retrieve in-season USDA crop production or yield forecasts by commodity, year, and optional state to track revisions and compare against final annual totals.
Instructions
The in-season production or yield forecasts for a crop and year, oldest first.
The Crop Production reports' forecasts, each row naming its
reference_period_desc (YEAR - AUG FORECAST, YEAR - SEP FORECAST, ...),
selected with reference_period_desc__LIKE FORECAST; the final figure,
YEAR, is get_production's. Annual totals (domain_desc TOTAL,
prodn_practice_desc ALL PRODUCTION PRACTICES, freq_desc ANNUAL), so
breakdowns by irrigation and the like are left out and the series is comparable with
the final figure. Utilisations, classes and units come as rows, the columns tell them
apart: util_practice_desc grain from silage, class_desc a crop's classes
(wheat's ALL CLASSES, WINTER, SPRING, (EXCL DURUM), SPRING, DURUM),
unit_desc the unit (BU, BU / ACRE). value is the figure as published,
value_number its parsed form. Sorted by load_time, then utilisation, class
and unit. Cost: one keyed call, without a count first; meta.total stays None.
Args:
commodity: Upstream commodity_desc, e.g. "CORN", "SOYBEANS",
"WHEAT", "COTTON"; list_param_values("commodity_desc") lists them.
year: Crop year, e.g. 2023.
statistic: ProductionStatistic.PRODUCTION or ProductionStatistic.YIELD.
state: Two-letter state code for the state series, e.g. StateAlpha.IA;
None returns the national series.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"commodity": "<commodity>",
"year": "<year>",
"statistic": "<statistic>"
},
"name": "usda_nass_get_production_forecasts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| state | No | ||
| commodity | Yes | ||
| statistic | Yes |