今日、AIエージェントがAPIを呼び出す際、壁にぶつかります。登録しましょう。キーを取得しましょう。回転を管理しましょう。ヒットレートの制限に達しましょう。実際の使用に合致しないサブスクリプションを払うしましょう。
そのモデルは、人間がダッシュボードをクリックするために作られました。エージェントには合いません。
私たちはただ、AgentScrapeをリリースしました。 — AIエージェント向けのペイパーセルルwebスクレイピングAPIで、x402決済プロトコルを使用しています。各コールはBaseメインネットで0.001USDCのコストがかかります。サインアップは不要です。APIキーはありません。エージェントはリクエストごとに支払いを行い、データを取得します.
この投稿は、x402の仕組み、私たちが作成したもの、そして現在すぐにAgentScrapeをあなたのエージェントに統合する方法についてです.
AIエージェントのAPIキーに関する問題
APIキーは静的な世界のために設計されました:一つの開発者、一つの製品、一つの請求。エージェントはすべての三つの仮定を破ります.
一つのLangChainエージェントは一つのタスクの中で三十種類もの異なるAPIを呼び出すかもしれません。各APIは自分自身のキー、自分自身の認証フロー、自分自身のサブスクリプションレベルを求めます。開発者はエージェントが必要とするAPIを予測し、それぞれにサインアップし、ローテーションロジックを設定する必要があります。
結果は、エージェントが有用な仕事をすることができない大量の貼り付けコードとなっています。さらに悪いことに、エージェントは開発者が事前に手配しなかったAPIを呼び出すことができません.
エージェントが本当に求めているのは、サービスを発見し、その価格を確認し、必要な正確なコールに支払い、その後進むためのプロトコルです。口座はありません。キーはありません。コミットメントはありません.
そのプロトコルは存在します。それはx402と呼ばれています。
60秒でx402がどのように機能するか
x402は、HTTP 402ステータスコード(1997年以来予約されておりほとんど使用されていない「支払いが要求されています」のコード)に基づいて構築された決済プロトコルです。
プロセスは以下の通りです:
- エージェントがAPIを呼び出します。 認証なし。
- APIはHTTP 402で応答します。体には価格($0.001)、ネットワーク(Base mainnet)、受信者のウォレットアドレス、および資産(USDC)が含まれます。
- エージェントがUSDCの送金承認書に署名するEIP-3009(ガスレス、オフチェーン署名)を使用して
-
エージェントが再試行します署名された支払いペイロードが入った
X-PAYMENTヘッダー。 - APIは、仲介サービスを通じて支払いを確認します。 はその後ブロックチェーン上に確定します。
- API はデータを返します。
中間者はすべてのブロックチェーンの相互作用を処理します。API サーバーは RPC ノード、ホットウォレット、または取引署名を必要としません。エージェントは、自ら保管するウォレット以外の場所でアカウントを必要としません。
Coinbase はプロダクション x402 中間者を運用しています。api.cdp.coinbase.com/platform/v2/x402は、ベースメインネットで手数料は一切かかりません。ただし、ネットワークの名目的なガスコストのみがかかり、買い手のためにそのコストを支援しています。
私たちが構築したもの:AgentScrape v0.6.0
AgentScrapeは、HTTP REST APIとMCP(Model Context Protocol)サーバーを通じて、6つの有料ツールを提供しています:
-
scrape_webpage— クリーンなHTML/Markdown/テキスト/JSON抽出 -
extract_structured_data— Groq + Llamaを使用したスキーマ定義によるJSON抽出 -
screenshot_webpage— ビューポート制御付きフルページPNGキャプチャ -
extract_metadata— Open Graph、Twitterカード、JSON-LD解析 -
create_browser_session— マルチステップフロー用の持続的なブラウザコンテキスト -
run_workflow— 1つの呼び出しで複合的なマルチステップ操作
各ツールは1回の呼び出しごとに0.001ドルかかります。各ウォレットあたり最初の10回の呼び出しは評価用に無料です.
The Stack
クラウドフロアワーカーで全てが動作しています:
- ランタイム: Cloudflare Workers (V8 isolate, global edge deployment)
- ブラウザ: Cloudflare Browser Rendering (managed headless Chrome)
-
HTTPフレームワーク: Hono v4 with
@x402/honov2 payment middleware -
MCPトランスポート:
agents/mcp+agents/x402は Cloudflare Agents SDK -
から提供されましたFacilitator:
api.cdp.coinbase.com/platform/v2/x402 -
Coinbase CDP でAuth:
joseEd25519 JWT で署名されました__JHSNS_SEG_f7ee0497_57__ (Web Crypto API を通じて Workers 互換性あり) - AI抽出: Groq 推論で Llama 4 Scout (17B) を使用しました
The Worker は ~1000 行の TypeScript です。総デプロイバンドル: 548 KB 圧縮済み。冷蔵開始: 72ms.
今すぐ試す
Claude Desktop、Cursor、または任何 MCP クライアントの MCP サーバーとして
Smithery を一つのコマンドでインストール:
npx -y @smithery/cli install hshintelligence/agentscrape --client claude
は、エージェントが直接呼び出せる有料ツールを6つ登録します。エージェントはCloudflareのagents/x402クライアントラッパーを通じて自動的に支払いを処理します——キーのプロンプトは決して表示されません.
直接HTTP APIとして
# 1. Request — get a 402 with payment requirements
curl -X POST https://agent-scrape.healingsunhaven.workers.dev/scrape \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","format":"markdown"}'
# Response:
# HTTP/2 402
# payment-required: <base64-encoded x402 v2 PaymentRequired>
payment-required はヘッダーとして完全なx402 v2決済要件オブジェクト(スキーム、ネットワーク、金額、USDC資産アドレス、payToウォレット、タイムアウト)をデコードします。
クライアントが @x402/fetch またはx402準拠のラッパーを使用している場合、決済をサインし自動的に再試行します。2回目の呼び出しでスカレプトデータが返されます。
無料プラン
もしウォレット設定なしでスクリーピングをテストしたい場合は、HTTP APIがウォレットごとに30日間10回の無料呼び出しを提供しています。任意の識別子を含むx402-payerヘッダーを設定してください:
curl -X POST https://agent-scrape.healingsunhaven.workers.dev/scrape \
-H "Content-Type: application/json" \
-H "x402-payer: my-test-id" \
-d '{"url":"https://news.ycombinator.com"}'
今回の配信で学んだこと
ビルドから他のチームの時間を節約できるいくつかのメモ:
CDPファシリテーターURLはapi.cdp.coinbase.com/platform/v2/x402 は x402.org/facilitator ではありません。 x402.org ファシリテーターはテストネットのみ(Base Sepolia, Solana Devnet)です。Base メインネットで本物のお金を使うには、CDP エンドポイントと CDP API キーが必要です。
認証は Ed25519 JWT で、API キー ヘッダーではありません。 認証/決済の各呼び出しには、iss: "cdp"、sub: <keyId>、aud: ["cdp_service"] という権利を持つ新たに署名された JWT が必要です。uri: "<METHOD> api.cdp.coinbase.com<path>" と 120秒の有効期限.
CDP は生の 88 文字の base64 キーを提供し、PKCS#8 PEM ではありません. jose ライブラリは PKCS#8 を必要とします。変換は簡単です:デコードされたキーの最初の 32 バイトを取得し、Ed25519 PKCS#8 ASN.1 プリフィックス (302e020100300506032b657004220420) を付加し、PEM ヘッダーで囲みます.
agents/x402 と @x402/core パッケージは同じですFacilitatorConfig インターフェース. あなたは一つの createAuthHeaders コールバックを書き、HTTPミドルウェア (HTTPFacilitatorClient) とMCPレイヤ (withX402) の両方に渡します.
Coinbase Bazaar (彼らの公式のx402発見ディレクトリ) は自動的にインデックス化します. PRも、フォームも、マニフェストファイルも不要です.bazaarResourceServerExtension を追加してdeclareDiscoveryExtension()ごとに、CDPを通じて1回の成功した決済を完了し、あなたのサービスがapi.cdp.coinbase.com/platform/v2/x402/discovery/resourcesに10分以内に表示されます。
AgentScrapeの次の進む場所
今日、すべてのツールは48時間の市場検証に対して$0.001のフラット価格で提供されています。決済データが入手次第、価格は1回の操作ごとの実際の計算コストを反映するタイアドされた構造に移行します。
私たちはまた、2つの隣接する製品を開発しています:AgentParse(PDF/OCR抽出)とAgentSearch(ウェブ+arXiv+GitHubを跨ぐ連合検索)。3つ全てが同じx402決済表面を共有するため、1つを採用するエージェントは他の2つを無料で利用できます.
エージェントを構築していて、APIキーの接着コードをスキップしたい場合は、AgentScrapeを試してみてください。レポジトリをスターログインし、Smitheryを通じてインストールするか、HTTPエンドポイントを直接呼び出してください。フィードバックとバグ報告は歓迎されます.
リンクス:












