AgentPay Doc Tools

AgentPay — 面向 AI Agent 的按次付费 API 和 MCP 工具

无需注册，Agent 即可使用网页提取、域名／网络情报和文档工具。 使用 x402 通过 Base 或 Algorand 上的 USDC 按请求付费，也可以预付额度以获取 API 密钥。 每款产品都提供 REST API 和远程 MCP 服务。

产品	功能	基础 URL	MCP 服务
Web Extract	任意 URL → 清晰、适用于大模型的 Markdown，以及标题、元数据、Open Graph、规范 URL 和链接	https://agentpay-extract.agentpay-apis.workers.dev	…/mcp
Domain & Network Lookup	DNS 记录、WHOIS/RDAP 注册信息、IP 归属及反向 DNS、一次调用生成域名报告（邮件服务商、SPF/DMARC、托管信息）	https://agentpay-lookup.agentpay-apis.workers.dev	…/mcp
Doc Tools	PDF → 按页提取文本，RSS/Atom/JSON Feed → JSON，站点地图（通过 robots.txt）→ URL 列表	https://agentpay-tools.agentpay-apis.workers.dev	…/mcp
Bundle	在同一主机上提供以上所有功能	https://agentpay.agentpay-apis.workers.dev	…/mcp

机器可读文档：/llms.txt · /openapi.json · /.well-known/x402

端点和定价

Base 和 Algorand 上价格相同。无效输入会在付款之前被拒绝，且 x402 付款只有在调用成功时才会结算——调用失败不收取费用。

端点	说明	价格（USDC）
GET /extract/v1/page?url=	网页 → Markdown、元数据、链接（maxChars 可选）	$0.005
GET /lookup/v1/dns?name=&type=	A、AAAA、CNAME、MX、NS、TXT、SOA、CAA、PTR、SRV	$0.005
GET /lookup/v1/whois?domain=	注册商、创建／更新／到期时间、状态、名称服务器（RDAP）	$0.01
GET /lookup/v1/ip?ip=	网络所有者、网段、国家、反向 DNS	$0.01
GET /lookup/v1/domain-report?domain=	注册信息 + DNS + 邮件服务商 + SPF/DMARC + 托管信息	$0.02
GET /tools/v1/pdf-text?url=	从 PDF URL 提取逐页文本（≤20 MB）	$0.01
GET /tools/v1/feed?url=&limit=	RSS / Atom / JSON Feed → 规范化条目	$0.005
GET /tools/v1/sitemap?url=&limit=	从站点地图获取网站 URL，并遵循 robots.txt 和索引文件	$0.005
GET /credits/buy?usd=	预付额度（$1–$500）→ API 密钥。充值 $5 赠送 10%，充值 $20 赠送 20%	= 金额

付款方式

免费试用

GET https://agentpay.agentpay-apis.workers.dev/credits/trial 会返回一个含 $0.05 免费额度的 API 密钥（每个网络每天可领取一次）。 在任意端点或 MCP 服务中使用 Authorization: Bearer <key>。

使用 Pera Wallet 手动付款

打开 **https://agentpay.agentpay-apis.workers.dev/pay**，连接 Pera，选择一个端点（或购买额度），然后在应用中批准 USDC 付款。网络费用由服务承担，因此只需准备 USDC。

x402（无需账户）

调用任意端点。你会收到 402 Payment Required，其中包含 Base64 编码的 PAYMENT-REQUIRED 标头（x402 v2），提供以下选项：

• Base — eip155:8453，USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913，精确方案（EIP-3009）
• Algorand — algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=，USDC ASA 31566704，精确方案，网络费用由 GoPlausible facilitator 代付（extra.feePayer）

任何 x402 v2 客户端都会自动处理：

import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm';
import { privateKeyToAccount } from 'viem/accounts';

const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:8453', client: new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)) }],
});
const res = await fetchWithPayment('https://agentpay-lookup.agentpay-apis.workers.dev/lookup/v1/domain-report?domain=example.com');
console.log(await res.json());

两个网络的完整示例：examples/x402-client.mjs。

预付额度（适合频繁使用）

GET https://agentpay.agentpay-apis.workers.dev/credits/buy?usd=5（通过 x402 一次性付款）会返回 { "apiKey": "ak_…" }。 在任意端点或 MCP 服务中发送 Authorization: Bearer ak_…。调用失败会自动退款。 余额：GET /credits/balance。Algorand 持有者也可以通过转账付款：examples/buy-credits.mjs。

使用 MCP 服务

基于 Streamable HTTP 的远程 MCP。列出工具不收费；工具调用需通过 x402 付费 （按照 x402 MCP 传输规范使用 params._meta["x402/payment"]），或通过 credits key 请求头付费。

Claude Code

claude mcp add --transport http agentpay-lookup https://agentpay-lookup.agentpay-apis.workers.dev/mcp --header "Authorization: Bearer ak_..."

Cursor / Claude Desktop / 支持远程 MCP 的任意客户端

{
  "mcpServers": {
    "agentpay-extract": { "url": "https://agentpay-extract.agentpay-apis.workers.dev/mcp", "headers": { "Authorization": "Bearer ak_..." } },
    "agentpay-lookup":  { "url": "https://agentpay-lookup.agentpay-apis.workers.dev/mcp",  "headers": { "Authorization": "Bearer ak_..." } },
    "agentpay-tools":   { "url": "https://agentpay-tools.agentpay-apis.workers.dev/mcp",   "headers": { "Authorization": "Bearer ak_..." } }
  }
}

MCP 服务	工具
agentpay-extract	extract_page
agentpay-lookup	lookup_dns、lookup_whois、lookup_ip、lookup_domain_report
agentpay-tools	tools_pdf_text、tools_feed、tools_sitemap
agentpay（捆绑包）	全部 8 个

示例响应

GET /lookup/v1/whois?domain=anthropic.com

{ "domain": "anthropic.com", "registered": true, "registrar": "MarkMonitor Inc.", "created": "2001-10-02T18:10:32Z",
  "expires": "2033-10-02T18:10:32Z", "status": ["client delete prohibited", "client transfer prohibited"],
  "nameservers": ["isla.ns.cloudflare.com", "randy.ns.cloudflare.com"], "source": "RDAP" }

GET /lookup/v1/ip?ip=1.1.1.1

{ "ip": "1.1.1.1", "version": 4, "reverseDns": ["one.one.one.one."],
  "network": { "name": "APNIC-LABS", "range": "1.1.1.0 - 1.1.1.255", "country": "AU", "organization": "APNIC Research and Development" } }

数据来源

通过 HTTPS 的 DNS（Cloudflare 1.1.1.1）、IANA RDAP 引导信息 → 权威注册机构 RDAP 服务，以及区域互联网注册机构。网页、PDF、Feed 和站点地图工具会在请求时获取你提供的 URL。

支持

在此代码库中提交 issue。