SAM.gov 米国調達公告・法人登録 を AI から使う

GSA が運営する、米国政府の調達公告・法人登録の公式システム SAM.gov にAIクライアントから接続できるサーバーです。

主な機能:

• search_opportunities: 入札公告・事前公告・統合公告・市場調査 (Sources Sought)・落札通知を、タイトルキーワード・NAICS コード・公告種別・機関・履行地の州・掲載日の範囲で検索します。掲載日の範囲は既定で直近 90 日、上流仕様により最大 1 年です。日付は ISO 形式で受け取り、SAM.gov の MM/dd/yyyy へ自動変換します。
• search_entities: 米国政府と取引するために登録された法人・団体を、正式名称・12桁の UEI・5桁の CAGE コードで照会します。登録状態と有効期限・所在地・各種識別子を返します。

search_entities が返す UEI は USAspending が受注者に使う識別子と同一なので、2 つのサーバーはきれいに突き合わせられます (こちらで法人を見つけ、あちらで受注実績を引く)。USASpending との分担は「SAM.gov は公告が出る場所 (落札前〜落札時)、USAspending は実際の支出が記録される場所」です。

利用には SAM.gov アカウントの Account Details ページで発行する個人 API キーが必要です (ログイン必須で、キーはアカウントのロールに紐づきます)。Arlet の環境変数 SAM_GOV_API_KEY に設定してください。上流ゲートウェイは無効なキーに空の 404 を返しますが、本サーバーが行動可能なエラーメッセージに変換します。