两个面向AI Agent的x402 API：页面质量检测与成本计算

两个面向AI Agent的x402 API：页面质量检测与成本计算 | 前端进阶之旅

Full translation

完整中文译文

今天向 x402 目录上线了两个新端点——均为每次调用 $0.0005，USDC 结算在 Base 上，无需注册。

/api/page-archaeology?url=<URL> — 检测停放页 / 轻薄页 / AI 生成页

当一个 Agent 引用某个来源时，它需要知道该来源是人工策展的还是停放域名。此端点读取页面并返回：

{
  "is_parked": false,
  "is_thin": false,
  "is_stale": false,
  "has_author_byline": true,
  "word_count": 1842,
  "paragraph_count": 24,
  "image_count": 8,
  "text_to_html_ratio": 0.142,
  "copyright_year": 2025,
  "classification": "human_curated",
  "page_archaeology_score": 95,
  "page_archaeology_grade": "A",
  "findings": []
}

9 个停放域名标记（sedo、dan.com、parkingcrew、"this domain is for sale" 等）

字数 < 200 = 轻薄页

版权年份 >= 5 年前 = 陈旧页

长文章无作者署名 = -10 分

破折号过度使用（每 50 词破折号数量）= 可能为 AI 生成

大页面文字与 HTML 比例 < 5% = 自动生成

/api/agent-cost-calculator?url=<URL> — 估算 Agent 使用该站点的成本

在 Agent 猛击目标 API 之前，它需要了解：认证方式、速率限制、CORS、缓存情况，以及该接口是否支持程序化访问。返回：

{
  "auth_scheme": "session_cookie",
  "rate_limit_rpm": null,
  "cors_open": false,
  "cache_max_age": 3600,
  "compressed": true,
  "compression": "brotli",
  "is_paid_api": true,
  "estimated_cost_per_call_usd": "medium",
  "agent_cost_score": 45,
  "agent_cost_grade": "C",
  "findings": [
    "session_cookie_auth_blocks_agents",
    "cors_closed_browser_only",
    "paid_indicators: ['js.stripe.com', 'pricing', 'checkout']"
  ]
}

适用场景：Agent 决定是否调用目标站点，或切换到其他站点。

# 1. 发起请求，从 402 响应中获取支付条款
curl 'https://law-bedrooms-long-powerseller.trycloudflare.com/api/page-archaeology?url=https://example.com'

# 2. 支付 $0.0005 USDC 到 Base 上的 0xCa0a6c...，携带 X-PAYMENT 头重试
#（任何兼容 x402 的 Agent 钱包都会自动处理这一步）

就这样。无需 API Key，无需注册，无需邮箱。钱包即身份。

完整目录：GET /.well-known/x402（116 个付费端点）

OpenAPI：GET /openapi.json（115 条路径）

LLM 友好版：GET /llms.txt

支付托管方：pay.openfacilitator.io（Base + Solana）

/api/page-archaeology 填补了一个真实的空白：目录中此前没有任何端点告诉 Agent"这个来源值得引用吗"。/api/agent-cost-calculator 则是 Agent 在决定使用目标 API 之前调用的——认证方式和速率限制正是那些在执行过程中给 Agent 带来意外的问题。

两个端点都运行在一个托管于 Cloudflare quick-tunnel 后端的小型 Flask 服务上，通过 x402 协议在 Base 上结算 USDC，使用真实的托管方（非模拟）——每次成功结算都会上链。

如果你的 Agent 在 Base 上持有 USDC，整个目录都可以访问。如果没有，/api 下的免费层仍能获取基本元数据。

在线端点，统一 $0.0005/次调用：law-bedrooms-long-powerseller.trycloudflare.com