Crs Reports

@pipeworx/crs-reports

議会調査局（CRS）の報告書 — 法令、連邦プログラム、政策選択肢に関する、議会自身による超党派の分析です。テーマ別に検索して全文を読むことができ、各回答には報告書の根拠、引用、ライセンス、経過年数が明記されています。

Pipeworx の一部です — AI エージェントを1679以上の稼働中データソースに接続するMCPゲートウェイです。

ツール

• crs_search(query?, topic?, product_class?, author?, published_since?, published_before?, limit?) — 報告書のタイトルと、CRSが各報告書とともに公開している要約を対象に、順位付けして検索します。 タイトル、報告書番号、CRSの主題トピック、著者、公開日、要約の抜粋を返します。順位付けの対象はタイトルと要約であり、報告書本文ではありません — そうでなければ検索結果がないときに「CRSはこれについて一度も書いていない」と受け取られる可能性があるため、この境界をすべての回答で searched として明示します。
• crs_report(report_id, include_text?, max_chars?) — 報告書番号（R43255、IF13006、LSB10123）を指定して、報告書1件の全文を取得します。現在のバージョンの完全なテキストに加え、著者、トピック、引用されている法案と公法、経過年数を返します。
• crs_recent(days?, topic?, product_class?, limit?) — CRSが最近公開または改訂したものを、新しい順に取得します。法案や規則に続く分析を追跡するための変更フィードです。
• crs_topics(facet?, limit?) — CRS独自の主題分類を、用語ごとの件数とともに取得します。また、アナリストと報告書の種類も取得できます。絞り込む前に呼び出してください。CRSは U.S. Trade Policy と記載するため、推測で入力した Trade では何も一致しません。

認証

Pipeworxゲートウェイでは、キーは不要です。 ゲートウェイがコーパス（報告書インデックスと抽出済みの報告書テキスト）を注入するため、ゲートウェイへの呼び出しに呼び出し元から渡すものはありません。

単体利用（npm i @pipeworx/mcp-crs-reports）では、api.data.govキーが必要です。 単体インストールにはコーパスのどちらの部分も含まれないため、このパックは米国議会図書館のAPIにフォールバックし、APIキーを必要とします。任意のツール呼び出しで _apiKey として渡してください。キーは https://api.data.gov/signup/ から無料で取得でき、1つのキーをapi.data.gov経由のすべてのAPIで利用できます。コーパスもキーもない場合、すべてのツールは {found: false, reason: "corpus_unavailable"} を返し、その旨を伝えます。

2つのモードは同じ回答ではないため、ラベルを付けています

すべての回答に mode が含まれます。値は corpus（ホスト型）または live_api（キーを使った単体利用）です。ライブモードでできないことは、機能を黙って制限するのではなく、回答に明記します。

	mode: "corpus"	mode: "live_api"
crs_report のテキスト	チェックサム検証済みの、抽出された報告書全文	CRS自身の summary のみ。text という名前では決して返しません。本文は pdf_url のPDFにあります
crs_search の対象範囲	すべてのタイトル と 要約を順位付けして検索	最新更新分からタイトルのみを検索します（リストエンドポイントにはクエリパラメーターがありません）。コーパスの総数に対して何件を読み取ったかを回答に明記します
topic / author フィルター	利用可能	指定された名前のフィルターは拒否します — これらの情報は各報告書のレコードにしかないため、適用するには14,000件の報告書ごとにリクエストが必要になります
crs_topics	用語ごとの件数を含む、完全な語彙	件数なしの product_class のみ

この拒否は意図的なものです。フィルター付きの質問に対してフィルターなしのリストを返すのは、正しいラベルを付けた誤答です。また、61,000文字の報告書が入るはずのフィールドに3,700文字の要約が入っていても、呼び出し元には気づかれません。

呼び出し中にコーパスの取得に失敗し、呼び出し元から _apiKey が渡されている場合、代わりにライブAPIから回答し、その旨を degraded_from_corpus で示します。

データソース

• https://api.congress.gov/v3/crsreport — 米国議会図書館が管理する各報告書のレコードです。タイトル、公開日、現行バージョン、著者、CRSの主題トピック、関連する法案と公法、CRS独自の要約が含まれます。api.data.gov経由です。
• https://www.congress.gov/crs_external_products/ — APIが示す報告書のPDFです。テキストは各報告書の現行バージョンから取得します。

データが示すことと示さないこと

CRS の分析には説得力がありますが、法的拘束力はありません。 法律ではなく、裁判所や政府機関を拘束するものでもありません。また、背景情報や立法の経緯として引用されています。すべての応答には authority.binding_status: "persuasive" と、この点を文章で説明する binding_note が含まれているため、後続のエージェントが CRS による法令の解説を法令そのものと取り違えることはありません。

対象は現在有効なレポート（2018 年から現在まで）です — 執筆時点で 14,115 件です。これは CRS が現在有効として掲載しているレポート数であり、過去の全アーカイブではありません。CRS によって撤回または差し替えられたレポートは対象から外れます。

ライセンス：不要です。 CRS のレポートは米国連邦政府の著作物であり、17 U.S.C. §105 により著作権の保護対象外となるため、license_terms.encumbered は false で、帰属表示も必要ありません。ただし、CRS 自身が記載し、このパックでも license_caveat に繰り返し記載している注意点が 1 つあります。個々のレポートに第三者の図表や写真が転載されている場合があり、それらには §105 は適用されません。

注意点、2026-09-15 時点の確認

取り込み処理（scripts/ingest-crs-reports.mjs）に手を入れる前に知っておくべき点：

• sort は受け付けられますが、無視されます。 sort=updateDate+asc、sort=updateDate+desc、意味のないパラメーターのいずれも、同じ先頭行を返します。一覧は常に updateDate の新しい順です。エラーは発生しないため、sort を前提とした並べ替えは間違っていても正しく見えてしまいます。
• fromDateTime／toDateTime は機能し、updateDate に基づいて絞り込みます。絞り込みなしでは 14,115 件ですが、fromDateTime=2026-09-01 では 585 件です。この組み合わせが変更フィードとなり、日次処理を差分で実行できます。
• updateDate は、末尾に Z が付いた America/New_York の現地時刻です。 抽出した 14 件のレポートすべてで、PDF の Last-Modified は updateDate より正確に 4 時間（EDT）または 5 時間（EST）後でした。秒単位まで一致しており、夏時間との相関があることから、固定の公開遅延ではないと分かります。PDF のヘッダーは同じイベントを実際の UTC で示しており、保存されるのはこの値です。
• 一覧を 1 回走査しても、コーパス全体は取得できません。 一覧は、申告どおり 14,115 行を返しますが、ID は 14,097 個しかありません。18 件が重複しており、重複する各ペアの updateDate は同じ値（2025-09-08T11:20:24Z）です。同じタイムスタンプで数千件が一括再公開されているため、並べ替えは updateDate のみを基準としており、同順位の場合の順序は安定しません。その結果、件数は完全に見えても、重複して取得されるレポートと同じくらいの数が取りこぼされます。取り込み処理では重複をまとめたうえで、再度走査します。
• 一覧行は、対応する詳細レコードより古い情報です。 IF12988 では数秒の差で、list.version は 1、list.updateDate は 22:09:04 ですが、currentVersion は 6、updateDate は 22:38:57 です。一覧から列挙し、値はすべて詳細レコードから取得してください。
• HTML 版にはアクセスできませんが、PDF は問題ありません。 /crs_external_products/<T>/HTML/<id>.html パスは、Worker の送信元からもノート PC からも、完全なブラウザーヘッダー一式の有無にかかわらず、Cf-Mitigated: challenge を伴う 403 を返します。一方、PDF のパスはどちらからも 200 を返します。PDF に対する単独の HEAD は 403 ですが、GET は 200 です。そのため、HEAD のみで確認すると、正常に機能しているパスまで利用不可と判断してしまいます。
• 短いレポートでは summary が文書全体を表しますが、長いレポートでは要約のみです。 R43255 の要約は 3,754 文字で、レポート全体は 61,691 文字です。すべての応答の text_source に、テキストの取得元となった版が示されています。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "crs-reports": {
      "url": "https://gateway.pipeworx.io/crs-reports/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/crs-reports/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx の共通メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック固有のツールとともに共通ツールがおよそ 30 個表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の状況を判断するうえでの正式な情報源です。

これは意図的なものであり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも対応できます。ask_pipeworx がカタログ全体からルーティングするため、MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1679+ 個のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/crs_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"tariffs"}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/crs_search を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "crs-reports": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-crs-reports"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-crs-reports

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答するのは、このパックのツールだけです。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールを使用しますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも使用できます。

ask_pipeworx({ question: "your question about Crs Reports data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT