logo

SAM.gov 美国联邦合同机会采集与监控

采集 SAM.gov 联邦合同机会(征询书/RFP/RFQ/来源征寻/预征询/特别通知/授标通知):关键词、NAICS、PSC、预留类别、公告类型、机构、履约州、发布与截止日期窗口过滤;含合同官姓名/邮箱/电话、全文描述、NAICS/PSC、履约地、中标方 UEI/CAGE/金额;支持按征询号或 notice id/URL 查询、批量名单合并、增量监控(只出新通知/更新通知)。数据源为 SAM.gov 官网自有免登录搜索后端,无需账号/代理

发布者
价格
¥0.1 / 条
最近更新
2026-11-18

概览

与 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. 1单条查询/详情失败只影响该条:记录日志并继续,不中断运行
  2. 2SAM.gov 后端偶发连接抖动自动重试(最多 3 次)
  3. 3keywords 与 listUrl 都为空且无查询项 → 拉取过滤条件下最新 100 条(与 Actor 行为一致)
  4. 4监控状态文件损坏时视为全新监控重新基线化,不报错

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • 搜索关键词keywords选填string
    搜索词,如 'software development'、'cybersecurity'。每行一次独立搜索,结果合并去重;留空 = 在其余过滤条件下匹配全部
  • 关键词匹配keywordMode选填string
    ANY = 任一词(SAM.gov 默认);ALL = 全部词;EXACT = 精确短语(本地复核)
    默认值ANY示例ANY
  • 关键词列表(批量)keywordList选填string
    每行一个(多行文本):keywords 输入框的数组替代形式,每项一次独立搜索
  • 批量名单 URL(CSV/表格)listUrl选填string
    CSV/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选填string
    active=仅开放(默认)、inactive=仅归档、all=两者;设置后覆盖 activeOnly
  • 发布于近 N 天postedWithinDays选填integer
    只返回近 N 天内发布或更新的通知;设置'发布起'后忽略。1–3650
    默认值30示例30
  • 发布起postedFrom选填string
    YYYY-MM-DD、'today' 或相对值如 '7 days'(=7 天前);设置后覆盖'发布于近 N 天'
  • 发布止postedTo选填string
    YYYY-MM-DD、'today' 或相对值如 '2 days'
  • 响应截止起responseDeadlineFrom选填string
    YYYY-MM-DD、'today' 或相对值如 '3 days'(=3 天后);用 'today' 可跳过已来不及投标的征询
  • 响应截止止responseDeadlineTo选填string
    YYYY-MM-DD 或相对值如 '30 days'
  • 征询号查询solicitationNumbers选填string
    按征询号精确查询,每行一个(如 N4008426R1026);返回该号全部通知(原件/修订/授标,含已归档)。设置后忽略搜索过滤
  • Notice ID 或 SAM.gov URL 查询noticeIds选填string
    32 位 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
  • 监控 IDmonitorId选填string
    该监视清单的名字,每个 ID 独立保存已见状态;仅监控模式使用
    默认值default示例default
  • 首次运行模式firstRunMode选填string
    监控无历史状态时:emitAll 返回当前全部匹配(便于首次测试);baseline 静默记录全部、本次不返回,下次起只报变化
    默认值emitAll示例emitAll
  • Webhook URLwebhookUrl选填string
    可选;运行结束后 POST JSON 摘要(monitorId/newCount/updatedCount/itemsPushed/前 50 条)到 Slack/Zapier/Make/n8n/自建 API

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • Notice IDnoticeIdstring
    SAM.gov 32 位通知 ID
  • 标题titlestring
    标题
  • 公告类型名noticeTypestring
    Solicitation / Combined Synopsis/Solicitation / Award Notice 等
  • 公告类型码noticeTypeCodestring
    o/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 配置
{
  "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)。

价格

每个合同机会记录

按实际成功返回的数据条数计费,任务失败不计费。

¥0.1/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.1 / 条