docketwatch

Name: docketwatch
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords法律与政务01 周前更新

代码仓库

关于 docketwatch

docketwatch 通过 Regulations.gov API v4 提供查询法规制定公开记录的 MCP 工具和命令行界面。它面向跟踪联邦案卷、文件、公众意见和开放意见期的用户，并返回 API 的 JSON 数据。

主要功能

01搜索文件、意见和案卷
02获取文件、意见及案卷详情
03按截止日期列出开放意见期
04获取分页的 FAR/DFARS 案件历史
05检查 API 密钥配置状态

适用场景

01跟踪某机构或案卷的文件和意见
02查找案卷并查看其元数据
03监控尚未结束的意见期
04查看 FAR/DFARS 案件相关文件

MCP 相关

MCP 服务提供九种工具，用于搜索和获取 Regulations.gov 记录、检查访问配置，以及汇总开放意见期和 FAR/DFARS 案件历史。数据请求需要免费的 `REGULATIONS_GOV_API_KEY`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-docketwatch": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/docketwatch"
      ]
    }
  }
}

启动命令npx -y @reneturcios/docketwatch

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/docketwatch0.1.0stdio

ocighcr.io/cloudcorprecords/docketwatch:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
sort	string	否	结果的排序方式（可选）。
agency_id	string	否	机构的标识符。
docket_id	string	否	案卷的标识符。
page_size	integer	否	每页的结果数（可选）。
page_number	integer	否	分页结果的页码（可选）。
posted_date	string	否	本次调用的发布日期。
search_term	string	否	搜索词。
posted_date_gte	string	否	本次调用的发布日期下限（gte）。
posted_date_lte	string	否	此调用的 posted date lte。
last_modified_date_gte	string	否	此调用的 last modified date gte。

详细介绍

docketwatch

无需一直开着浏览器标签页，也能跟进联邦规则制定记录。docketwatch 接入 Regulations.gov API v4——这是美国各机构发布规则背后的案卷、文件和公众意见的公开记录——并以 API 自身的 JSON 作答，因此这里的搜索结果与直接从 API 获取的内容相同。

你需要一个免费的 api.data.gov 密钥：

export REGULATIONS_GOV_API_KEY="<your key>"

在 https://api.data.gov/signup 获取密钥。每次数据调用都会通过 X-Api-Key 标头发送密钥。如果未设置此变量，服务仍会启动并列出工具，但每个数据工具都会回复设置说明，且完全不会发出请求——这便于在密钥尚未配置时检查客户端是否已正确连接。get_access_status 是个例外：它不会发出任何外部请求，只会报告 {"configured": true} 或 {"configured": false}，绝不会返回密钥本身。默认基础 URL 为 https://api.regulations.gov/v4，也可以通过 REGULATIONS_GOV_API_BASE 覆盖。

九个工具：

search_documents — 按关键词、机构、案卷以及发布/修改日期范围查找文件（拟议规则、规则、通知、支持材料）。
get_document_detail — 获取单个文件的完整信息；传入 include_attachments: true，即可请求 API 一并返回其附件。
search_comments — 按关键词、机构、案卷或被评论的文件搜索公众意见。
get_comment_detail — 获取单条意见的完整文本和提交者信息。
search_dockets — 按关键词或机构搜索规则制定和非规则制定案卷。
get_docket_detail — 获取单个案卷的元数据、摘要和 RIN。
open_comment_periods — **组合工具（已标注）：**并非单次 API 调用。它会分页检索最近 180 天内发布的文件（扫描时间范围由本地设置决定），保留意见征集期在今天或之后结束的文件，并按截止时间从近到远返回，同时附带 complete 和 truncated 标记。
far_case_history — **组合工具（已标注）：**获取 FAR/DFARS 案件案卷（例如 FAR-2023-0008）及该案卷所有分页的文件，合并后返回，并附带说明是否已读取所有分页的 complete 标记。
get_access_status — 上述密钥检查工具。

搜索参数采用扁平名称，对应 API 文档中的 filter[...] 参数；排序和分页使用 sort、page[number] 和 page[size]。过滤值区分大小写——API 对 EPA 和 epa 的处理不同——docketwatch 会原样传递这些值。

有一点需要说明：此版本所依据的 API 文档没有明确指定文件类型或案卷类型过滤参数的名称，因此不提供类型过滤参数。关键词、机构、案卷和日期过滤涵盖了文档明确说明的范围。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串（get_access_status 不接受参数）：

npx @reneturcios/docketwatch search_documents '{"agency_id":"EPA","search_term":"emissions"}'
npx @reneturcios/docketwatch get_document_detail '{"document_id":"EPA-HQ-OAR-2020-0001-0001","include_attachments":true}'
npx @reneturcios/docketwatch search_comments '{"docket_id":"EPA-HQ-OAR-2020-0001"}'
npx @reneturcios/docketwatch open_comment_periods '{"agency_id":"EPA","limit":20}'
npx @reneturcios/docketwatch far_case_history '{"case_number":"FAR-2023-0008"}'
npx @reneturcios/docketwatch get_access_status
npx @reneturcios/docketwatch --version

输出为工具的结果文本（所有工具均返回 JSON）。退出码：成功时为 0，运行时错误（包括验证失败、缺少密钥或上游错误）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/docketwatch mcp

MCP 客户端配置：

{
  "mcpServers": {
    "docketwatch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/docketwatch", "mcp"],
      "env": {
        "REGULATIONS_GOV_API_KEY": "<your key>"
      }
    }
  }
}

Docker

docker run -i -e REGULATIONS_GOV_API_KEY="<your key>" ghcr.io/cloudcorprecords/docketwatch
docker run --rm -e REGULATIONS_GOV_API_KEY="<your key>" ghcr.io/cloudcorprecords/docketwatch get_access_status

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake clock, no network)
npm run dev     # run the CLI from source