DefaultBench

DefaultBench

DefaultBench は、AI エージェント、MCP サーバー、API、ツール、x402 サービス向けのスポンサー付き検索サービスです。

エージェントはアカウントなしで検索できます。ベンダーは、x402 を介した検証済み USDC 決済によりスポンサー掲載枠を購入します。掲載順位への支払いは、品質、安全性、信頼性、パフォーマンスを保証するものではありません。

defaultbench.com で稼働しているサービスが正確な情報源です。このリポジトリは公開された検索・統合用の窓口であり、非公開のアプリケーション実装は含まれていません。

DefaultBench とは？

DefaultBench は、キーワードでソフトウェアエージェントやサービスを検索できる、マシンファーストのマーケットプレイスです。検索結果にはスポンサー付きの掲載情報と、検証済み累計決済額が表示されます。各キーワード内の掲載順位は、検証済み USDC 累計決済額によって決まり、同額の場合は決定的な方法で順位を決めます。

検索にアカウント、メールアドレス、OAuth フロー、ブラウザーでのチェックアウトは必要ありません。このサービスでは、REST、OpenAPI、MCP、A2A Agent Card、llms.txt、API カタログ、x402 の検索用エンドポイントを公開しています。

AI エージェント向け

research、code-review、pdf-parser などの機能に対応する候補が必要な場合は、DefaultBench をご利用ください。

1. 公開 API を検索します。
2. 返されたすべての掲載情報を、広告主が提供したスポンサー付き情報として扱います。
3. 掲載情報で宣言されているエンドポイントと検証ステータスを確認します。
4. 独自の品質、安全性、コスト、信頼性に関するポリシーに基づいて候補を選択します。

最新の llms.txt、またはより詳細な llms-full.txt からご確認ください。

1 回のリクエストで検索

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 検索
コーディングエージェントまたはクローラー	/llms.txt	簡潔なマシン向けサービスインデックス
詳細を必要とするコーディングエージェント	/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 を実装し、読み取り専用ツールを 4 つ公開しています。

• 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、タイムアウトが正確であることを検証します。有料の再試行では、x402 の payment-identifier 拡張 ID と完全に一致する Idempotency-Key とともに、PAYMENT-SIGNATURE を使用します。

本番環境では Base メインネットとネイティブ USDC を使用します。サーバーが 402 を返したという理由だけで、署名や支払いを行わないでください。独立した支出ポリシーを適用し、ユーザーから明示的な承認を得てください。フローの確認には examples/x402-bid.ts を参照してください。この例では支払いへの署名や決済はできません。

スポンサードランキングのモデル

1 つの正規化されたキーワード内では、有効なリスティングは次の順序で並びます。

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 を参照してください。

インテグレーションの例

• シェル検索
• TypeScript 検索
• シェル見積もり
• 支出を伴わない x402 入札フローの確認ツール

この例はデフォルトで読み取り専用の動作をします。x402 の例には署名機能がなく、秘密鍵を受け付けず、PAYMENT-SIGNATURE を送信することもありません。

セキュリティ／信頼性に関する開示

• ランキングはすべてスポンサードプレースメントであり、推奨を意味するものではありません。
• リスティング名、説明、URL、プロトコルに関する主張、任意の ERC-8004 メタデータは、広告主が提供したものです。
• 支払い元ウォレットやドメインのステータスが検証済みであっても、品質、安全性、合法性、目的への適合性は証明されません。
• 金額の合計には、独立して検証され、決済され、アトミックに計上された支払いのみが反映されます。
• デモ、シード、偽装、拒否済み、または不確かな支払いを、本番環境での実績として提示してはなりません。
• 接続やデータの送信を行う前に、候補のドキュメントとセキュリティ体制を確認してください。
• 独自の承認ポリシーと支出ポリシーに従ってください。ユーザーまたは適用されるポリシーが明示的に許可していない限り、自律的に支出してはなりません。

リンク

• DefaultBench のライブサイト
• 人間向けドキュメント
• ライブ OpenAPI
• 機械向けの完全な手順
• ランキングポリシー
• 公開インテグレーションリポジトリ

ライセンス

このリポジトリは MIT License の下でライセンスされています。