SAM.gov Opportunities

SAM.gov Opportunities MCP 服务

此 MCP 服务可让 AI 助手（Claude Desktop、Cursor、VS Code、Claude Code 或任何其他 MCP 客户端）搜索 SAM.gov 上的美国联邦合同机会：招标公告、市场调查公告、预招标公告和授标公告。

每次调用都会使用你自己的 Apify 令牌运行 Apify actor cleandatalabs/samgov-opportunities。你不需要 SAM.gov API 密钥，也没有每天 10 次请求的限制。

不是开发者？ 如果你更希望有人替你监控 SAM.gov 搜索，Clean Data Labs 提供免费人工核查样本：一次搜索，最近 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 或招标编号获取单条公告。招标编号会返回其所有公告，包括授标信息（中标方、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、先前的值）、actor 存档文件时可选的 attachment_archive / attachments_archived，以及 SAM.gov 链接。detail: "full" 会添加描述、所有联系人和附件链接。

search_opportunities 和 get_opportunity 均为只读。what_changed_since_last_check 会将其监控状态（一个 samgov-monitor-state 键值记录）存储在你自己的 Apify 账户中。

费用

该 actor 按每条返回的公告收取 $0.003（25 条结果共 $0.075），费用计入令牌所属的 Apify 账户。Apify 免费套餐每月包含 $5 额度。每次工具调用都有支出上限：取 max_results × $0.003 和 SAMGOV_MAX_CHARGE_USD（默认值为 $0.30）中的较低值。每条结果都会报告 estimated_cost_usd。

安装

你需要 uv（用于运行 uvx），或 Python 3.10+ 和 pip，以及从 控制台 > 设置 > API 和集成 获取的 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 选择启用附件归档（文件存入持久化 KV 存储，并通过 sha256 去重；结果行会包含 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 输入，以及运行和数据集辅助工具。此软件包则提供三个专用工具，支持类型化筛选器、精简输出和单次调用支出上限。

开发

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 的公开公告。本项目与美国总务管理局或 SAM.gov 没有关联，也未获得其认可。投标前，请务必在官方公告中确认截止日期和要求。

许可证

MIT