license-verify-mcp

承包商许可证 + 保证金 + 保险核验（MCP，支持 Agent 付费）

唯一原生支持 MCP 的许可证核验工具，可返回州政府数据中的官方保证金和保险信息，而不只是有效/无效状态。按成功结果付费：完整结果 $0.03，仅状态 $0.01，未找到则免费。WA 已上线（官方 L&I），CA 为 Beta 版（CSLB）。

工具：verify_license、list_supported_jurisdictions。

快速入门

// Call
{ "tool": "verify_license", "jurisdiction": "WA", "license_number": "ECOSTSC758NN" }

// Response (abridged)
{
  "found": true,
  "result": {
    "status": "active",
    "bonded":  { "is_bonded": true, "details": "Surety: NORTH RIVER INSURANCE COMPANY THE; Amount: $30,000" },
    "insured": { "has_insurance": true, "details": "Carrier: State National Ins Co Inc; Coverage: $1,000,000" }
  }
}

结果	价格
完整（状态 + 保证金 + 保险）	$0.03
仅状态（未匹配到保证金/保险，或 statusOnly: true）	$0.01
未找到（found: false）	免费

---

适用州

州	状态	数据来源	保证金 + 保险
WA	✅ 已上线	WA L&I 开放数据（data.wa.gov）	✅ 真实数据（bzff-4fmt + ciwg-agsx 数据集）
CA	⚠️ Beta 版	CSLB HTML（cslb.ca.gov）	✅ CSLB 可用时解析

华盛顿州是可靠、可用于生产的适用州。 官方 WA L&I 开放数据通过 Socrata JSON 提供——无需抓取、没有速率限制，并通过专用数据集提供保证金和保险信息。

加利福尼亚州为 Beta 版。 CSLB 不提供开放 API；服务提供方会直接获取 HTML 详情页。CSLB 会间歇性地对自动请求进行速率限制或返回 503。若服务不可用，verify_license 会返回清晰的 SESSION_ERROR——数据源故障时绝不会向你收费。 在确认 CSLB 服务端运行稳定之前，请勿在生产工作流中依赖 CA。

---

Apify Actor

支持 Agentic-payments——按事件计费 + 权限有限 + 无 Standby 模式。

定价

事件	价格
license-verification	$0.03 — 完整结果（状态 + 保证金 + 保险）
status-only-result	$0.01 — 找到状态，未匹配到保证金/保险（或 statusOnly: true）

仅在 found: true 时收费。验证错误、未找到结果和数据源故障均不收费。

输入

{
  "jurisdiction": "WA",
  "license_number": "ECOSTSC758NN"
}

字段	类型	必填	说明
jurisdiction	"WA" | "CA"	✅	WA = 已上线；CA = Beta 版
license_number	string	↓ 中任选一项	WA：字母数字。CA：数字，≤8 位
business_name	string	↑ 中任选一项	仅 WA。部分匹配，可能返回 matches[]

输出（默认数据集）

{
  "found": true,
  "jurisdiction": "WA",
  "query": { "license_number": "ECOSTSC758NN" },
  "result": {
    "license_number": "ECOSTSC758NN",
    "business_name": "!ECO STAR C G CONSTRUCTION LLC",
    "status": "active",
    "license_type": "CONSTRUCTION CONTRACTOR",
    "bonded": {
      "is_bonded": true,
      "details": "Surety: NORTH RIVER INSURANCE COMPANY THE; Bond #: 46CF842686; Amount: $30,000; Effective: 2025-08-05; Expires: Until Canceled"
    },
    "insured": {
      "has_insurance": true,
      "details": "Carrier: State National Ins Co Inc; Policy: NXT9PTHTLT-01-GL; Coverage: $1,000,000; Agency: Next Insurance Inc; Effective: 2026-06-12; Expires: 2027-06-12"
    },
    "effective_date": "2025-08-15",
    "expiration_date": "2027-08-15"
  },
  "source_url": "https://data.wa.gov/resource/m8qx-ubtq",
  "retrieved_at": "2026-06-26T01:34:37.598Z",
  "raw": { ... }
}

status 的取值始终为：active | expired | suspended | revoked | unknown。

失败时：{ "found": false, "error": "SESSION_ERROR|NETWORK_ERROR|...", "message": "..." }——不会崩溃，也绝不会收费。

本地测试

npm install
npm run build
echo '{"jurisdiction":"WA","license_number":"ECOSTSC758NN"}' \
  > storage/key_value_stores/default/INPUT.json
npx apify run

---

MCP 服务（stdio）

可与 Claude Desktop、Smithery 或任何兼容 MCP 的 Agent 配合使用。

工具

verify_license — 核验承包商的许可证状态。

• jurisdiction（必填）："WA" 或 "CA"
• license_number 和/或 business_name（至少填写一项）

list_supported_jurisdictions — 列出所有州及其状态和数据来源。

配置（Claude Desktop）

{
  "mcpServers": {
    "license-verify": {
      "command": "node",
      "args": ["/absolute/path/to/license-verify-mcp/dist/index.js"]
    }
  }
}

运行

npm install && npm run build
npm run start:mcp   # stdio MCP server
npm run smoke       # hit real WA + CA endpoints, must be 8/8 PASS

---

添加州

1. 创建 src/providers/<CODE>.ts，实现 Provider 接口（{ info, verify() }）
2. 在 src/providers/index.ts 中注册

无需更改服务端或 Actor 的其他部分。

许可证

MIT