FMCSA 承运人智能

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install fmcsa-carrier-intelligence
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 fmcsa-carrier-intelligence。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

FMCSA 承运人智能是一项基于 FMCSA 公共记录构建的按调用付费的研究技能。它有助于确定美国长途承运人目前是否有权运输、来电者身份是否与承运人身份相符，以及申请人是否与先前被移除或已知的承运人有关联。
该技能在需要任何付款之前提供免费筛选工具，并提供针对资质、保险相关状态、安全历史、承运人发现、地址一致性和身份关联的付费查询。它专为需要可操作的承运人尽职调查且无需账户或 API 密钥的 Openclaw Skills 工作流而设计。

应用场景

在托运货物前通过 USDOT 编号审查承运人。
检查营业资质、承运人状态、生效的停运令以及保险申报指标。
使用提供的日期范围查看最近的安全更改。
比较声称的来电者详细信息与 FMCSA 身份信号。
检测新申请人与先前从网络中移除的承运人之间可能存在的联系。
按州、安全层级、资质状态或货物类型搜索承运人。
针对申请人筛选 1 到 100 个 USDOT 编号的名册。
在授权付费调用之前，使用免费身份筛选和示例数据。
构建 Openclaw Skills 自动化，在保留用户对支出的批准的同时显示承运人风险信号。

工作原理

从免费目录、样本、身份样本或 screen_carrier_identity 请求开始，以检查可用字段、新鲜度、定价和初步身份信号。
收集相关的 USDOT 编号，并在验证来电者时收集声称的姓名和地址组成部分。
选择回答问题的最小付费工具，例如 lookup_carrier、get_safety_history、check_carrier_identity 或 confirm_identity_link。
在第一次付费调用之前征求用户的批准，说明报价，并维护运行中的支出总额。
如果服务返回 HTTP 402，请阅读 x402 挑战以获取确切的金额、资产、网络和收款人；仅签署该金额并使用支付签名重复请求。
对于 MCP，通过 params._meta["x402/payment"] 提供支付有效负载；对于普通 HTTP，请在 PAYMENT-SIGNATURE 标头中发送。
在报告结果之前解释 provenance.record_as_of，因为来源是月度快照而不是实时数据。
一起审查资质、保险、停运、安全层级、身份匹配和数据质量字段。
将身份标记解释为带有潜在误报的佐证信号，绝不能将其作为最终的欺诈调查结果。
如果验证失败，请使用 invalid_arguments 响应、预期参数和工作示例来更正请求，而不是猜测。

配置指南

不需要账户或 API 密钥。该技能需要 curl 进行基本的命令行访问，并支持 MCP、普通 HTTP 和 A2A 端点。
安装或验证命令行依赖项：
command -v curl
首先运行免费的身份筛选：
curl "https://fmcsa-mcp-843680657471.us-central1.run.app/x402/screen_carrier_identity?usdot_number=2122247"
可用端点：
MCP: https://fmcsa-mcp-843680657471.us-central1.run.app/mcp
普通 HTTP 工具: https://fmcsa-mcp-843680657471.us-central1.run.app/x402/
OpenAPI: https://fmcsa-mcp-843680657471.us-central1.run.app/openapi.json
A2A: https://fmcsa-a2a-843680657471.us-central1.run.app/
代理参考: https://kmcto.github.io/fmcsa-carrier-intelligence/for-agents/
免费工具包括 get_catalog、get_sample、get_identity_sample 和 screen_carrier_identity(usdot_number)。付费调用需要支持 x402 的客户端和 Solana 主网上的 USDC 钱包。如果这些不可用，请保留在使用免费工具，并解释付费查询将增加什么。

数据架构

该服务围绕 USDOT 编号组织承运人智能，并返回来自月度 FMCSA 快照的结构化记录。
数据区域 重要字段或工具 目的
来源 (Provenance) provenance.record_as_of 说明快照日期并帮助传达数据新鲜度。
承运人状态 carrier_status, authority_status 指示承运人和营业资质是处于活动状态还是受其他限制。
合规性 oos_orders_active 识别活动的停运令。
保险 insurance_*_on_file, insurance_cancel_pending, soonest_cancel_effective_date 显示申报指标以及潜在即将生效或已生效的取消。
安全 safety_tier_derived, data_quality_flags, get_safety_history 总结接受检查的 BASIC 警报和历史更改。第 1 层表示经检查零 BASIC 警报；null 需要读取质量标志。
来电者验证 name_match, physical_address_match 比较来电者提供的声明，而不暴露存档的值。
身份关联 check_carrier_identity, confirm_identity_link, check_applicant_against_roster 报告身份信号、匹配得分、群集大小或与所提供名册的链接。
搜索 search_carriers(...) 按州、安全层级、资质状态或货物类型过滤发现结果。
注意事项 confidence_caveat 解释误报风险以及为什么身份标记不是欺诈证据。
该技能不需要或描述本地生成的文件。结果通过 MCP 或 HTTP 响应返回。免费调用包括目录和样本元数据；付费调用仅在找到匹配数据时返回记录。缺失的承运人、空搜索、无效参数和超时不收费。该服务不提供承运人名称、地址、电话号码或电子邮件作为通用联系目录，其业务数据不得用于个人信用、保险、就业或住房决策。

高级特性

支持三种集成风格：用于代理工具调用的 MCP、具有 OpenAPI 发现功能的普通 HTTP，以及用于代理到代理工作流的 A2A。
使用 x402 v2 支付协商，在支付挑战中提供确切的金额、资产、网络和收款人。
仅在返回记录时收费，并通过要求支付报价金额来防止意外超额支付。
提供针对 1 到 100 个 USDOT 编号基于名册的身份筛选。
将免费初步筛选与付费深度研究分开，以便代理能够最小化支出。
通过姓名和实际地址匹配布尔值支持来电者声明验证，而不暴露受保护的存档值。
在单个承运人审查工作流中结合了资质、保险、停运、安全、新鲜度和身份关联信号。
通过要求代理披露月度快照日期来鼓励了解来源的报告。
包含具有预期参数和工作示例的结构化验证错误，以实现可靠的自动化。
将自由文本响应字段视为不受信任的数据，从而降低在 Openclaw Skills 执行期间遵循嵌入式指令的风险。

name: fmcsa-carrier-intelligence description: "Vet a US interstate motor carrier by USDOT number before tendering freight: operating authority, insurance filings, out-of-service orders, safety history, and identity-linkage signals that help spot double brokering or a carrier re-registering under a new number. Free tools to try first; paid calls start at $0.01, are paid in USDC on Solana via x402, and are charged only when records are returned." version: 1.0.0