Sba Loans

@pipeworx/sba-loans

美国小型企业管理局（SBA）贷款数据——“这家企业是否获得了 SBA 贷款、贷款方是谁、金额多少，以及是否已还清”——取自 SBA 自行发布的 FOIA CSV 数据摘录。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1763+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也并非由其发布。

• 7(a) + 504（fleet #1921），每季度刷新。
• PPP（fleet #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、服务／发放贷款的贷款方、 批准日期、首次或第二次提款、豁免金额及日期。名称按首个单词匹配（"Sumter Coatings" 可查到 SUMTER COATINGS, INC.）；提供 zip 时，名称中的任意单词也可匹配。
• ppp_aggregate(group_by, state?, order_by?, limit?) — 按 naics | state | lender（服务贷款的贷款方）统计 PPP 总额，可查询全国或某个州。

每个 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 增加两项规则（fleet #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；真实 slug 中「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。 另外还有两个年代的数据（7(a) FY1991-1999、FY2000-2009；504 FY1991-2009， 另有约 520MB）——第一阶段暂不导入，以控制首次加载的规模； 如果后续有需求，可通过相同的转换脚本轻松添加。

• 没有开发者 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 会在贷款存续期间 修订的字段（状态、还清／核销日期、 核销金额）——因此，按季度重新导入时会通过 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 触发），因为此流程需要通过 GitHub Actions 密钥保存连接池连接字符串， 供 psql \copy 使用，而不能使用 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 中表示“已全额偿还”的写法不同：源数据中，7(a) 使用 "P I F"（带空格），而 504 使用 "PIF"（不带空格）。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 服务。目前无法挂载不含这些元工具的数据包端点；如果额外的模式定义带来的上下文成本高于路由的价值，请连接一次完整网关，而不要连接多个数据包端点。

或者连接完整的 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