AgentScrape

AgentScrape

AI エージェント向けの従量課金制ウェブスクレイピング — 登録不要、API キー不要、必要なのは USDC だけです。

稼働中： agent-scrape.healingsunhaven.workers.dev

AI エージェントは AgentScrape を見つけ、Base 上で USDC を従量払いし、整った構造化データを受け取れます。アカウントも API キーも不要で、人間が介在する必要もありません。

2 つのプロトコルで、1 つのサービスを提供します。

• x402 対応 HTTP API — 生の HTTP を使用するエージェント向け
• MCP サーバー（Streamable HTTP トランスポート）— Claude Desktop、Cursor、Continue.dev、および MCP 対応フレームワーク向け

---

このサービスが必要な理由

従来のスクレイピング API は、人間が使うことを前提としています。

• メールアドレスで登録する
• 支払い方法を追加する
• API キーを管理する
• 月額サブスクリプションを契約する

AI エージェントには、こうしたことはできません。 エージェントにはウォレットがあり、ステーブルコインがあります。エージェントのために構築されたインフラストラクチャが必要です。

AgentScrape は 2 つのオープン標準に対応しています。

• x402 — HTTP ネイティブの決済プロトコルです。サーバーは決済要件とともに 402 を返し、エージェントが USDC の送金に署名し、ファシリテーターがオンチェーンで決済すると、データが返されます。すべての処理が 2 秒未満で完了します。
• MCP — 標準的なエージェントツールインターフェースです。エージェントはベンダーごとの SDK を使わずに、ツールを閲覧、検出、実行できます。

登録不要。API キー不要。サブスクリプション不要。必要なのは USDC だけです。

---

ツール

メインネット検証期間中、すべてのツールの料金は $0.001 USDC です。安定性が確認された後、料金を段階的に引き上げます（料金を参照）。

ツール	説明
scrape_webpage	任意の URL を Markdown、HTML、テキスト、または JSON にスクレイピングします
extract_structured_data	自然言語のプロンプトと JSON スキーマを使用した AI による構造化データ抽出（Groq + Llama 4 Scout）
screenshot_webpage	ビューポートを指定した PNG スクリーンショット（デスクトップ／モバイル／タブレット、ページ全体も指定可能）
extract_metadata	タイトル、説明、Open Graph、Twitter カード、JSON-LD、canonical URL
create_browser_session	Cookie と localStorage を保持するステートフルなブラウザーセッション
run_workflow	複数ステップのアトミックな実行：移動、クリック、入力、待機、スクロール、スクリーンショット、抽出、評価

---

クイックスタート — HTTP API

# Free service discovery (no payment)
curl https://agent-scrape.healingsunhaven.workers.dev/

# Paid call — without payment, returns 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"}'

# Free tier — first 10 calls per wallet, send your wallet in the X-402-Payer header
curl -X POST https://agent-scrape.healingsunhaven.workers.dev/scrape \
  -H "Content-Type: application/json" \
  -H "X-402-Payer: 0xYourBaseWalletAddress" \
  -d '{"url": "https://example.com", "format": "markdown"}'

---

クイックスタート — MCP

Streamable HTTP 経由で、MCP 対応クライアントに追加します。

{
  "mcpServers": {
    "agent-scrape": {
      "url": "https://agent-scrape.healingsunhaven.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

x402 の決済メタデータは、MCP の tools/list レスポンス内で通知されます。x402 対応ウォレットを設定すると、クライアントが決済ハンドシェイクを自動的に処理します。

---

検出

機械による検出のため、4 つの標準エンドポイントを公開しています（無料、認証不要）。

エンドポイント	用途
/	サービスプロファイル JSON（ツール、料金、ネットワーク、payTo）
/.well-known/x402（および .json エイリアス）	x402 マニフェスト — payTo、ネットワーク、ファシリテーター、有料ルート一覧
/openapi.json	従来のツール向け OpenAPI 3.1 仕様
/llms.txt	エージェント向けのプレーンテキスト説明

402 レスポンス自体に、base64 エンコードされた Payment-Required ヘッダーで正規の決済要件が含まれます。また、本文には検出用リンクを含む、人間が読めるエラーメッセージが記載されています。

---

アーキテクチャ

                ┌──────────────────────────────────┐
                │      Cloudflare Workers          │
                │      (global edge, 330+ POPs)    │
                │                                  │
AI Agent ───────┼─▶  GET  /                  (free)│
(HTTP)          ├─▶  GET  /.well-known/x402  (free)│
                ├─▶  GET  /openapi.json      (free)│
                ├─▶  GET  /llms.txt          (free)│
                ├─▶  POST /scrape         ($0.001) │
                ├─▶  POST /extract        ($0.001) │
                ├─▶  POST /screenshot     ($0.001) │
                ├─▶  POST /metadata       ($0.001) │
                ├─▶  POST /workflow       ($0.001) │
                ├─▶  POST /session        ($0.001) │
                │                                  │
AI Agent ───────┼─▶  POST /mcp                     │
(MCP)           │      • initialize                │
                │      • tools/list                │
                │      • tools/call (paid)         │
                │                                  │
                └──────────────┬───────────────────┘
                               │
              ┌────────────────┴─────────────────┐
              │                                  │
   Coinbase CDP facilitator       Browser Rendering API
   (api.cdp.coinbase.com/         Groq API (Llama 4 Scout)
    platform/v2/x402)             KV (sessions, free tier)
   Ed25519 JWT auth
   Settles USDC on Base
              │
              ▼
   payTo wallet 0x3F33...9E9a

スタック：

• ランタイム： Cloudflare Workers（V8 アイソレート、グローバルエッジ）
• HTTP フレームワーク： Hono + @x402/hono v2 決済ミドルウェア
• MCP フレームワーク： @modelcontextprotocol/sdk + agents/mcp、withX402 決済バインディングを使用
• Bazaar ディスカバリー： @x402/extensions — すべての有料ルートで入力スキーマと出力例を宣言します
• ブラウザー： Cloudflare Browser Rendering API + @cloudflare/puppeteer
• AI 抽出： Groq + Llama 4 Scout（17B、16E）
• ストレージ： Cloudflare KV（5 分間のレスポンスキャッシュ、ブラウザーセッション、無料枠のカウンター）
• ネットワーク： Base メインネット（eip155:8453）
• 資産： ネイティブ USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• ファシリテーター： Ed25519 JWT 認証を使用する Coinbase CDP（api.cdp.coinbase.com/platform/v2/x402）

---

無料枠

すべてのウォレットアドレスで、HTTP API の30 日あたり 10 回の無料呼び出しをご利用いただけます。Base ウォレットを X-402-Payer ヘッダーで渡してください。10 回を超えると、x402 による支払いが必要です。

無料枠は HTTP のみです。MCP 呼び出しでは、標準の x402 決済フローを利用します。

---

料金

ローンチ期間（メインネットでの最初の 48 時間）：ツール呼び出し 1 回あたり一律 $0.001。

検証後、料金は以下のとおり段階的に引き上げられます。

ツール	本番環境での料金
scrape_webpage	$0.003
extract_structured_data	$0.005
screenshot_webpage	$0.003
extract_metadata	$0.002
run_workflow	$0.008
create_browser_session	$0.001

一括割引（月 1K 回で 20％、10K 回で 40％）を予定しています。

---

x402 + MCP を選ぶ理由

従来の API	x402 + MCP
scraperapi.com で登録	MCP initialize で検出
クレジットカードを登録	ウォレットに USDC を保有
API キーを取得	キー不要
月額最低 $49	呼び出し 1 回あたり $0.001
レート制限を管理	従量課金、制限なし
人間が介在	エージェントが完全に自律的に動作

---

デプロイの検証

# Service identity
curl https://agent-scrape.healingsunhaven.workers.dev/ | jq .

# x402 manifest
curl https://agent-scrape.healingsunhaven.workers.dev/.well-known/x402 | jq .

# 402 challenge with x402 v2 headers
curl -i -X POST https://agent-scrape.healingsunhaven.workers.dev/scrape \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
# → HTTP 402, Payment-Required header (base64 JSON), Cache-Control: private, no-store

# CORS preflight (browser-based agents)
curl -i -X OPTIONS https://agent-scrape.healingsunhaven.workers.dev/scrape \
  -H "Origin: https://example.com" \
  -H "Access-Control-Request-Method: POST" \
  -H "Access-Control-Request-Headers: Content-Type,X-Payment"
# → HTTP 204, allow-headers includes X-Payment and Payment-Signature

---

ロードマップ

2026 年第 3 四半期：

• AgentParse — ドキュメント/PDF/OCR から Markdown への変換サービス（同じ x402 + MCP パターン）
• AgentSearch — 複数のバックエンドを使ったウェブ検索の集約
• LangChain 統合パッケージ（langchain-agent-scrape）

2026 年第 4 四半期：

• サブスクリプションバンドル（$2.50 でスクレイピング 1000 回）
• 複数資産への対応（Base 上の USDT、Arbitrum 上の USDC）
• 長時間実行ワークフロー向けの Webhook + 非同期レスポンスオプション

---

ローカルで実行

Node 22 以降、Workers と Browser Rendering が有効な Cloudflare アカウント、Groq API キー、Coinbase CDP API キーが必要です。

git clone https://github.com/hshintelligence/agent-scrape.git
cd agent-scrape
npm install

# Set secrets
npx wrangler secret put GROQ_API_KEY
npx wrangler secret put CDP_API_KEY_ID
npx wrangler secret put CDP_API_KEY_SECRET

# Local dev
npx wrangler dev

# Deploy
npx wrangler deploy

独自のウォレットを payTo として使用するには、src/index.ts の PAY_TO 定数を編集してください。

---

ライセンス

MIT — LICENSE を参照してください。

---

お問い合わせ

HSH Intelligence が開発し、Healing Sun Haven LLC（米国ワイオミング州）が運営しています。

• サービス： https://agent-scrape.healingsunhaven.workers.dev
• リポジトリ： https://github.com/hshintelligence/agent-scrape
• 一般的なお問い合わせ： [email protected]

---

AI エージェント向けの従量課金制ウェブスクレイピング — 登録不要、API キー不要、USDC のみ。

ElizaOS から AgentScrape を使用する

ElizaOS は、@elizaos/plugin-mcp プラグインを通じて、リモート MCP サーバーを標準でサポートしています。AgentScrape はそのまま動作するため、カスタム統合は不要です。

MCP プラグインをインストールする

bun add @elizaos/plugin-mcp
# or
npm install @elizaos/plugin-mcp

AgentScrape を使用するようキャラクターを設定する

ElizaOS のキャラクター JSON にプラグインを追加し、MCP サーバー設定を AgentScrape の Streamable HTTP エンドポイントに指定します。

{
  "name": "ResearchAgent",
  "plugins": ["@elizaos/plugin-mcp"],
  "settings": {
    "mcp": {
      "servers": {
        "agentscrape": {
          "type": "streamable-http",
          "name": "AgentScrape",
          "url": "https://agent-scrape.healingsunhaven.workers.dev/mcp",
          "timeout": 60
        }
      }
    }
  }
}

利用可能なツール（ElizaOS により自動検出）

設定が完了すると、エージェントは 6 つすべての AgentScrape ツールを自動的に検出します。

ツール	料金	用途
scrape_webpage	$0.003 USDC	Markdown／HTML／テキスト／JSON のスクレイピング
extract_structured_data	$0.005 USDC	Groq + Llama 4 Scout による AI 抽出
screenshot_webpage	$0.003 USDC	ビューポート制御に対応した PNG スクリーンショット
extract_metadata	$0.002 USDC	タイトル、OG、Twitter、JSON-LD
create_browser_session	$0.001 USDC	状態を保持するブラウザーセッション
run_workflow	$0.008 USDC	最大 20 ステップの複数ステップからなるアトミックなワークフロー

無料利用枠

最初の 30 日間は、ウォレットごとに最初の 10 回の呼び出しが無料です。それ以降の呼び出しは、x402 v2 決済プロトコルを介して Base メインネット（eip155:8453）上で USDC により決済されます。決済するには、再試行時に x402 の決済レシートを含む X-PAYMENT-RESPONSE ヘッダーを指定します。これは標準的な x402 のフローです。

プロンプトの例

プラグインを接続すると、ElizaOS エージェントは AgentScrape を透過的に利用できます。

ユーザー：「https://www.x402.org をスクレイピングして、2 文で要約してください。」

ElizaOS は @elizaos/plugin-mcp を介してリクエストを処理し、AgentScrape の scrape_webpage ツールを呼び出します。エージェントは、ページの最新コンテンツに基づいて回答します。

リソース

• AgentScrape Worker：https://agent-scrape.healingsunhaven.workers.dev
• x402 マニフェスト：https://agent-scrape.healingsunhaven.workers.dev/.well-known/x402.json
• A2A エージェントカード：https://agent-scrape.healingsunhaven.workers.dev/.well-known/agent.json
• ソース：https://github.com/hshintelligence/agent-scrape