Skip to main content
WorldMonitor 将开放机会与历史近期授标分开处理。开放机会显示在独立的 Global Procurement 面板中,是面向未来、由定时种子任务维护的数据流;授标记录仍在 Economic 面板中来自 USASpending。 Global Procurement 是 Pro 功能。免费用户会看到标准登录或升级门槛,RPC 还会在服务器端独立验证有效的一级订阅。浏览器仅在 Pro 权限有效时请求并保留招标数据;退出登录或降级会清除面板数据及其内存响应缓存。近期授标仍保留在免费的 Economic 面板中。 Pro 用户可以搜索标题和描述,按买方、两位国家代码和来源筛选,选择排序方式,并分页浏览完整结果集。面板不会直接读取 Upstash,而是调用分页 RPC,由 RPC 读取规范化的种子快照。

覆盖范围与新鲜度

初始适配器读取官方公开采购来源: Railway 种子任务每小时运行一次,并把规范快照写入 economic:global-tenders:v1。其三小时 TTL 能在单次任务失败时保留最近一次成功结果。若某个适配器失败,该来源最后一次成功的数据会与其他健康来源的结果一起保留,响应会报告 availability: "partial";若全部适配器失败,则以 availability: "stale" 提供最后一次成功的数据。 availability 的含义如下:
  • available:所有已配置适配器均成功且至少返回一条公告。
  • empty:已配置适配器均成功,但没有返回公告。
  • partial:至少一个适配器不可用或失败,另一个适配器成功。
  • stale:当前所有来源请求均失败,因此正在提供最后一次成功的数据。
  • unavailable:没有可用的新鲜规范快照。
数据流响应会包含每个来源的状态、记录数、最近请求时间、最近成功时间和过期标记。每个来源的种子键也会独立注册到 /api/health。对未覆盖国家的筛选绝不会被解释为确认的零机会。

部署配置

只有美国 SAM.gov 适配器需要新凭据:
  1. 登录 SAM.gov,打开 Account Details,输入账户密码以查看 API 密钥控件。
  2. 请求 Public API Key;SAM.gov 会在 Account Details 页面显示生成的密钥。
  3. 在运行 node scripts/seed-bundle-relay-backup.mjs 的 Railway 服务中添加 SAM_GOV_API_KEY。不要通过 VITE_ 变量公开,也不要提交到仓库。
官方步骤和请求限制见 GSA Get Opportunities Public API 指南。TED、Contracts Finder、CanadaBuys、GETS 和世界银行无需 API 密钥。若未配置 SAM_GOV_API_KEY,只有 SAM 来源会显示为 unavailable,其他适配器仍会正常运行。 不配置 SAM 是受支持的状态,而非降级:/api/health 会将该来源报告为 NOT_CONFIGURED(绿色,不计入 problems),而不是错误。因此,从未申请 GSA 密钥的部署仍会得到干净的健康端点。添加密钥后,下一次种子运行即自动转为 OK,无需修改任何健康配置。

澳大利亚:AusTender 适配器目前被上游阻塞

目前无法安全地上线官方澳大利亚 austender 适配器:没有任何允许自动复用的 AusTender 机器可读接口发布开放机会记录所必需的截止时间。以下为截至 2026-07-13 的证据:
  • 官方 AusTender 当前 ATM RSS 数据流(https://www.tenders.gov.au/public_data/rss/rss.xml,由澳大利亚财政部在 data.gov.au 注册)只发布公告标题、官方链接、自由文本描述和发布日期,不包含截止时间、买方或分类字段。
  • 官方 AusTender OCDS API 仅提供 2013 年以来已授予的合同公告,而非开放的市场招标(ATM)。
  • data.gov.au 上机器可读的开放 ATM 导出数据止于 2014 年 6 月。
  • 截止时间只出现在逐条公告的 HTML 页面上;提取它们意味着抓取 AusTender 网站——这不是文档化的机器可读复用接口,也被本数据流的非目标明确排除。
本数据流绝不表示没有可验证未来截止时间的记录,因此澳大利亚覆盖保持缺失而不是被推断,也不会用新西兰 GETS 数据替代澳大利亚覆盖。按 country=AU 筛选时保持未观测国家的标准 countryCoverage: "unknown" 语义。一旦 AusTender 通过机器可读渠道发布截止时间,该适配器即可在不改动管道的情况下上线。

API

GET /api/economic/v1/list-global-tenders 仅向 Pro 开放、有意采用分页,且不会进入启动批量载荷。它支持 country、重复的 countriesregionsourcestatusbuyerpublished_frompublished_todeadline_fromdeadline_tomin_valuemax_valuecurrencycategoryquerymin_automation_scorepage_sizecursorsort 支持的排序方式为 newestclosing_soonestimated_valuerelevancepage_size 最大为 100。响应包含已应用的筛选条件、游标、快照时间、可用性和各来源健康摘要。 每条记录都含有稳定的 WorldMonitor ID(source:sourceNoticeId)、官方公告链接、来源公告 ID、上游提供时的金额字段、时间戳、分类数据和可追溯的来源名称。缺失的上游字段保持缺失,不会被推断填补。

MCP 工具

get_procurement_opportunities 向已认证的 MCP 客户端暴露同一条规范路由;它绝不直接读取 economic:global-tenders:v1。其上下文预算有意设为默认 10 条紧凑机会,最多 25 条。它公开 country、重复的 countriessourcequerybuyerdeadline_fromdeadline_tosortmin_automation_scorepage_sizecursor 紧凑投影省略描述文本、资格要求和提交 URL,同时保留每条机会的官方 URL、来源、标题、买方、日期、金额、分类、领域、participationMode 和精简的 automationFit。它还保留游标分页、totalappliedFilterscountryCoverage、可用性、快照时间和来源健康摘要。25 条的 MCP 上限有意小于 REST 路由 100 条的上限。 MCP 工具与 HTTP 路由一样仅限 Pro,且不属于 bootstrap。无筛选工具调用会保留所有开放机会;min_automation_score 始终是可选项。完整参数契约见 MCP 工具参考

WebMCP 浏览器工具

full、tech 和 finance 的全新默认布局会包含全球采购面板。由于面板可跨变体寻址,有权益的用户也可以在其他变体上启用它。已连接、可见、数据就绪且空闲的面板可以暴露声明式 WebMCP 工具 search_procurement;其可选输入直接来自人工表单:各自最多 160 个字符的 querybuyer 文本、恰好由两个 ASCII 字母组成的 country^[A-Za-z]{2}$)、sourcesort 和布尔值 techRelevant 智能体调用开始后,同一表单及其声明属性会一直保留到浏览器拥有的响应 Promise 完成;并发调用会收到可重试的 request_in_progress 结果。隐藏、锁定或销毁面板会使工具不可用;在没有活动智能体调用时,普通加载状态会移除该声明。 调用会明显激活并提交同一表单,经规范请求路径执行,并且只返回匹配数、覆盖范围、已应用筛选、可用性和来源状态的受限摘要。重置/取消会中止待处理工作。它不暴露隐藏招标内容,也不绕过 Pro 权益。精确浏览器 schema 和生命周期见 WebMCP

技术相关性

automationFit 是针对软件、AI、数据、网络安全、自动化、云服务及相关术语的透明关键词相关性信号。它包含评分、分类版本、匹配理由和文本证据,不是法律意见或采购资格判断;除非上游来源明确提供,participationMode 始终为 unknown 可选的 min_automation_score 查询参数(1–100 的整数;超出上限会被截断,非整数值会被忽略)仅返回 automationFit.score 达到阈值的机会。它默认关闭,因此现有调用方继续收到所有匹配的开放机会;启用时会出现在响应的 appliedFilters 中。独立面板以 Technology relevant only 复选框提供该筛选。该筛选与每条记录的匹配理由仅表达关键词相关性证据,绝不表示任何 AI 系统、代理或供应商具有投标资格。 仪表板只会在 URL 通过安全处理后显示官方公告链接,并会同时展示与来源提供机会详情对应的相关性理由。