Web Intel (x402)

Web Intel API（x402）

面向 AI Agent 的按使用量付费 API。每次调用都会通过 x402 协议直接从你的钱包扣除 USDC。客户无需账户、API 密钥或 KYC。

Endpoint	价格	返回内容
GET /v1/extract?url=…	$0.002	标题、描述、纯文本、标题、链接、Open Graph 和 JSON-LD
GET /v1/seo-audit?url=…	$0.005	0-100 的 SEO 评分、A-F 等级和问题列表
POST /v1/text-analysis {"text": "…"}	$0.001	语言、可读性、关键词、情感倾向和统计信息
GET / 和 GET /health	免费	目录和状态

如果服务失败（例如，URL 不存在），不会向客户收费。

1. 设置你的钱包（由你完成）

你只需要 EVM 钱包的公开地址（0x…），例如 MetaMask、Rabby 或 Coinbase Wallet。绝不要在这里填写你的私钥或助记词。

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

免费套餐每天包含 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 facilitator，但需要在 https://portal.cdp.coinbase.com 创建密钥。

5. 获取客户

• 每个路由都会发布 Bazaar 发现元数据，以便 Agent 在 facilitator 完成首次付款并将其编入索引后，在 x402 目录中找到它。
• 在 x402 和 Agent 目录中登记你的 URL，例如 gigs.sh 和 https://www.x402.org/ecosystem 上的生态系统目录。
• 你可以使用 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）付款。调用失败时不会收费。