DefaultBench

DefaultBench

DefaultBench 是面向 AI Agent、MCP 服务、API、工具和 x402 服务的赞助搜索平台。

Agent 无需账户即可搜索。供应商通过 x402 使用经过验证的 USDC 付款购买赞助展示位。付费排名并不代表对质量、安全性、可信度或性能的认可。

已部署的服务 defaultbench.com 是事实依据。本仓库是公开的发现与集成入口；其中不包含私有应用实现。

什么是 DefaultBench？

DefaultBench 是一个面向机器的市场，可通过关键词发现软件 Agent 和服务。搜索结果会显示赞助列表及其累计验证付款金额。在同一关键词下，列表按累计验证 USDC 付款金额排序；金额相同时，使用确定性的规则进行排序。

搜索无需账户、电子邮件、OAuth 流程或浏览器结账。该服务提供 REST、OpenAPI、MCP、A2A Agent Card、llms.txt、API 目录和 x402 发现入口。

面向 AI Agent

当你需要查找 research、code-review 或 pdf-parser 等能力的候选项时，可使用 DefaultBench：

1. 搜索公共 API。
2. 将所有返回的列表都视为广告商提供的赞助内容。
3. 检查列表中声明的端点和验证状态。
4. 根据自己的质量、安全性、成本和信任策略选择候选项。

请从实时的 llms.txt 或更详细的 llms-full.txt 开始。

一次请求即可搜索

curl --fail-with-body --get \
  --data-urlencode 'q=research' \
  'https://defaultbench.com/api/v1/search'

搜索无需身份验证，且机器可读。结果包括匹配的关键词市场、赞助列表、每个列表的排名以及游标分页。请参阅 examples/search.sh 和 examples/search.ts。

机器入口

客户端	实时入口	用途
REST 客户端	/api/v1/search	搜索、检查列表、关键词排名、报价、活动和统计信息
OpenAPI 客户端	/openapi.json	权威的结构化 HTTP 契约
MCP 主机	/mcp	通过远程 Streamable HTTP 使用只读发现工具
A2A 客户端	/.well-known/agent-card.json	发现 HTTP+JSON A2A 接口的 Agent Card
编码 Agent 或爬虫	/llms.txt	精简的、面向机器的服务索引
需要详细信息的编码 Agent	/llms-full.txt	完整的协议、付款和重试指南
API 目录客户端	/.well-known/api-catalog	RFC 9727 链接集发现

完整入口图请参阅 docs/discovery.md。

MCP

DefaultBench 提供的远程 Streamable HTTP MCP 服务位于：

https://defaultbench.com/mcp

它实现了 MCP 2026-07-28，并提供四个只读工具：

• search_agents
• inspect_keyword
• quote_rank
• get_listing

付费写入操作刻意不作为 MCP 工具提供；竞价仍是明确的 x402 REST 流程。注册清单见 server.json。

OpenAPI

使用实时的 OpenAPI 3.1.1 文档生成客户端，或查看架构和错误代码。本仓库不会分叉该契约，因为复制的规范会逐渐过时。

x402

付费端点为：

POST /api/v1/keywords/{keyword}/bids

未签名的请求会返回 HTTP 402 和 PAYMENT-REQUIRED x402 v2 挑战。客户端会在授权任何操作之前，验证确切的网络、USDC 资产、收款方、金额、资源 URL 和超时时间。付费重试会使用 PAYMENT-SIGNATURE，以及与 x402 payment-identifier 扩展 ID 完全相同的 Idempotency-Key。

生产环境使用 Base 主网和原生 USDC。切勿仅因服务端返回 402 就签名或付款；应执行独立的支出策略，并获得用户明确授权。请参阅 examples/x402-bid.ts，该示例可检查流程，但无法签名或结算付款。

赞助排名模型

在同一个规范化关键词内，活跃列表按以下顺序排列：

1. 累计验证通过的 USDC 付款金额，降序；
2. 当前累计总额达成的时间，升序；
3. 创建时间，升序；
4. 列表 ID，升序。

搜索相关性用于选择匹配的关键词市场；它不会将付费排名转换为质量评分。报价是快照，不是预留。结算时的事务具有最终效力。

请在 docs/ranking.md 中查看具体行为。

示例工作流

# 1. Search without authentication.
./examples/search.sh research

# 2. Inspect a read-only quote. This does not reserve rank or spend USDC.
./examples/quote.sh research

# 3. Evaluate returned candidates under your own policy.
# 4. Only if explicitly authorized, use an x402-compatible client and a strict spend cap.

框架作者请参阅 docs/integrating-defaultbench.md。

集成示例

• Shell 搜索
• TypeScript 搜索
• Shell 报价
• 不涉及支出的 x402 竞价流程检查器

这些示例默认采用只读行为。x402 示例不包含签名器，不接受私钥，也绝不会发送 PAYMENT-SIGNATURE。

安全 / 信任声明

• 所有排名均为赞助展示，不代表背书。
• 列表名称、描述、URL、协议声明和可选的 ERC-8004 元数据均由广告方提供。
• 付款方钱包已验证或域名状态正常，并不能证明其质量、安全性、合法性或适用性。
• 财务总额仅基于独立验证、已结算且已原子入账的付款。
• 演示、种子、虚假、被拒绝或状态不确定的付款不得作为生产活动展示。
• 在连接候选对象或发送数据之前，请查阅其自身文档并评估其安全状况。
• 遵守你自己的授权和支出策略。除非用户或控制策略明确许可，否则切勿自主支出。

链接

• DefaultBench 在线版
• 面向用户的文档
• OpenAPI 在线版
• 完整机器指令
• 排名策略
• 公开集成仓库

许可证

本仓库采用 MIT 许可证授权。