SAM.gov Opportunities

SAM.gov の案件情報 MCP サーバー

この MCP サーバーを使うと、AI アシスタント（Claude Desktop、Cursor、VS Code、Claude Code、その他の MCP クライアント）から、SAM.gov で米国連邦政府の契約案件（公募、情報提供依頼、事前公募、落札通知）を検索できます。

各呼び出しでは、cleandatalabs/samgov-opportunities Apify アクターをご自身の Apify トークンで実行します。SAM.gov API キーは不要で、1 日 10 リクエストの制限もありません。

開発者でない方へ： SAM.gov の検索を人に代行してもらいたい場合、Clean Data Labs が無料の手動確認サンプルを提供しています。検索 1 件、過去 7 日分、最大 10 件の通知が対象です。

ツール

ツール	機能
search_opportunities	有効な通知を新しい順に検索します。フィルター：keywords、naics_codes、psc_codes（どちらもプレフィックスを指定できます。例：2362、Z2）、set_asides（SBA、8A、HZC、SDVOSBC、WOSB、EDWOSB など）、agencies（名称で指定）、states（履行場所）、notice_types、posted_since（YYYY-MM-DD。その日以降に掲載または更新されたもの。デフォルトは過去 7 日間）、deadline_within_days、open_for_response_only、max_results（デフォルトは 25、最大 200）、detail（compact または full）。
get_opportunity	通知 ID、sam.gov/opp/... URL、または公募番号で 1 件の通知を取得します。公募番号を指定すると、落札情報（落札者、UEI、金額）を含む関連通知をすべて返します。
what_changed_since_last_check	監視モード：毎回、固定の monitor_id と同じフィルターを指定すると、前回の呼び出し以降に新規追加または変更された通知のみを取得できます。各通知には、change_type（new、amended、deadline_changed、amount_changed、awarded、canceled、notice_type_changed、updated）、changed_fields、平易な英語による change_summary、構造化された text_diff（タイトル、説明文、添付ファイル、期限・金額など）、以前の値（previous_response_deadline、previous_award_amount_usd、previous_notice_id）が含まれます。変更のない通知は無料です。最初の呼び出しは、デフォルトで無料の基準データを作成します。

コンパクト形式の行には、通知 ID、タイトル、公募番号、種別、部門、機関および事務所、掲載日と期限、NAICS、PSC、優遇措置、履行場所、主担当者、添付ファイル数、落札情報（落札金額、日付、落札者名、UEI、CAGE、落札番号）、監視変更フィールド（change_type、changed_fields、change_summary、text_diff、以前の値）、アクターがファイルをアーカイブした場合の任意項目 attachment_archive／attachments_archived、SAM.gov のリンクが含まれます。detail: "full" を指定すると、説明、すべての連絡先、添付ファイルへのリンクも含まれます。

search_opportunities と get_opportunity は読み取り専用です。what_changed_since_last_check は、メモリ（samgov-monitor-state のキーと値のレコード）をご自身の Apify アカウントに保存します。

費用

アクターの料金は返された通知 1 件につき $0.003です（25 件の場合は $0.075）。料金はトークンを所有する Apify アカウントに請求されます。Apify の無料プランには、毎月 $5 分のクレジットが含まれます。各ツール呼び出しには利用上限が設定され、max_results × $0.003 と SAMGOV_MAX_CHARGE_USD（デフォルトは $0.30）のいずれか低い方が適用されます。各結果には estimated_cost_usd が含まれます。

インストール

uv（uvx 用）、または pip を使える Python 3.10 以降と、Console > Settings > API & Integrations で取得した Apify API トークンが必要です。

Claude Desktop／Cursor／mcpServers 設定に対応するクライアント

{
  "mcpServers": {
    "samgov": {
      "command": "uvx",
      "args": ["samgov-opportunities-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_..." }
    }
  }
}

Claude Code

claude mcp add samgov --env APIFY_TOKEN=apify_api_... -- uvx samgov-opportunities-mcp

VS Code（.vscode/mcp.json）

{
  "inputs": [{ "type": "promptString", "id": "apify-token", "description": "Apify API token", "password": true }],
  "servers": {
    "samgov": { "type": "stdio", "command": "uvx", "args": ["samgov-opportunities-mcp"],
                "env": { "APIFY_TOKEN": "${input:apify-token}" } }
  }
}

ソースからインストール

git clone https://github.com/clean-data-labs-org/samgov-opportunities-mcp && cd samgov-opportunities-mcp
pip install -e .
APIFY_TOKEN=apify_api_... samgov-opportunities-mcp   # speaks MCP over stdio

設定

環境変数	デフォルト	意味
APIFY_TOKEN	（必須）	Apify API トークンです。実行料金はこのアカウントに請求されます。
SAMGOV_MAX_CHARGE_USD	0.30	ツール呼び出しごとの支出上限です。
SAMGOV_ACTOR_BUILD	latest	実行する Actor のビルドタグまたは番号です。latest は Actor の 0.3.7 です（change_summary／text_diff を監視し、downloadAttachments → attachment_archive はオプトイン）。デフォルトの latest を使うには、設定しないでください。get_opportunity には 0.3 以降、what_changed_since_last_check には 0.3.4 以降が必要です。

Actor 0.3.7（latest）では、監視対象の行に change_summary と text_diff が含まれ、すべての行に set_aside／set_aside_description が付与されます。添付ファイルのアーカイブは Actor でオプトインできます（downloadAttachments: true）。ファイルは sha256 による重複排除を行う永続 KV ストアに保存され、行には attachment_archive[]／attachments_archived が追加されます。この MCP パッケージにはまだ download_attachments ツールフラグがありません。Actor を直接呼び出す場合にのみ設定してください。

プロンプトの例

• 「今週掲載された、コロラド州の中小企業向け優先枠の清掃契約を探してください。」
• 「今後 30 日以内が期限の、NAICS 2362 に該当する VA の建設案件はありますか？」
• 「調達案件 FA813226Q0061 の落札者と金額を教えてください。」
• 「コロラド州の建設案件（NAICS 236220）について、前回の確認以降に何が変わりましたか？」
• 「2026-11-01 以降に陸軍が掲載した、HUBZone の IT サービス案件（NAICS 5415）を表示してください。」

インストール不要の代替手段：Apify のホスト型 MCP サーバー

何もインストールせずに使うには、クライアントを Apify のホスト型サーバーに接続し、この Actor のみに制限してください。

{ "mcpServers": { "samgov": { "url": "https://mcp.apify.com/?tools=cleandatalabs/samgov-opportunities" } } }

OAuth でサインインするか、Authorization: Bearer <APIFY_TOKEN> を送信できます。生の Actor 入力すべてを受け付ける汎用ツールとして Actor を公開するほか、実行およびデータセット用のヘルパーツールも提供します。このパッケージでは、型付きフィルター、コンパクトな出力、呼び出しごとの支出上限を備えた、用途を絞った 3 つのツールを提供します。

開発

pip install -e ".[test]"
pytest                                  # offline tests over a real MCP stdio session
SAMGOV_LIVE=1 APIFY_TOKEN=... pytest    # adds a live search + get (about $0.01)
npx @modelcontextprotocol/inspector -e APIFY_TOKEN=... -- samgov-opportunities-mcp

データソースと免責事項

データは公開されている SAM.gov の公告に基づいています。このプロジェクトは、米国一般調達局（General Services Administration）または SAM.gov と提携しておらず、承認も受けていません。入札前に、公式の公告で期限と要件を必ず確認してください。

ライセンス

MIT