SAM.gov 美国联邦合同机会采集与监控
采集 SAM.gov 联邦合同机会(征询书/RFP/RFQ/来源征寻/预征询/特别通知/授标通知):关键词、NAICS、PSC、预留类别、公告类型、机构、履约州、发布与截止日期窗口过滤;含合同官姓名/邮箱/电话、全文描述、NAICS/PSC、履约地、中标方 UEI/CAGE/金额;支持按征询号或 notice id/URL 查询、批量名单合并、增量监控(只出新通知/更新通知)。数据源为 SAM.gov 官网自有免登录搜索后端,无需账号/代理
概览
与 Apify Actor fortuitous_pirate/sam-gov-scraper 同能力:从 SAM.gov 拉取联邦合同机会
(征询书、RFP、RFQ、来源征寻、预征询、特别通知、授标通知),过滤与输出字段对齐。
数据源:SAM.gov 官网自有免登录搜索后端(/api/prod/sgs/v1/search/,
Accept: application/hal+json)——无账号、无 API key、无代理。搜索记录本身即含
合同官联系人、描述全文、NAICS/PSC、预留类别、履约地、归档日期与授标数据。
输入(四用法合一)
| 用法 | 输入 | 说明 |
|---|---|---|
| 搜索 | keywords(每行一次搜索,合并去重)+ 各过滤项 | 关键词、NAICS、PSC、预留类别、公告类型、机构、履约州、发布/截止窗口 |
| 查询 | solicitationNumbers / noticeIds(32 位 id 或 sam.gov URL) | 返回该号全部通知(原件/修订/授标,含归档);设置后忽略搜索过滤 |
| 批量 | listUrl(CSV/TSV/文本,读第一列自动识别) | 关键词、征询号、notice id 混合合并去重 |
| 监控 | onlyNew: true + monitorId | 只返回新增或自上次以来更新的通知;firstRunMode=baseline 可静默建基线 |
日期过滤:YYYY-MM-DD / today / 相对值 '7 days'(发布类为往前、截止类为往后)。
排序:-modifiedDate(每日增量)或 -relevance(配关键词)。
输出(每通知一条)
noticeId / title / noticeType(Code) / solicitationNumber / url / postedDate / modifiedDate / responseDeadline / daysToDeadline / archiveDate / isActive / isCanceled / agency(+Ids) / placeOfPerformance / naicsCodes / pscCodes / setAside / contacts(姓名/职务/邮箱/电话)/ summary / description(纯文本≤60k)/ award(日期/编号/金额/中标方名/UEI/CAGE)/ attachments / fetchedAt
边界(与原 Actor 的差异,已如实声明)
- EXACT 关键词模式本地复核(免登录后端 qMode=EXACT 表现同 ANY):按标题/征询号含精确短语过滤
- 机构名称/缩写回退为关键词搜索;数字机构 ID 走服务端
organization_id过滤 - 附件直链需可选 输入字段
apiKey(官网 Account Details 免费申领的公开 key);无 key 时 attachments 为空。附件文件不可下载(平台无文件输出通道),downloadAttachments 等 三个字段被接受但忽略 - 监控状态保存在本地状态文件(storage/state/samgov-monitor-.json),非 Apify KV
- 单次 SAM.gov 查询上限 1 万条(后端限制),更大批量用日期窗口分批
适用边界
数据源为 SAM.gov 网站自有免登录搜索接口(与官网浏览器同源),无需 SAM.gov 账号或 API key;EXACT 关键词模式在本地复核(免登录后端的 qMode=EXACT 表现同 ANY);机构名称/缩写回退为关键词搜索,数字机构 ID 走服务端 organization_id 过滤;附件下载直链需可选的 SAM.gov 公开 API key(运行环境 sam_api_key,官网 Account Details 免费申领),无 key 时 attachments 为空且附件文件不可下载(平台无文件输出通道,downloadAttachments 仅列出链接);单次查询后端最多返回 1 万条,更大批量请用日期窗口分批;监控状态保存在本地状态文件(非 Apify KV)
- 适合用于
- 按 NAICS/PSC/预留类别/机构/州拉取可投标的联邦机会清单,含合同官联系方式与截止倒计时
- 按征询号或 notice URL 查询通知及其修订记录、中标结果(中标方名称/UEI/CAGE/金额)
- 定时增量监控:只返回上次运行以来新增或更新的通知(配合 webhook 推送)
- 不要用于
- 需要下载附件二进制文件(平台无文件输出通道,只提供直链;且直链需可选 API key)
- 非合同类 SAM.gov 数据(实体注册/UEI 查询/援助公告等不在本应用范围)
- 单次要超过 1 万条的全量回灌(后端硬限制,请用日期窗口分批)
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1单条查询/详情失败只影响该条:记录日志并继续,不中断运行
- 2SAM.gov 后端偶发连接抖动自动重试(最多 3 次)
- 3keywords 与 listUrl 都为空且无查询项 → 拉取过滤条件下最新 100 条(与 Actor 行为一致)
- 4监控状态文件损坏时视为全新监控重新基线化,不报错
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 搜索关键词
keywords选填string搜索词,如 'software development'、'cybersecurity'。每行一次独立搜索,结果合并去重;留空 = 在其余过滤条件下匹配全部 - 关键词匹配
keywordMode选填stringANY = 任一词(SAM.gov 默认);ALL = 全部词;EXACT = 精确短语(本地复核)默认值ANY示例ANY - 关键词列表(批量)
keywordList选填string每行一个(多行文本):keywords 输入框的数组替代形式,每项一次独立搜索 - 批量名单 URL(CSV/表格)
listUrl选填stringCSV/TSV/文本文件或'任何人可读'的 Google Sheet URL;读第一列,自动识别为关键词、征询号(如 N4008426R1026)或 notice id/sam.gov URL - NAICS 行业码
naicsCodes选填string每行一个;支持前缀(5415 匹配 541511/541512/…)。常用 IT 码:541511 编程、541512 系统设计、541519 其他 IT、518210 数据/托管、541690 咨询 - PSC 产品服务码
pscCodes选填string每行一个,如 DA10(IT 软件)、R425(工程支持)、S201(保洁)、Z1DA(医院维护)、6515(医疗耗材) - 预留类别
setAsideTypes选填string每行一个(多行文本):SBA(全部小企业)、SBP、8A、8AN、HZC/HZS(HUBZone)、SDVOSBC/SDVOSBS、WOSB/WOSBSS、EDWOSB/EDWOSBSS、VSA/VSS、LAS、IEE、ISBEE、BICiv - 公告类型
opportunityTypes选填string每行一个(多行文本):用代码或名称(不区分大小写):o=征询书, k=合并摘要/征询书, p=预征询, r=来源征寻, s=特别通知, a=授标通知, u=论证, g=剩余财产出售, i=打包意图;留空 = 全部类型 - 机构/办公室
agencies选填string每行一个:名称、缩写或 SAM.gov 机构数字 ID(如 100006568);数字 ID 走服务端过滤,名称/缩写回退为关键词搜索(日志中体现) - 履约州
states选填string每行一个(多行文本):工作履行地州代码,如 CA、TX、VA、DC - 仅活跃机会
activeOnly选填boolean开启(默认)只返回 SAM.gov 上仍开放的通知;关闭含已归档(适合授标历史研究)默认值true示例true - 状态
status选填stringactive=仅开放(默认)、inactive=仅归档、all=两者;设置后覆盖 activeOnly - 发布于近 N 天
postedWithinDays选填integer只返回近 N 天内发布或更新的通知;设置'发布起'后忽略。1–3650默认值30示例30 - 发布起
postedFrom选填stringYYYY-MM-DD、'today' 或相对值如 '7 days'(=7 天前);设置后覆盖'发布于近 N 天' - 发布止
postedTo选填stringYYYY-MM-DD、'today' 或相对值如 '2 days' - 响应截止起
responseDeadlineFrom选填stringYYYY-MM-DD、'today' 或相对值如 '3 days'(=3 天后);用 'today' 可跳过已来不及投标的征询 - 响应截止止
responseDeadlineTo选填stringYYYY-MM-DD 或相对值如 '30 days' - 征询号查询
solicitationNumbers选填string按征询号精确查询,每行一个(如 N4008426R1026);返回该号全部通知(原件/修订/授标,含已归档)。设置后忽略搜索过滤 - Notice ID 或 SAM.gov URL 查询
noticeIds选填string32 位 notice id 或 https://sam.gov/opp/.../view URL,每行一个。设置后忽略搜索过滤 - 最大结果数
maxOpportunities选填integer本次最多采集的机会数;单次 SAM.gov 查询上限 1 万条,更大批量请用日期窗口分批范围1–10000默认值100示例100 - 排序
sortBy选填string最近更新(-modifiedDate,适合每日增量)或相关度(-relevance,配关键词)默认值-modifiedDate示例-modifiedDate - 含完整详情
fetchDetails选填boolean保留以兼容原 Actor:搜索记录本身即含联系人/描述/授标数据,开关只影响是否包含描述文本字段默认值true示例true - 含附件直链
includeAttachmentUrls选填boolean需要配合下方 API Key;无 key 时 attachments 为空并在日志说明默认值true示例true - SAM.gov 公开 API Key(可选)
apiKey选填string官网 Account Details 免费申领的公开 key(非联邦账号 10 次/天)。仅用于解析附件下载直链;留空则 attachments 为空,其余功能完全不受影响 - 下载附件文件
downloadAttachments选填boolean本平台无文件输出通道,仅接受该字段并忽略(附件只列出直链不下载)默认值false示例false - 附件大小上限(MB)
maxAttachmentSizeMb选填integer兼容原 Actor 的字段;因附件不可下载,本字段被接受但忽略默认值25示例25 - 附件下载数上限
maxAttachmentDownloads选填integer兼容原 Actor 的字段;因附件不可下载,本字段被接受但忽略默认值200示例200 - 含描述文本
includeDescription选填boolean开启(默认)输出摘要与全文描述;关闭则两者留空(联系人/代码/附件仍输出)默认值true示例true - 监控模式:只出新通知/更新
onlyNew选填boolean记住已返回过的通知(monitorId 命名的本地状态),后续运行只返回新增或自上次以来更新的通知;适合定时增量默认值false示例false - 监控 ID
monitorId选填string该监视清单的名字,每个 ID 独立保存已见状态;仅监控模式使用默认值default示例default - 首次运行模式
firstRunMode选填string监控无历史状态时:emitAll 返回当前全部匹配(便于首次测试);baseline 静默记录全部、本次不返回,下次起只报变化默认值emitAll示例emitAll - Webhook URL
webhookUrl选填string可选;运行结束后 POST JSON 摘要(monitorId/newCount/updatedCount/itemsPushed/前 50 条)到 Slack/Zapier/Make/n8n/自建 API
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- Notice ID
noticeIdstringSAM.gov 32 位通知 ID - 标题
titlestring标题 - 公告类型名
noticeTypestringSolicitation / Combined Synopsis/Solicitation / Award Notice 等 - 公告类型码
noticeTypeCodestringo/k/p/r/s/a/u/g/i
调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/sam-gov-scraper",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。