WebLens

WebLens

AI エージェント向けのプレミアムなウェブインテリジェンス API。x402 のマイクロペイメントに対応しています。アカウントは不要です。Base または Solana 上の USDC でリクエストごとにお支払いください。

🌐 ライブ API： https://api.weblens.dev 📖 インタラクティブなドキュメント： https://api.weblens.dev/docs 🤖 エージェントガイド： https://api.weblens.dev/llms.txt 🔎 マーケットプレイス： x402scan に掲載

今すぐ無料で試す

ウォレットも登録も不要です。以下は IP ごとに 1 時間あたり 10 リクエストに制限されています。

curl https://api.weblens.dev/r/https://example.com     # any page as markdown
curl https://api.weblens.dev/s/cloudflare+workers      # web search

支払い前にプレビュー（無料）

エージェントが、返される内容を知るために API の呼び出しを購入する必要はありません。POST /preview は無料で、ライブ価格、1 行の要約、実際のレスポンス形式に沿ったサンプルを事前に返します。

curl -X POST https://api.weblens.dev/preview \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/answer"}'

{
  "endpoint": "/answer",
  "price": "$0.05",
  "currency": "USD",
  "summary": "A direct answer with inline [n] citations to real sources.",
  "sample": { "query": "...", "answer": "...", "citations": [], "confidence": 0.92 },
  "sampleType": "recorded",
  "livePreviewAvailable": false,
  "livePreviewHint": "This endpoint calls a paid upstream provider, so free live previews are not offered — the recorded sample shows the exact response shape."
}

ライブと記録済みの違い。 実際のライブプレビューを切り詰めて返すのは、限界コストが単純な取得処理であるエンドポイント（現在は /fetch/basic、/contents、/map）のみで、url を渡した場合に限られます。それ以外は従量課金制の上流サービス（Google の検索 API、Anthropic）を利用しているため、無料で実行すると上流のクレジットを消費します。そのため、記録済みのサンプルを返します。サンプルにはすべてのフィールド名と型が示されています。販売されていないエンドポイントは 404 を返します。

# live: the first 500 chars of the real result, for free
curl -X POST https://api.weblens.dev/preview \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/fetch/basic", "url": "https://example.com"}'

無料プランの他の機能と同様に、IP ごとに 1 時間あたり 10 リクエストに制限されています。

ERC-8004：レシートとフィードバック

ERC-8004（Trustless Agents）は、簡潔なシグナルをオンチェーンに、詳細なドキュメントをオフチェーンに保持します。WebLens はオフチェーン側を提供します。これはサービス運営者がコントラクトをデプロイせずに実行できる部分です。何が含まれ、何が含まれないのかを正確に述べると、WebLens はオンチェーンに登録されておらず、エージェント ID も保持せず、どのレジストリにも書き込みを行いません。

エンドポイント	提供内容
GET /.well-known/agent-registration.json	ERC-8004 登録ドキュメント：名前、説明、画像、サービス、x402Support、支払い情報、フィードバックエンドポイント。registrations は空（オンチェーン登録なし）で、supportedTrust は ["feedback"] です。
GET /receipts/{requestId}	支払い済みの呼び出しに対するレシート。エンドポイント、ステータス、結果、価格、支払い方法、ネットワーク、支払い先が含まれます。支払い済みのレスポンスにはすべて、ここを指す X-Receipt-Id ヘッダーと X-Receipt-Url ヘッダーが含まれます。30 日間保持されます。
POST /feedback	あなたが作成したフィードバックドキュメントをホストし、{feedbackURI, feedbackHash}（keccak-256）を返します。このペアは giveFeedback() が必要とするものです。必須フィールドは agentRegistry、agentId、clientAddress、createdAt、value、valueDecimals です。欠けているフィールドがある場合は、その名前を示して 400 を返します。
GET /feedback/{id}	そのドキュメントをバイト単位でそのまま提供するため、keccak-256 ハッシュは渡された feedbackHash と一致します。この URL が feedbackURI です。

明確にしておくべき点がほかに 2 つあります。

• レシートには署名がありません。レシートが示す決済 transaction が証拠であり、誰でもオンチェーンで確認できます。それ以外にトラストレスなものはありません。
• フィードバックドキュメントを作成して giveFeedback() を送信するのは、購入者です。WebLens はドキュメントをそのままホストし、ハッシュを返すだけです。フィードバックの作成、編集、送信は一切行いません。

エンドポイント

支払いが必要なエンドポイントはすべて、JSON ボディを使用する POST です。価格は USDC 建てで、リクエストごとに設定されています。

コア

エンドポイント	説明	価格
/fetch/basic	ウェブページをクリーンな Markdown として取得します	$0.002
/fetch/pro	JavaScript を完全にレンダリングして取得します（SPA）	$0.006
/contents	1～20 個の URL のページテキストをまとめて取得します	$0.0015/URL
/screenshot	ウェブページのスクリーンショットを撮影します（PNG）	$0.008
/map	サイトの URL を検出します（サイトマップ＋リンク。ページの取得は行いません）	$0.004
/domain	ドメインの登録情報＋DNS＋SaaS スタック＋リスクシグナルを取得します	$0.005
/tech	サイトのフレームワーク、CMS、CDN、分析、決済スタックを検出します	$0.005
/package	npm/PyPI パッケージの健全性を確認します：非推奨化、ダウンロード数、メンテナンス状況	$0.003
/discussions	トピックに関する Hacker News のストーリーを集計情報付きで取得します	$0.004
/intel/project	オフチェーンプロジェクトのデューデリジェンス：ドメインの運用年数、チーム／ホワイトペーパー、コントラクトの相互確認、A～F の評価	$0.05
/crawl	範囲を限定したサイト全体のクロール → ページごとの Markdown	$0.0015/ページ

検索

エンドポイント	説明	価格
/search	リアルタイムのウェブ検索（includeContent を指定するとページの Markdown を追加します。結果ごとに +$0.0015）	$0.005
/search/news	ソースと日付付きの Google News 記事	$0.005
/search/images	画像のサイズとソースページを含む検索結果	$0.005
/search/places	ローカルビジネス：住所、評価、電話番号、座標	$0.045
/search/shopping	価格、販売者、評価付きの商品	$0.005
/search/scholar	引用数付きの学術論文	$0.005
/search/autocomplete	クエリ候補（キーワード／インテント調査）	$0.004
/search/trends	時系列の関心度	$0.04

ソーシャル

エンドポイント	説明	価格
/social/youtube/transcript	タイムスタンプ付きの動画全編の文字起こし	$0.03

抽出と調査

エンドポイント	説明	価格
/extract	JSON スキーマに基づく構造化抽出	$0.03
/pdf	PDF からテキストとメタデータを抽出します	$0.004
/answer	インラインの [n] 引用付きの根拠に基づく回答	$0.05
/research/deep	引用付き調査：検索 1 回（quick）、またはサブ質問 → 各質問を検索（standard、deep）→ インラインの [n] 引用付きで回答	$0.08–$0.35

/research/deep は、処理に時間がかかる唯一のエンドポイントです。サブ質問を計画し、サブ質問ごとにウェブ検索を実行し、ソースを取得して重複を排除した後、引用付きの回答を合成します。これらすべてを 1 回の同期呼び出しで行います。standard の実行（サブ質問 3 件、ソース 8 件、$0.20）にはおよそ 30～60 秒かかり、deep（サブ質問 5 件、ソース 12 件、$0.35）ではさらに時間がかかります。HTTP タイムアウトは余裕を持って設定し（120 秒以上）、クライアント側でタイムアウトしても再試行しないでください。二重に課金されます。

インテリジェンス

エンドポイント	説明	価格

無料で認証不要：/、/health、/docs、/openapi.json、/llms.txt、/discovery、/.well-known/x402、/mcp、/r/{url}、/free/fetch、/preview、/.well-known/agent-registration.json、/receipts/{requestId}、/feedback、/feedback/{id}。

動的価格設定のエンドポイント（/fetch/pro、/extract）では、複雑さに応じた倍率が適用されます。ボット対策されたドメインでは最大 3 倍になります。フェッチ系のキャッシュ済みレスポンスは 70% 割安です。正確な価格は常に 402 チャレンジに記載されています。

AI エージェントで使用する（MCP）

リモート HTTP — インストール不要：

{ "mcpServers": { "weblens": { "url": "https://api.weblens.dev/mcp" } } }

API の使用

# Fetch a page as markdown
curl -X POST https://api.weblens.dev/fetch/basic \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Search, with page content included
curl -X POST https://api.weblens.dev/search \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news", "limit": 5, "includeContent": true}'

# Structured extraction
curl -X POST https://api.weblens.dev/extract \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/product",
       "schema": {"title": {"type": "string"}, "price": {"type": "number"}},
       "instructions": "Extract the product title and price"}'

# Crawl a site (pay for the page budget you request)
curl -X POST https://api.weblens.dev/crawl \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "limit": 10, "maxDepth": 2}'

# Deep research with inline citations (slow — 30-60s, so raise the client timeout)
curl --max-time 120 -X POST https://api.weblens.dev/research/deep \
  -H "Content-Type: application/json" \
  -d '{"query": "How are AI agents using micropayments in 2026?", "depth": "standard"}'

支払いを指定するまでは、それぞれ価格とともに 402 Payment Required を返します — 詳細は以下をご覧ください。

支払いの仕組み

WebLens は x402 v2 を実装しています。

1. 支払いなしで、有料エンドポイントに POST リクエストを送信します。
2. 価格、ネットワーク、アセット、支払い先アドレスを含む PAYMENT-REQUIRED ヘッダー付きの 402 Payment Required を受け取ります。
3. ウォレットで USDC の送金承認に署名します。
4. 同じリクエストを Payment-Signature ヘッダー付きで再試行します。
5. オンチェーンで支払いが検証され、データを受け取れます。

Base では、支払いは Coinbase の CDP ファシリテーターを通じて決済され、CDP が処理できない支払いは PayAI が引き継ぎます。Solana では PayAI を通じて決済されます。@x402/axios、@x402/fetch、または一連の処理を担う同梱の MCP サーバーなど、どの x402 v2 クライアントでも使用できます。

カードで支払う開発者向けの代替手段として、カード決済が有効な場合は前払い API キーを利用できます。POST /billing/checkout {"pack": "10"} を実行すると、10 ドル、50 ドル、または 100 ドルのパック用 Stripe Checkout リンクが返され、支払い後のページに API キーが一度だけ表示されます。有料エンドポイントには Authorization: Bearer <key> として送信してください。各呼び出しはリスト価格で残高から差し引かれ、失敗した呼び出しは返金されます。残高は GET /account で確認できます。

開発

pnpm install
pnpm run dev          # local dev server on :8787
pnpm run build        # tsc --noEmit (type check)
pnpm run lint         # eslint
pnpm run test         # vitest (unit + property + workerd integration)
pnpm run deploy       # wrangler deploy (production)

シークレットは wrangler で設定し、コミットしないでください。

wrangler secret put SERPER_API_KEY      # search and its verticals (Serper)
wrangler secret put SERP_API_KEY        # Google Trends + YouTube transcripts (SerpAPI)
wrangler secret put ANTHROPIC_API_KEY   # AI extraction, research, answers, intel
wrangler secret put CDP_API_KEY_ID      # optional: CDP facilitator fallback
wrangler secret put CDP_API_KEY_SECRET

変数	用途
PAY_TO_ADDRESS	支払いを受け取るウォレット（wrangler.toml の変数）
NETWORK	base（本番環境）または base-sepolia（テストネット）
SERPER_API_KEY	Serper キー — 検索、ニュース、画像、場所、ショッピング、学術情報、オートコンプリート
SERP_API_KEY	SerpAPI キー — Google Trends、YouTube の文字起こし
ANTHROPIC_API_KEY	Claude — 抽出、調査、回答、インテリジェンス
API_KEY_PREFIX	この環境で販売する API キーのプレフィックス（wl_live_ / wl_test_、wrangler.toml の変数）
STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET	任意：前払い API キーのカード決済（Stripe Managed Payments）。両方が設定されていない場合、/billing/* は 503 を返します
PAYAI_FACILITATOR_URL	任意：ファシリテーターのエンドポイントを上書きします

テストネットでのテスト

wrangler dev --env testnet          # Base Sepolia, fake USDC
API_URL=http://localhost:8787 PRIVATE_KEY=0x... npx tsx scripts/test-payment-testnet.ts

Base Sepolia の無料テストネット USDC は、Circle faucet から取得できます。

ディスカバリー

pnpm run verify-bazaar    # check the x402 discovery extension on every route

/openapi.json は x402scan 用のディスカバリードキュメントも兼ねています。info.x-guidance、操作ごとの x-payment-info、および無料の操作に対する security: [] が含まれています。WebLens は x402scan に掲載されており、PayAI ファシリテーターのカタログにも登録されています。

Coinbase CDP Bazaar に関する注意： ここにインデックスされるのは、CDP ファシリテーター自身が支払いを決済するサービスのみです。WebLens は主要なファシリテーターとして PayAI を使用しているため（CDP には Base メインネットで未解決の決済バグがあります。x402#1065）、ここには表示されません。

技術スタック

• Cloudflare Workers — エッジランタイム、Durable Objects、KV、Browser Rendering
• Hono — ウェブフレームワーク
• x402 — HTTP ネイティブのマイクロペイメント
• Zod — リクエストの検証
• Vitest + fast-check — 単体テスト、プロパティテスト、実際の workerd を使用した統合テスト

リンク

• API ドキュメント
• LLM 向けに最適化されたガイド
• サービスディスカバリー
• x402 プロトコル

ライセンス

MIT