docketwatch

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 で上書きできます。

9 つのツール：

• search_documents — キーワード、機関、ドケット、公開日／更新日の期間を指定して、文書（規則案、規則、告示、参考資料）を検索します。
• get_document_detail — 1 件の文書の詳細を取得します。API に添付ファイルを含めるよう指定するには、include_attachments: true を渡します。
• search_comments — キーワード、機関、ドケット、またはコメント対象の文書を指定して、公開コメントを検索します。
• get_comment_detail — 1 件のコメントの全文と提出者情報を取得します。
• search_dockets — キーワードまたは機関を指定して、規則制定および規則制定以外のドケットを検索します。
• get_docket_detail — 1 件のドケットのメタデータ、概要、RIN を取得します。
• open_comment_periods — 合成ツール（明示）： API 呼び出しを 1 回行うだけのツールではありません。過去 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 は値を変更せずにそのまま渡します。

正直に言うと、1 つ未対応の点があります。このビルドで使用した API ドキュメントには、文書タイプまたはドケットタイプのフィルターパラメーター名が明記されていないため、タイプフィルター引数は公開していません。キーワード、機関、ドケット、日付のフィルターで、文書化されている範囲をカバーしています。

CLI

各ツールは、JSON 引数文字列を 1 つ取るサブコマンドです（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

ライセンス

MIT — Copyright (c) 2026 Rene Turcios