CFPB consumer complaints

cfpb-complaints-analysis

CFPB の消費者苦情データベースをクリーンな Parquet 形式で提供し、AI アシスタントがデータを照会できる MCP サーバーも備えています。苦情は 1,820 万件（2011 年から現在まで）、消費者のナラティブは 385 万件です。

含まれるデータ

レイヤー	ソース	対象範囲
構造化された苦情	CFPB の公開苦情ファイル、files.consumerfinance.gov/ccdb/complaints.csv.zip	苦情 18,239,728 件、受付期間 2011-12-01～2026-10-07（更新するには再構築してください）
ナラティブ	CFPB FOIA 閲覧室、「CFPB Consumer Complaint Database Narratives Archive」	ナラティブ 3,851,415 件、2026-08-14 までに公開。2015 年以前のものはありません

どちらも CFPB 独自のファイルです。第三者からのデータは含まれていません。CFPB は、FOIA の目的においてナラティブはパブリックドメインであると説明し、データページでは苦情データについて「誰でも自由に利用、分析し、構築に活用できます」と述べています。

ナラティブの公開終了

CFPB は 2026 年 9 月に苦情ナラティブの公開を停止しました（データベースリリース 24、およびナラティブと可視化の裁量による公開を終了するという 2026-08-14 の発表）。それまでに公開されたナラティブは FOIA 閲覧室に移されました。現在の苦情ファイルには、ナラティブの列はもうありません。

このプロジェクトでは、アーカイブされたナラティブを苦情 ID で現在の苦情データに結合します。そのため、次の点にご注意ください。

• ナラティブがあるのは、CFPB が 2026-08-14 までに公開していた苦情のみです。それ以降の苦情にはナラティブがなく、今後も追加されません。
• ナラティブがあった苦情は全体の半数未満です。消費者の同意が必要で、2015 年以前には公開されたナラティブがありませんでした。
• アーカイブの終盤は件数が減少しています。2026 年 5 月と 6 月は各約 17,000 件、7 月は約 10,000 件、8 月は 1 件です。これは CFPB のソースファイルに由来するため、2026 年のナラティブ件数はそれ以前の月と比較できません。
• ナラティブは CFPB によって個人情報が削除されており、個人データは XXXX と表示されます。
• CFPB の現在のファイルから再構築すると、構造化フィールドは引き続き更新されます。

利用方法

pip install cfpb-complaints-analysis
cfpb-complaints-mcp

初回実行時に、Parquet ファイル（約 700 MB）がホストされたサービスから ~/.cache/cfpb-complaints-analysis にダウンロードされます。別の場所から取得するには CFPB_DATA_URL を設定し、自分で作成したフォルダーを使うには CFPB_DATA_DIR を設定してください。サーバーは MCP クライアントに stdio コマンドとして追加するか、MCP レジストリに io.github.bnovarini/cfpb-complaints-analysis として登録されているホスト型エンドポイントを使用できます。

ツール：dataset_info、list_values、find_company、complaint_counts、trend、company_profile、compare_companies、search_narratives、count_narratives、get_complaint。

質問の例：Navy Federal と PenFed では、どのような苦情が寄せられていますか？Rocket に関する住宅ローンの苦情は、年ごとにどのように変化しましたか？信用組合で「overdraft fee」に言及している 2024 年のナラティブを検索してください。

CFPB のソースから自分でビルドするには、cfpb-complaints --data data build を実行してください。

数値を引用する前にお読みください

• 苦情は、検証されていない消費者の申し立てです。CFPB 自身もそのように説明しています。
• 件数はそのままの数値です。大企業には小企業より多くの苦情が寄せられますが、顧客数や口座数による正規化はされていません。
• CFPB は、複数の名称で登録されている企業があります。すべての名称を含めるには find_company と company_contains を使ってください。
• 最新月のデータは未確定です。苦情は引き続き企業に送付されており、「対応中」はステータスであって、結果を示すものではありません。
• キーワードによるナラティブ検索ではテキストをスキャンします。フィルターなしの検索には約 10 秒かかり、全年の件数を数えるには 30～45 秒かかります。日付、企業、または製品で絞り込むと大幅に速くなります。

照合

すべての件数を CFPB が公開している数値と照合しています。一致しない数値とその理由を含め、docs/AUDIT.md をご覧ください。

ライセンス

コードは MIT ライセンスです。データは CFPB のものです。