polygon-discovery 提供对 Polygon 主网上 Agentic Services（x402 按次付费 API）的访问能力，通过 Polygon Agent CLI 以命令行方式调用。其核心特点是无需 API 密钥、无需订阅，每次调用消耗钱包中的少量 USDC，由 x402 支付协议在 Polygon 主网上完成结算。
用途
该技能面向需要使用外部 API 服务（搜索、抓取、AI 推理、网页自动化、邮件、链上数据等）但不愿管理多个 API 密钥和订阅的代理（agent）场景。用户通过统一的钱包和命令行接口按次付费调用各类上游服务。
主要能力（服务目录）
所有价格均为每次调用的 USDC 费用，结算于 Polygon（链 ID 137）。以下路由均相对于基础 URL https://agent-discovery.polygon.org。
搜索、抓取与新闻（代理转发）：
- Exa — AI 网络搜索，POST，/api/proxy/exa/search，$0.001
- SearchApi — Google 搜索，GET，/api/proxy/searchapi/google，$0.001
- Firecrawl — 抓取页面转为 Markdown，POST，/api/proxy/firecrawl/scrape，$0.002
- NewsAPI — 头条新闻，GET，/api/proxy/news/headlines，$0.001
AI 推理（代理转发）：
- NVIDIA NIM — Llama 3.3 70B 对话，POST，/api/proxy/nim/llama-3.3-70b/chat，$0.01
- NVIDIA NIM — Llama 3.2 90B Vision（图像+对话），POST，/api/proxy/nim/llama-3.2-vision/chat，$0.01
- OpenRouter — 200+ 模型（GPT、Claude、Gemini、Llama 等），POST，/api/proxy/openrouter/chat，$0.01
网页自动化与邮件（代理转发）：
- Browserbase — 云浏览器会话，POST，/api/proxy/browserbase/sessions，$0.001
- Resend — 发送事务性邮件，POST，/api/proxy/resend/send，$0.005
链上数据、邮箱收件箱与 RPC（外部提供方）： 这些是 x402 原生提供方，直接调用其自身端点 URL（而非 /api/proxy/* 路径），仍以 USDC 在 Polygon 上结算。x402-pay 处理 402 的方式相同，将完整 URL 作为 --url 传入。
QuickNode RPC — $0.001/次，POST 标准 JSON-RPC。URL 模式为 https://x402.quicknode.com/<chain>/，支持的链 slug 包括：Polygon（matic-mainnet）、Polygon Amoy（matic-amoy）、Polygon zkEVM（zkevm-mainnet）、Base（base-mainnet）、Ethereum（ethereum-mainnet）、Solana（solana-mainnet）、Arbitrum（arbitrum-mainnet）、Bitcoin（btc-mainnet）、Optimism（optimism-mainnet）、Avalanche（avalanche-mainnet）、BSC（bsc-mainnet）、Linea（linea-mainnet）、Scroll（scroll-mainnet）、Sui（sui-mainnet）、TON（ton-mainnet）、Tron（tron-mainnet）。
Allium — 链上钱包分析，基础地址 https://agents.allium.so/api/v1/developer/，端点包括：钱包余额（POST …/wallet/balances，$0.03）、钱包 PnL（POST …/wallet/pnl，$0.03）、钱包交易（POST …/wallet/transactions，$0.03）、余额历史（POST …/wallet/balances/history，$0.01）、最新价格（POST …/prices，$0.02）、指定时间价格（POST …/prices/at-timestamp，$0.02）、价格历史（POST …/prices/history，$0.02）、代币列表（GET …/tokens，$0.03）、代币搜索（GET …/tokens/search，$0.03）。
AgentMail — 代理邮箱收件箱，$2/次，基础地址 https://x402.api.agentmail.to/v0/inboxes，端点包括创建收件箱（POST）、列出邮件（GET …/{inbox_id}/messages）、获取邮件（GET …/{inbox_id}/messages/{message_id}）、发送邮件（POST …/{inbox_id}/messages/send）、回复邮件（POST …/{inbox_id}/messages/{message_id}/reply）、列出会话线索（GET …/{inbox_id}/threads）。
使用方式
前置条件：每次调用都会从已注资的 Polygon 钱包中消耗 USDC。运行 x402-pay 前需检查：
- agent wallet list：确认是否已配置钱包。若未列出，可通过 agent wallet login 设置：在浏览器打开 agentconnect 登录页，使用 Google 或邮箱登录（在无头主机上也可用，无需额外参数标志；无需预先设置步骤，密钥有默认值，登录会自动配置 Builder 凭据）。
- agent wallet address：获取地址后通过 agent fund 为其注资。
- agent balances：确认 Polygon（链 137）上有可用 USDC，再调用任何 x402 端点。 若钱包存在但 balances 显示 0 USDC，应引导用户注资，否则 x402-pay 会以 EOA funding 错误失败。所有服务均以 USDC 在 Polygon（0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359，链 ID 137）结算。
调用服务：使用目录中的完整路由 URL，请求体与查询参数与上游提供方 API 保持一致。示例：
POST 带 JSON 请求体（如 Exa 网络搜索）： agent x402-pay --url "https://agent-discovery.polygon.org/api/proxy/exa/search" --wallet main --method POST --body '{"query": "polygon agentic payments", "numResults": 5}'
GET 带查询参数（如 SearchApi Google 搜索）： agent x402-pay --url "https://agent-discovery.polygon.org/api/proxy/searchapi/google?q=<query>" --wallet main --method GET
抓取页面为干净的 Markdown（Firecrawl）： agent x402-pay --url "https://agent-discovery.polygon.org/api/proxy/firecrawl/scrape" --wallet main --method POST --body '{"url": "https://example.com"}'
LLM 推理（Llama 3.3 70B，兼容 OpenAI 的对话请求体）： agent x402-pay --url "https://agent-discovery.polygon.org/api/proxy/nim/llama-3.3-70b/chat" --wallet main --method POST --body '{"messages": [{"role": "user", "content": "Summarize Polygon in one line."}]}'
链与代币从 402 响应中自动检测，无需手动配置。
实时目录（权威来源）：GET https://agent-discovery.polygon.org/api/discover/routes（已启用 CORS，读取无需支付）。该目录返回所有活跃路由及其精确的代理路径、方法、价格和 payTo 地址。价格与可用服务会变化，应以目录为准。完整提供方文档见 https://agent-discovery.polygon.org/SKILL.md。
x402 工作流程：
- CLI 向端点发送请求。
- 端点返回 HTTP 402 Payment Required 及支付详情（价格、资产、网络、payTo）。
- CLI 从钱包签署一笔精确金额的 EIP-3009 transferWithAuthorization。
- CLI 携带支付头重试请求。
- 端点验证后调用上游 API 并返回响应；结算交易哈希在 PAYMENT-RESPONSE 头中返回。 整个流程对代理透明，链与代币从 402 响应自动检测。
适用场景
需要以按次付费、无需管理密钥的方式调用搜索、抓取、AI 推理、网页自动化、邮件或多链 RPC 与链上数据分析服务的代理工作流。
限制
需要已注资的 Polygon 钱包及 USDC 余额；每次调用均产生费用；服务可用性与价格以实时目录为准，可能变化。不要猜测端点或上网搜索提供方，应读取实时目录 /api/discover/routes 获取正确且最新的 URL 与价格。