Web Intel (x402)

Web Intel API (x402)

AI エージェント向けの従量課金 API です。各呼び出しの料金は、プロトコル x402 を通じて、あなたのウォレットから USDC で直接支払われます。クライアントにアカウント、API キー、KYC は不要です。

エンドポイント	価格	返される内容
GET /v1/extract?url=…	$0.002	タイトル、説明、クリーンなテキスト、見出し、リンク、Open Graph、JSON-LD
GET /v1/seo-audit?url=…	$0.005	SEO スコア 0-100、評価 A-F、問題の一覧
POST /v1/text-analysis {"text": "…"}	$0.001	言語、読みやすさ、キーワード、感情、統計情報
GET / と GET /health	無料	カタログとステータス

サービスが失敗した場合（たとえば、URL が存在しない場合）、クライアントに料金は請求されません。

1. ウォレットを設定する（あなたが行います）

MetaMask、Rabby、Coinbase Wallet などの EVM ウォレットの公開アドレス（0x…）だけが必要です。ここに秘密鍵やシードフレーズを記載しないでください。

cp .env.example .env
# edita .env y pon EVM_ADDRESS=0xTuDireccion

2. ローカルでテストする（テストネット、テスト用の資金）

npm install
npm test
npm run serve        # API HTTP en http://localhost:4021 (npm start = MCP por stdio)

テストネットで実際の支払いをテストするには：

1. テスト用の使い捨てウォレットを作成し、https://faucet.circle.com で Base Sepolia のテスト用 USDC を入手します。
2. 次を実行します：BUYER_PRIVATE_KEY=0xClaveDePrueba npx tsx scripts/pay.ts

3. Cloudflare Workers に無料でデプロイする

無料枠には、1 日あたり 100.000 件のリクエストが含まれます。

npx wrangler login                     # crea o entra en tu cuenta de Cloudflare (gratis)
npx wrangler secret put EVM_ADDRESS    # pega tu dirección pública
npm run deploy                         # te da una URL tipo https://web-intel-x402.<tu-sub>.workers.dev

4. 実際の資金で運用する（メインネット）

wrangler.toml の [vars] 内で：

X402_NETWORK = "mainnet"
FACILITATOR_URL = "https://facilitator.payai.network"   # facilitador sin API key

npm run deploy を再度実行します。支払いは Base 上の USDC であなたの EVM_ADDRESS に届きます。

別の方法として、Coinbase CDP のファシリテーターも利用できます。使用するには https://portal.cdp.coinbase.com でキーを作成する必要があります。

5. クライアントを獲得する

• 各ルートは Bazaar の検出メタデータを公開します。そのため、ファシリテーターが最初の支払い後にインデックス化すると、エージェントが x402 カタログからルートを見つけられます。
• gigs.sh などの x402 およびエージェントのディレクトリや、https://www.x402.org/ecosystem のエコシステムに URL を登録します。
• PRICE_EXTRACT、PRICE_SEO、PRICE_TEXT で価格を変更できます。

構成

src/app.ts            rutas, precios y middleware x402
src/safeFetch.ts      descarga segura (anti-SSRF, límites de tamaño y tiempo)
src/services/         extract, seo, text (lógica pura, sin dependencias)
src/node.ts           entrada para Node (local o VPS)
src/worker.ts         entrada para Cloudflare Workers
scripts/pay.ts        cliente de prueba que paga con x402

MCP サーバー

同じ API をリモート MCP サーバー（Streamable HTTP）として利用できます：

https://web-intel-x402.x402-web-intel-api.workers.dev/mcp

ツール：extract_webpage、seo_audit、analyze_text（有料、x402）、pricing（無料）。 クライアントは @x402/mcp（createx402MCPClient）で支払います。呼び出しが失敗した場合、料金は請求されません。