~/public-data/courtlistener-scraper
CourtListener Scraper — 判決文・ドケット・全文データを取得
CourtListenerに対して米国の判決文、RECAPドケット、口頭弁論、裁判官、引用情報を検索——判決文の全文とRAG対応チャンク付き。裁判所、日付、キーワードでフィルタ可能です。
法律
TypeScriptCheerio
アメリカ
カテゴリpublic-data / 法律
言語TypeScript
スタックTypeScript, Cheerio
マーケットアメリカ
出力クリーンでRAG対応のJSON
主な機能
1つのアクターで6種類の検索タイプ — opinions（判決文）、dockets（RECAP）、RECAP文書、oral arguments（口頭弁論）、judges（裁判官）、citation（引用）検索
判決文の全文 — 300文字のスニペットではなく、検索ヒットからデータベースを辿って完全な判決文を取得
RAG対応のチャンク分割 — 約2000文字の段落チャンクごとに順序インデックスを付与
引用の解決 — 最大250件の引用文字列（例：576 U.S. 644）を該当する判例に解決
ブール演算による全文検索に加え、裁判所ID・提出日範囲・ソート順によるフィルタ
レート制限を考慮したペーシングと、CourtListenerの各レスポンス形式に対応した精緻な429バックオフ
設定した件数上限までのカーソルページネーションストリーミング
自分のトークンを持ち込むか、内蔵のローテーショントークンプールを利用可能
活用例
- 法律調査 — 裁判所・日付範囲・キーワードで判例全文を取得
- 訴訟インテリジェンス — 主題や日付ごとに裁判所のドケット活動を追跡
- リーガルAI・RAG — チャンク化されたエンベディング対応の判例コーパスを構築
- 引用分析 — 準備書面中の引用を、関連する判例レコードと被引用数に解決
- 実証的法学研究 — 裁判官、口頭弁論メタデータ、判決トレンド
- 法律ジャーナリズム — 特定の裁判所で新たに提出された判決文やドケットをモニタリング
入力パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
searchType | string | 任意 | 取得対象：opinions、dockets、recap_docs、oral_arguments、judges、citationのいずれか（デフォルト：opinions）。 |
query | string | 任意 | ブール演算子を使った全文検索クエリ — courtフィルタまたはcitation検索を使わない場合は必須。 |
citations | array | 任意 | 解決対象の引用文字列（最大250件） — citationモードでは必須。 |
court | string | 任意 | CourtListenerの裁判所ID。例：scotus、ca9、nyed。 |
dateFrom | string | 任意 | この日付以降に提出されたもの（YYYY-MM-DD）。 |
includeFullText | boolean | 任意 | 判決文の全文とRAGチャンクを取得（opinions用、デフォルト：false）。 |
apiToken | string | 任意 | 自分のCourtListener APIトークン。省略した場合は内蔵のローテーションプールにフォールバックします。 |
maxItems | number | 任意 | 保存するアイテムの最大数。1件ごとに1課金イベント（デフォルト：5）。 |
Output Example
1{
2 "itemType": "legal",
3 "searchType": "opinions",
4 "id": "10380001",
5 "title": "Climate United Fund v. Citibank, N.A.",
6 "court": "Court of Appeals for the D.C. Circuit",
7 "date": "2025-04-16",
8 "url": "https://www.courtlistener.com/opinion/10380001/...",
9 "citations": [],
10 "citeCount": 0,
11 "docketNumber": "23-5138",
12 "fullText": "...",
13 "chunks": [{ "text": "...", "order": 0 }],
14 "meta": { "courtId": "cadc", "clusterId": 10380001 }
15}
Pricing
イベント課金制——保存されたアイテムに対してのみ課金されます。
| イベント | 価格 | 内容 |
|---|---|---|
| 全文付き判決文 | $0.005 | 全文＋RAGチャンク付きで保存された判決文1件 |
| メタデータアイテム | $0.002 | ドケット、口頭弁論、裁判官、引用など、メタデータのみのレコード1件 |
1,000件の全文判決文コーパスで約$5.00。maxItemsが件数とコストの両方に上限を設けます。
Tips
includeFullTextは、実際にエンベディングする判決文だけでオンにしましょう。 判決文ごとに追加リクエストのコストがかかるため、デフォルトでは無効です——まず裁判所と日付で絞り込みましょう。- 準備書面の情報を充実させるには
citationモードを使いましょう。 引用文字列を貼り付ければ、1回の実行で関連する判例レコードと被引用数が得られます。 - 大規模なジョブには自分のCourtListenerトークンを持ち込みましょう——無料ティアの低いレート制限が、スループットの主なボトルネックです。
よくある質問
CourtListenerのAPIトークンは必要ですか？
CourtListener側で必須です。apiTokenで自分の無料トークンを渡すか、アクター内蔵のローテーションフォールバックプールを利用してください。自分のトークンを使えば、有料/会員ティアでスループットを引き上げられます。
全文はすべての検索タイプで取得できますか？
いいえ。全文とチャンク分割（includeFullText）はopinionsのみに適用され、実行を高速に保つためデフォルトでは無効です。dockets、RECAP文書、oral arguments、judges、citationの結果はメタデータのみを返します。
対象となる裁判所はどこですか？
CourtListenerがインデックスしているものすべてです——米国連邦裁判所（SCOTUS、控訴裁判所、RECAP経由の地方裁判所）に加え、多数の州裁判所を、scotus、ca9、nyedのようなCourtListener独自の裁判所IDでカバーしています。
どのくらいの速度で実行できますか？
スループットはトークンのレート制限に左右されます（CourtListenerの無料ティアは毎分数リクエスト程度）。429への自動バックオフを備えており、会員トークンを使えば上限が引き上げられます。