Nass

USDA NASS — 農業統計

USDA National Agricultural Statistics Service です。作物生産、家畜飼養頭数、価格、作付・収穫面積、収量など、米国の公式農業データを提供します。主要な商品について、州・郡レベルのデータを利用できます。無料で、認証は不要です（軽度のレート制限あり）。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続する MCP ゲートウェイです。

AI エージェントにとっての重要性

農産物に関する質問（供給見通し、価格動向、地域別生産など）では、NASS が権威ある情報源です。USDA のアナリスト、商品トレーダー、アグリビジネスで利用されています。農業関連の賃金やPPIについてはBLS、世界の貿易フローについては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 は別物です。 World Agricultural Supply and Demand Estimates（WASDE）は、NASS のデータと世界のデータをまとめ、需給予測を示す別の USDA レポートです。「見通し」に関する質問には、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

標準入力／標準出力を介して MCP 通信を行い、このパック専用のツールについてのみ initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。この機能は、上記のパックエンドポイントと完全版ゲートウェイのどちらでも利用できます。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT