Acquisition Forecasts

acquisition-forecasts

米国連邦政府機関の調達予測です。各機関が購入する意向を公表した情報で、調達公告が出る数か月から数年前に確認できます。キーは不要です。

Pipeworx の一部です。AI エージェントを 1872 以上の稼働中のデータソースにつなぐ MCP ゲートウェイです。独立した非公式の連携であり、上流プロバイダーとの提携、同プロバイダーによる推奨または公開を受けたものではありません。

このツールが扱うのは、今後の見通しです。usaspending はすでに義務付けられた支出を、govcon-intel はすでに公開されている調達公告を SAM で検索します。「見逃してしまったか」ではなく「この案件に人員を割り当てるべきか」に答えられるのは、予測だけです。

ツール

• forecast_search(keyword?, agency?, sub_agency?, naics?, set_aside?, fiscal_year?, min_value?, limit?)
• forecast_detail(forecast_id, agency?) — 詳細な説明、履行期間（PoP）、連絡先
• forecast_agencies() — 接続済みの機関と、それ以外すべての判定結果

対応しているのは1機関のみです。それが調査結果です

各機関には予測の公表が義務付けられており、acquisition.gov は22機関の情報を掲載しています。2026-08-29 にすべてを調査した結果、機械可読データを公開しているのは、わずか1機関でした。

判定	件数	機関
JSON API	1	DHS（apfs-cloud.dhs.gov、847件）
HTML、データファイルなし	15	農務省、教育省、エネルギー省、司法省、労働省、国務省、内務省、財務省、運輸省、退役軍人省、GSA、NASA、NSF、SSA、DHS 独自のランディングページ
PDF のみ	4	DoD、HUD、NRC、OPM
自動化されたクライアントをブロック（403）	2	USAID、商務省
到達不能（タイムアウト）	1	HHS

PDF の予測は意図的に OCR 処理していません。誤った数値を解析するくらいなら、数値がないほうがましです。これらは、人々が計画の根拠にする金額だからです。

そのため、forecast_agencies() を主要ツールとして提供し、すべての検索レスポンスに agencies_covered と coverage_note を含めています。連邦政府の予測をうたうパックが、ひそかに1機関しか扱っていなければ、確認していない21機関について「予定なし」と回答してしまいます。これは、データがないことと対象が存在しないことを混同する問題であり、このカタログが繰り返し学んできた教訓です。

機関を追加するには、AGENCIES[] に設定エントリーを追加し、フィールドマップを用意します。

注意点

APFS API はすべてのクエリパラメーターを無視します。 ?naics=5415、 ?organization=CBP、?zzznonsense=x は、いずれも同じ 847 件の行を同じ先頭 ID で返します。 サーバー側のフィルタリングは行われないため、このパックはファイル全体（約 2 MB、15 分間キャッシュ）を取得して、メモリ上でフィルタリングします。フィルターを上流に送ることでこれを「最適化」しようとすると、フィルター済みに見えて実際にはそうなっていない結果になります。

small_business_set_aside と small_business_program は異なるフィールドです。 前者はブール値（true/false/null）、後者はプログラムの名称 （SB、8(a)、HUBZone、WOSB、SDVOSB、AbilityOne、None、TBD）です。 ブール値を先に統合すると、847 件中 350 件が文字列 "true" になり、プログラム名が失われます。また、ブール値がたまたま null だった行だけが一致対象として残るため、set_aside="8(a)" の結果は71 件ではなく 27 件になります。これらは set_aside（名称）と set_aside_applies（ブール値。null はその行に記載がないことを意味します）として返されます。

NAICS はコードとラベルが 1 つの文字列で届きます — "236220 - Commercial and Institutional Building Construction"。呼び出し元が指定した 5415 を元のフィールドに対して照合すると、その数字を含む説明文にも一致してしまいます。コードは分離して、NAICS の階層構造に沿って前方一致で照合します。5415 は 541511、541512、…を含みます（完全なコードでは 19 件のところ、175 件）。

値は数値ではなく範囲です — "$50M to $100M"、"Over $100M"。範囲のテキストはそのまま保持し、さらに low／high に解析します。上限のない最上位の範囲では、high は大きな数値ではなくnullです。min_value はこれを上限なしとして扱います。架空の上限を設定すると並べ替えはできますが、誤った結果になります。

organization は下位機関のパスであり、機関ではありません：CBP/OIT/LSS/ITB。847 件すべてが DHS です。呼び出し元が期待するとおりに agency="DHS" を扱えるよう、agency と sub_agency は別々に報告されます。

予測情報は改訂されます。 published_date、previously_published、last_updated により、確認しているのがどのバージョンかが分かります。取り下げられた要件や契約済みの要件はファイルから完全に削除されることがあり、そのため forecast_detail は単に「見つかりません」と報告せず、その旨を示します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/acquisition-forecasts/mcp の tools/list は、上記の表にあるツールに加え、共有の Pipeworx メタツール — ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える一連のツールを返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに約 30 個の共有ツールが一覧表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックでは扱わない質問にも、カタログ全体に振り分ける ask_pipeworx を通じて回答できるため、2 つ目の MCP サーバーを追加する必要がありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマで消費されるコンテキストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに 1 回接続してください。

または、フルの Pipeworx ゲートウェイに接続して、このパックだけでなく、すべてのパックのツールを直接一覧表示できます：

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

どちらの URL も、同じゲートウェイと同じ 1872 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/forecast_search \
  -H 'Content-Type: application/json' \
  -d '{"naics":"5415","agency":"DHS"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/forecast_search を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-acquisition-forecasts

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Acquisition Forecasts data" })

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

詳細

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

ライセンス

MIT