关于 mcp-contractor-license-lookup
面向查询五个州公共牌照记录的 MCP 服务,支持按行业和地点列出承包商,也可按牌照号或企业名称核验;任务通过 Apify 执行。
主要功能
- 01按行业和地点列出持牌承包商
- 02按牌照号或企业名称核验
- 03返回状态、到期日、分类和联系方式
- 04支持 CA、TX、WA、OR 和 LA
适用场景
- 01建立某县的屋顶承包商名单
- 02核验承包商的牌照状态
- 03查找 HVAC 承包商及联系方式
MCP 相关
向 MCP 客户端提供 `lookup_contractor_licenses` 工具。它启动 Apify Actor、等待运行完成并返回数据集行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
1收录的工具列表 · 更新于 4 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mode | enum | 否 | list(默认):输入州和行业,输出持证承包商。lookup:输入许可证编号或企业名称,输出其许可证。list | lookup |
| cities | array | 否 | 列表模式。仅保留这些城市中的承包商;每个城市会单独搜索。 |
| county | string | 否 | 列表模式。仅保留该县的承包商(CA、TX 和 OR 记录县信息)。 |
| states | array | 否 | 州代码:CA、TX、WA、OR、LA。在 lookup 模式下,用于未注明州的行。 |
| trades | array | 否 | 列表模式。行业名称,例如 plumbing、electrical、hvac、roofing、general、solar、landscaping、painting、concrete 或 pool。 |
| lookups | array | 否 | 查询模式。每行一项:州代码、竖线、许可证编号或企业名称,例如 WA | 04CONCL862CR 或 LA | Acadian Builders。 |
| proxy_mode | enum | 否 | auto 使用 Apify 代理,并将被拒绝的请求转至住宅地址;residential 仅使用住宅代理。这是可靠性选项;使用代理不会增加费用。默认值为 auto。auto | residential |
| active_only | enum | 否 | 仅保留有效且未过期的许可证。默认值为 true。true | false |
| max_results | string | 否 | 每次搜索返回的许可证行数,最多 5000 条。每条许可证行都会计费。列表模式下默认值为 100,查询模式下为 10。 |
| business_name | string | 否 | 列表模式:仅保留包含此文本的名称。查询模式:再查询一个企业名称。 |
| include_owners | enum | 否 | 华盛顿州:读取每个许可证当前的负责人。默认值为 true。true | false |
| license_number | string | 否 | 查询模式。在 states 中搜索另一个许可证编号。 |
| max_charge_usd | string | 否 | 可选。若任何一行会使费用超过此金额,则在返回该行前停止运行。 |
详细介绍
承包商执照查询 MCP 服务
这是一个适用于 Apify 上 Mamba Labs 承包商执照查询 Actor 的 MCP 服务。提供州和行业类别,即可列出持证承包商;提供执照号码或企业名称,即可核验执照。每次运行都会读取州执照委员会自己的公开登记册。
内容
功能
有两种模式:
- list:提供
states和trades(例如 CA 和 roofing),还可选提供cities或county。每位持证承包商会占一行,包含执照号码、状态、到期日期、分类、所有者或资格负责人、地址和电话。 - lookup:提供
lookups,每行一个,例如WA | 04CONCL862CR或LA | Acadian Builders。系统会返回匹配的执照及其状态。
覆盖的州:加利福尼亚州(CSLB Data Portal 列表)、得克萨斯州(TDLR 开放数据)、华盛顿州(Labor and Industries 开放数据)、俄勒冈州(CCB 开放数据)和路易斯安那州(LSLBC 公共查询)。由于 CSLB 执照核验页面使用 reCAPTCHA,加利福尼亚州的名称和号码查询仅支持在行业列表中进行。每次搜索结束时都会附带一条免费的摘要行。所有工作都在 Apify 上运行。此软件包是一个轻量级客户端,用于启动 Actor 运行、等待运行完成,并返回数据集行。
快速开始
你需要 Node.js 18 或更高版本,以及一个带有 API 令牌的 Apify 账户。
将以下内容添加到 Claude Desktop 配置文件(claude_desktop_config.json)、Cursor 或任何 MCP 客户端中:
{
"mcpServers": {
"mamba-contractor-license-lookup": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-contractor-license-lookup"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
重启客户端。随后即可看到 lookup_contractor_licenses 工具。
先决条件
- Node.js 18 或更高版本。
- 从 console.apify.com/account/integrations 获取 Apify API 令牌,并将其设为
APIFY_TOKEN。服务无需令牌即可列出工具;调用工具时则需要令牌。
提示词示例
- “列出加利福尼亚州圣迭戈县持证的屋顶承包商。”
- “华盛顿州承包商执照 04CONCL862CR 是否有效?主要负责人有哪些?”
- “查找得克萨斯州奥斯汀持证的暖通空调承包商及其电话号码。”
工具
lookup_contractor_licenses。仅有一个工具。参数示例:
{
"mode": "list",
"states": ["CA"],
"trades": ["roofing"],
"county": "San Diego",
"max_results": "100"
}
输入项
该 Actor 面向买家的所有输入项,均保持不变。省略的输入项将使用 Actor 自身的默认值。数字和布尔值均以字符串形式发送。
| 输入项 | 类型 | 描述 |
|---|---|---|
mode | string | list(默认)或 lookup |
states | array | CA、TX、WA、OR、LA |
trades | array | list 模式。行业关键词 |
cities | array | list 模式。城市,分别搜索 |
county | string | list 模式。县(CA、TX、OR) |
business_name | string | list 模式:名称筛选。lookup 模式:额外的一个名称 |
lookups | array | lookup 模式。类似 WA | 04CONCL862CR 的条目 |
license_number | string | lookup 模式。额外的一个许可证编号 |
active_only | string | true 或 false。默认 true |
include_owners | string | 华盛顿州负责人。默认 true |
max_results | string | 每次搜索的行数,上限为 5000 |
max_charge_usd | string | 可选的本次运行费用上限 |
proxy_mode | string | auto 或 residential。默认 auto |
定价
在 Apify 上按事件付费,费用计入你的 Apify 账户。价格以美元计。
| 事件 | 免费计划 | Bronze | Silver | Gold |
|---|---|---|---|---|
license-row,每条返回的许可证 | $0.004 | $0.0038 | $0.0036 | $0.0034 |
apify-actor-start,每次运行启动 | $0.0005 | $0.0005 | $0.0005 | $0.0005 |
搜索汇总行,以及跳过、受阻和无结果的行,均免费。
你的密钥
该 Actor 无需密钥。它会读取各州委员会的公开登记信息,且不持有任何密钥。代理流量不会增加费用:Mamba Labs 支付本次运行的平台成本。proxy_mode 是一项可靠性设置。
Actor 完整文档
apify.com/mambalabs/contractor-license-lookup
许可证
MIT。参见 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。