Sba Loans

@pipeworx/sba-loans

米国中小企業庁（SBA）の融資データ。「この事業者はSBA融資を受けたか、どこから、いくら受け、完済したか」を、SBA独自の情報公開法（FOIA）CSV抽出データから確認できます。

Pipeworx の一部です。AI エージェントを1763以上の稼働中のデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携関係になく、同プロバイダーからの推奨や公開を受けたものでもありません。

• 7(a) + 504（フリート #1921）、四半期ごとに更新。
• PPP（フリート #2869）：事業者の借り手のみ、2024-09-30時点。

ツール

• sba_loan_lookup(borrower_name, state?, program?, limit?) — 借り手の 融資：金額、貸し手、承認日、ステータス、償却の詳細。
• sba_largest_loans(program?, naics_code?, state?, lender_name?, limit?) — 任意のフィルターを組み合わせて、融資額の大きい融資を検索します。
• sba_lender_league_table(program?, state?, naics_code?, limit?) — 貸し手を 融資件数と金額でランキングします。
• sba_charge_off_aggregate(group_by, program?, state?, naics_code?, limit?) — 償却率／金額をnaics | state | lender | programごとに集計します。
• ppp_loan_lookup(borrower_name, state?, zip?, limit?) — 事業者のPPP 融資：金額、jobs_reported、NAICS、サービシング／融資実行を行った貸し手、 承認日、第1回または第2回の融資実行、免除額と日付。名前は最初の単語から 一致します（"Sumter Coatings" で SUMTER COATINGS, INC. が見つかります）。zip を指定すると、名前の中の単語でも一致します。
• ppp_aggregate(group_by, state?, order_by?, limit?) — PPPの合計を naics | state | lender（サービシングを行った貸し手）ごとに、全国または州内で集計します。

すべてのPPPレスポンスにはdata_as_ofと、個人の借り手として除外された融資件数を示すcoverage行が含まれます。ミラーが読み込まれていない場合（または再読み込み中の場合）、PPPツールはppp_not_loadedで失敗します。空のテーブルをもとに「融資が見つからない」と回答することはありません。

認証

キーは不要です。ゲートウェイがこのパックにデータアクセスを自動的に提供します。呼び出し元が用意するキーはありません。PPPツールはホスト型ゲートウェイ経由でのみ動作します。スタンドアロンビルドでは、何も返さずにppp_unavailableと通知します。

個人データに関するルール（必須、Harris Countyの前例に準拠）

7(a)/504（および構築された場合はPPP）の借り手の多くは、会社ではなく個人である個人事業主です。住所（借り手側と貸し手側の両方：BorrStreet、BankStreet、CDC_Street、 ThirdPartyLender_Street）は取り込み時に削除されます — scripts/sba-loans-transform.pyは、出力する行にこれらのソース列を読み込まないため、ソースCSVの内容にかかわらず、保存された行やレスポンスに含まれることはありません。保持されるのは、事業者／借り手の名前、市、州、ZIP、NAICS、貸し手の識別情報、金額、日付、ステータスです。これはHarris Countyの民事事件記録に適用されたルールと同じです （supabase/migrations/dockets_005_harris_drop_pii.sql）。公開データの調達に関する恒常的なルールは、公開融資記録の一括データを対象としますが、個人の自宅住所の一括再配布は対象としません。

PPPでは2つのルールを追加（フリート #2869）

scripts/ppp/transform.pyは許可リストに記載された列のみを読み込むため、PPPファイルの住所列と所有者の属性列（Race、Ethnicity、Gender、Veteran）は読み込まれません。さらに、個人の借り手を削除します。対象は、SBAによって氏名が墨消しされた借り手（Exemption 6）、名前に事業者を示す表記がなく、個人事業主／自営業者／独立請負業者／単独メンバーのLLCである借り手、<person> DBA <business>、および名前が人物名らしく、名で始まるか名で終わるその他の借り手です。サンプルとして抽出した413,167行での測定結果：70%を保持、個人の借り手120,362件、人物名らしい借り手3,601件、墨消し済みの借り手33件を削除。実行のたびに件数が出力されます。

データソース

• https://data.sba.gov/dataset/7a-504-foia — データセットのページです。ポータルの落とし穴： CKAN のルート /dataset/7-a-504-foia（ハイフンあり）は 404 になります。実際のスラッグでは、 「7」と「a」の間にハイフンがありません。

• CSV の直接ダウンロード（ファイル名には四半期ごとの asof_YYMMDD スタンプが含まれます）： https://data.sba.gov/sites/default/files/uploaded_resources/FOIA_7a_FY2020_Present_asof_<stamp>.csv、 ..._FY2010_FY2019_...、および FOIA_504_FY2010_Present_asof_<stamp>.csv。 さらに 2 つの年代分（7(a) FY1991-1999、FY2000-2009、504 FY1991-2009、 約 520MB 分）が存在します。初回のロードを慎重に行うため、フェーズ 1 では取り込みませんでした。 需要があれば、同じ変換スクリプトを使って後から簡単に追加できます。

• 開発者向け API はありません。CSV の一括ダウンロードのみのデータソースです。

• PPP：https://data.sba.gov/dataset/ppp-foia — .../distribution/SBA-OCA-2022-07-001/public_150k_plus_<stamp>.csv および public_up_to_150k_{1..12}_<stamp>.csv（合計 5.33 GB、スタンプは 240930）。

取り込みハーネス

• supabase/migrations/195_sba_loans.sql — 統合された sba_loans テーブル（両方のプログラムに対応。504 の CDC と 7(a) の銀行は lender_name／lender_city／lender_state に正規化されます。504 の個別の ThirdPartyLender は同じ項目に無理に統合せず、専用のカラムに保持されます）と、上記のツールが呼び出す RPC 関数です。

• scripts/sba-loans-transform.py — プログラムごとの CSV を統合スキーマの CSV に変換し、決定論的な loan_key を計算します（ソースに自然な一意のローン ID はありません。LocationID は無関係なローン間で再利用される貸し手／営業所コードであり、ローン識別子ではないことを 2026-09-13 に実データで確認済みです）。 loan_key は特定のローンを識別するフィールド（プログラム、location_id、借り手、承認日、金額、NAICS）をハッシュ化し、SBA がローンの存続期間中に改訂するフィールド（ステータス、PIF／貸倒償却の日付、貸倒償却額）は除外します。そのため、四半期ごとの再取り込みでは行が重複するのではなく、ON CONFLICT (loan_key) DO UPDATE によってローンの結果がその場で更新されます。

• scripts/sba-loans-upsert.sh — ダウンロード → 変換 → ステージングテーブルから sba_loans へのバッチ処理による取り込みです（scripts/usaspending-upsert.sh と同様に、クラッシュとディスク容量の問題に安全な設計です。バッチごとにコミットされ、実行が失敗した場合はステージングテーブルを削除するため、Supabase のディスク容量を延々と消費し続けることはありません）。

• .github/workflows/sba-loans-refresh.yml — GitHub ホスト型ランナーで実行する四半期ごとの cron（手動実行／バックフィルには workflow_dispatch を使用）です。psql \copy に必要なプーラー接続文字列を GitHub Actions のシークレットとして保持する必要があるため、Cloudflare Worker では実行しません。

• PPP：.github/workflows/ppp-refresh.yml（手動実行。mode=build はドライラン、mode=load は PPP テーブルを置き換えます）で scripts/ppp/refresh.sh を実行します。処理は、ダウンロード → derive-given-names.py → transform.py → build-sqlite.py （schema.sql、事前計算済みの ppp_agg）→ チャンク単位のインポートと行数の検証です。個人データのルールに問題が再発した場合に取り込みを停止できるよう、最初に scripts/ppp/test_transform.py を実行します。

注意点

• 7(a) と 504 では、ソース内の「全額返済」の表記が異なります：「"P I F"」 （7(a) はスペースあり）と「"PIF"」（504 はスペースなし）です。sba_charge_off_aggregate は CHGOFF コードのみに依存しており、このコードは両方の プログラムで一貫しています（2026-09-13 にライブデータで確認：7(a) の サンプルでは CHGOFF/EXEMPT/CANCLD/"P I F" が 300/2,050/751/3,313、 504 の同等項目では 177/1,036/926/3,790）。ただし、ほかのステータス文字列も プログラム間で一致すると想定しないでください。
• 504 には SBAGuaranteedApproval、InitialInterestRate、 FixedorVariableInterestInd、RevolverStatus、SoldSecMrktInd がありません — これらの列は設計上、すべての 504 行で NULL です（7(a) 専用フィールドであり）、 データ品質の問題ではありません。
• このパックを finra、sec-adv、その他の金融データパックに統合しないでください — 担当機関も、ライセンス不要のパブリックドメインデータも異なり、独自のテーブルを 使用します。
• PPP の jobs_reported は、2020-21 年の申請時に自己申告された値です。申告時点の 従業員数であり、現在の人数や監査済みの数値ではありません。
• PPP の検索は、正規化した名前に対する前方一致です（アクセント記号を除去し、 & → AND に変換し、先頭の THE と末尾の Inc/LLC/Co を削除します）。 同じ正規化処理が transform.py と src/ppp.ts に実装されています。 scripts/ppp/name-norm-fixtures.json で両方の処理を固定しています。

クイックスタート

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

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

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

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

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

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx フルゲートウェイに接続してください：

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

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

MCP クライアントをお持ちでない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/sba_loan_lookup \
  -H 'Content-Type: application/json' \
  -d '{"borrower_name":"Ameripro Construction","state":"PA"}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/sba_loan_lookup を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

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

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

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

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

npx -y @pipeworx/mcp-sba-loans

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます — 上記のパックエンドポイントでも、フルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Sba Loans data" })

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

詳細情報

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

ライセンス

MIT