Nass

USDA NASS — 农业统计

美国农业部国家农业统计局。农作物产量、牲畜存栏量、价格、播种／收获面积、单产——美国官方农业数据。主要商品数据细分至州和县级。免费，无需认证（有轻微速率限制）。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1683 多个实时数据源的 MCP 网关。

这对 AI Agent 的重要性

对于农业商品问题——供应前景、价格趋势、区域产量——NASS 是权威数据来源。美国农业部的分析师、商品交易商和农业企业都在使用。可与 BLS 搭配查询农业工资／PPI，并与 Comtrade 搭配查询全球贸易流向。

常见工作流：

• 产量估算。“玉米产量预测是多少？”→ nass_query({commodity: "CORN", agg_level: "NATIONAL"}) → 年度和月度预测。
• **州级细分。**使用相同查询，并添加 state: "IOWA"，即可查询爱荷华州的具体数据。
• 牲畜存栏量。“德克萨斯州有多少头牛？”→ nass_query({commodity: "CATTLE", state: "TEXAS"})。
• **价格。**按商品和时间段查询农场门口平均价格。

由 agricultural_commodity_brief 配方使用。

认证

NASS Quickstats 需要从 https://quickstats.nass.usda.gov/api 获取免费的 API 密钥。通过 _apiKey 传入。没有密钥时，调用会失败；提供密钥后，速率限制较宽松。

跟踪的主要商品

大田作物：玉米、大豆、小麦、棉花、水稻、高粱、大麦、燕麦、花生、糖。

牲畜：牛（犊牛、肉牛、奶牛）、猪、羊、家禽（肉鸡、蛋鸡、火鸡）。

特色农产品：蔬菜（土豆、番茄）、水果（苹果、柑橘）、树坚果、观赏植物。

请使用 USDA 的准确商品名称——该 API 对拼写和大小写要求严格。

更新频率

报告	频率
作物产量	生长季期间每月发布；最终报告于 1 月发布
季度猪和仔猪报告	3 月、6 月、9 月、12 月
牛存栏量	1 月、7 月
收购／支付价格	每月
作物生长进度（播种／收获百分比）	生长季期间每周

作物生长进度报告是频率最高的信号。

常见问题

• **月度报告中的同比混淆。**季中作物产量报告会按月修订当年预测。应与上一年比较，而不是与上个月的预测比较。
• **单产与产量。**单产指每英亩的产量（例如蒲式耳／英亩）。产量为总量（单产 × 收获面积）。二者反映的情况不同。
• NASS 不等于 WASDE。《世界农业供需预测》（WASDE）是美国农业部的另一份报告，综合 NASS 和全球数据，提供供需预测。对于“前景”类问题，可能需要查询 WASDE。
• **小宗作物的州级数据较少。**州级详细数据主要覆盖主要产区。较小的生产地区可能会合并到“其他州”，或数据不予公开。
• **英制单位。**蒲式耳、磅、头、英亩。Comtrade 使用千克——交叉参考时请换算单位。
• **参考期。**牛存栏量报告是某一时点的数据（1 月 1 日存栏量）；作物报告通常涵盖一个营销年度（因作物而异）。请查看元数据。

快速入门

将其添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "nass": {
      "url": "https://gateway.pipeworx.io/nass/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/nass/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表中的数量：目前，单个套件端点除了列出该套件自己的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是了解某一天实际情况的权威依据。

这是有意为之，并非意外复用。借助这些元工具，限定范围的连接也能回答本套件未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的套件端点；如果额外的工具架构消耗的上下文超过了路由功能带来的价值，不如只连接一次完整网关，而不是连接多个套件端点。

或者，连接完整的 Pipeworx 网关，直接列出所有套件的工具，而不只是这个套件的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和同一批 1683+ 个数据源。唯一的区别是直接列出哪个套件的工具；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/nass_query \
  -H 'Content-Type: application/json' \
  -d '{"commodity":"CORN","stat_category":"YIELD","state":"IOWA","year":"2024"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/nass_query。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "nass": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nass"]
    }
  }
}

或者直接运行以确认它能正常启动：

npx -y @pipeworx/mcp-nass

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅提供此套件的工具——不包含上述网关连接额外提供的共享元工具。代码来源相同，工具相同，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不必直接调用工具——此功能既适用于上面的套件端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Nass data" })

网关会自动选择合适的工具并填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT