Clerk：为AI智能体打造的联邦法院记录数据层

Clerk是一个基于x402支付协议的AI原生法律数据层，提供对5亿+美国联邦法院记录的无许可访问，支持AI智能体通过USDC微支付按需查询法律数据，无需API密钥或订阅。

• 原作者/维护者：Berripituitary963
• 来源平台：github
• 原始标题：clerk
• 原始链接：https://github.com/Berripituitary963/clerk
• 来源发布时间/更新时间：2026-05-30T15:15:44Z

原作者与来源

• 原作者/维护者：Berripituitary963
• 来源平台：github
• 原始标题：clerk
• 原始链接：https://github.com/Berripituitary963/clerk
• 来源发布时间/更新时间：2026-05-30T15:15:44Z 原作者与来源\n\n- 原作者/维护者：Berripituitary963\n- 来源平台：GitHub\n- 原始标题：clerk\n- 原始链接：https://github.com/Berripituitary963/clerk\n- 来源发布时间/更新时间：2026-05-30\n\n项目背景与核心定位\n\n随着AI智能体（AI Agents）在各个领域的广泛应用，法律数据的获取成为构建法律智能工作流的关键瓶颈。传统法律数据服务通常需要复杂的API密钥管理、昂贵的订阅费用和繁琐的审批流程，这对于自动化运行的AI智能体来说是不可接受的障碍。\n\nClerk项目应运而生，它是一个专为"智能体经济"（Agentic Economy）设计的AI原生法律数据层。该项目的核心理念是：让AI智能体能够像人类使用搜索引擎一样，无需身份认证即可访问海量的法律数据，并通过加密货币微支付实现按查询付费。\n\n技术架构与数据覆盖\n\nClerk提供了对美国联邦法院系统的全面数据覆盖，具体包括：\n\n- 数据规模：超过5亿条美国联邦法院记录\n- 法院覆盖：94个联邦地区法院和上诉法院\n- API端点：11个核心数据端点，涵盖案件搜索、卷宗详情、当事人查询、法官档案、判例引用、庭审记录等\n\n核心API端点一览\n\n| 端点 | 功能描述 | 查询费用 |\n|------|----------|----------|\n| /search | 联邦案件搜索 | $0.001 USDC |\n| /docket/{id} | 完整卷宗详情 | $0.001 USDC |\n| /parties | 当事人/实体查询 | $0.001 USDC |\n| /judges | 法官档案查询 | $0.001 USDC |\n| /citations | 判例与先例查询 | $0.001 USDC |\n| /opinion/{id} | 完整判决书文本 | $0.001 USDC |\n| /filings/{id} | 卷宗时间线 | $0.001 USDC |\n| /oral-arguments | 庭审口头辩论记录 | $0.001 USDC |\n| /document/{id} | 文档下载 | $0.001 USDC |\n| /court/{id} | 法院元数据 | $0.001 USDC |\n| /health | 服务健康检查 | 免费 |\n\nx402支付协议：无许可访问的关键创新\n\nClerk最引人注目的技术特性是其基于x402协议的支付机制。x402是一种HTTP支付协议，灵感来自HTTP 402"需要付款"状态码，专为机器对机器（M2M）支付场景设计。\n\n支付流程工作原理\n\n1. 智能体发起请求：AI智能体向Clerk API发送数据查询请求\n2. 402响应触发：服务器返回402状态码，附带支付要求（$0.001 USDC）\n3. 自动支付：智能体钱包自动签署并广播USDC转账交易\n4. 请求重试：携带交易哈希的请求自动重试\n5. 数据返回：验证支付后，JSON格式数据返回给智能体\n\n整个过程无需人工干预，实现了真正的"无许可"（Permissionless）访问。开发者不需要注册账号、申请API密钥或签署服务协议，只需在智能体中集成Clerk SDK并确保钱包有足够USDC即可。\n\n技术实现示例\n\npython\nfrom clerk_api import ClerkClient\n\n演示模式：无需支付，适合测试\nclient = ClerkClient()\ncases = client.search(\"SEC v Ripple\")\n\n生产模式：使用已支付的交易哈希\nclient = ClerkClient(tx_hash=os.environ[\"CLERK_PAYMENT_TX\"])\ndocket = client.docket(\"67614382\")\n\n\n$CLERK代币：免费无限访问的通行证\n\n除了按查询付费模式，Clerk还引入了原生代币$CLERK，用于激励长期用户和生态系统参与者：\n\n- 免费无限访问：持有1亿+$CLERK的钱包可以完全绕过单次查询付费，享受所有端点的无限免费访问\n- 自动检测：协议自动检测请求钱包的$CLERK余额，无需额外配置\n- 代币合约：部署在Base链上，合约地址为0x20EabA9d6818529cfFFA2c1C63B97A02a0049bA3\n\n这种双轨制设计既保证了小额用户的灵活性（按需付费），又为重度用户提供了成本优势（持币免费）。\n\n委托签名模式：生产环境的安全实践\n\n对于大规模运行的AI智能体，安全密钥管理至关重要。Clerk推荐采用"委托签名钱包"（Delegated Signer）模式：\n\n- 主钱包冷存储：持有$CLERK代币的主钱包保持离线状态\n- 代理钱包执行：创建专门用于签名的新钱包，仅持有少量gas费\n- 权限分离：即使代理钱包泄露，损失仅限于少量gas费，主钱包资产安全\n\nbash\n批量注册委托钱包\npython examples/register_delegates.py --csv my_agents.csv\n\n\n应用场景与实用价值\n\nClerk为多种AI应用场景提供了法律数据基础设施：\n\n1. 法律研究与合规分析\nAI智能体可以自动检索相关判例、分析法官裁决模式、追踪特定类型案件的审理趋势，为律师事务所和企业法务部门提供研究支持。\n\n2. 金融监管追踪\n通过实时监控SEC等监管机构的诉讼动态，AI智能体可以帮助金融机构及时发现合规风险，例如追踪针对加密货币项目的执法行动。\n\n3. 投资尽职调查\n风险投资和对冲基金可以利用Clerk自动查询投资标的或交易对手的诉讼历史，评估法律风险。\n\n4. 新闻与舆情监测\n媒体机构可以设置自动化工作流，追踪特定公司、人物或行业的法律动态，第一时间发现新闻线索。\n\n局限性与注意事项\n\n尽管Clerk提供了强大的法律数据访问能力，用户仍需注意以下限制：\n\n- 联邦法院限定：仅覆盖联邦法院系统，不包括州法院记录\n- 公开记录原则：仅提供公开可访问的记录，密封卷宗不予暴露\n- 非法律建议：Clerk提供的是原始数据，法律解释和策略建议仍需执业律师提供\n\n总结与展望\n\nClerk代表了AI基础设施发展的一个重要方向：为机器智能体提供无需人类中介的数据访问能力。通过结合区块链支付、无许可架构和海量法律数据，Clerk不仅解决了API访问的摩擦问题，更展示了"智能体经济"中数据服务的新范式。\n\n随着AI智能体在金融、法律、咨询等领域的渗透加深，类似Clerk这样的专用数据层将变得越来越重要。未来，我们可能会看到更多垂直领域的数据服务采用类似的x402支付模式，真正实现"机器自主获取数据、自主完成支付、自主创造价值"的闭环。