mcpField
P
polygon-discovery

polygon-discovery

github.com/0xpolygonAgent 工作流30102 次安装1 天前更新
代码仓库

关于 polygon-discovery

使用 `x402-pay` 调用 Agentic Services 市场按次付费 API 的技能，涵盖实时路由目录查询和 Polygon USDC 付款。目录示例涉及搜索、推理、浏览器会话、邮件和链上数据。

主要功能

  1. 01读取实时 API 路由目录
  2. 02使用 Polygon USDC 按次付款
  3. 03自动处理 HTTP 402 付款流程
  4. 04调用搜索与网页抓取服务
  5. 05访问推理、邮件、RPC 和钱包数据

适用场景

  1. 01调用前查询当前路由和价格
  2. 02发起付费搜索或网页抓取请求
  3. 03支付推理服务或浏览器会话费用
  4. 04通过服务商查询钱包分析数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0xpolygon/polygon-agent-cli --skill polygon-discovery

安装后在 Claude Code 中输入/polygon-discovery确认已加载。

详细介绍

Agentic Services (x402)

Agentic Services 市场中的按次付费 API，由 Polygon 主网的 x402 支付 协议控制访问权限。无需 API 密钥或订阅——每次调用都会从你的钱包中扣除少量 USDC。CLI（x402-pay）会检测 402 响应、对确切的付款进行签名，并自动重试。

  • 基础 URL： https://agent-discovery.polygon.org
  • 实时目录（权威来源）： GET https://agent-discovery.polygon.org/api/discover/routes
  • 提供商完整文档： https://agent-discovery.polygon.org/SKILL.md

务必先读取实时目录。 它会返回每条活跃路由的确切 代理路径、方法、价格和 payTo 地址（已启用 CORS，读取时无需付款）。 价格和可用服务会发生变化——请以目录为准， 本文件仅供参考。

前置条件——进行任何 x402 调用前检查

每次调用都会从已充值的 Polygon 钱包中扣除 USDC。运行 x402-pay 前：

agent wallet list        # is a wallet configured?

如果未列出钱包，请先设置：

  1. agent wallet login：在浏览器中打开 agentconnect 登录页面；使用 Google 或电子邮件登录（无头主机也可使用，无需额外标志）。无需预先设置：密钥会采用默认值，登录时会自动配置 Builder 凭证。
  2. agent wallet address：获取地址，然后为其充值（agent fund）
  3. agent balances：确认 Polygon（链 ID 137）上有可用的 USDC，然后再调用任何 x402 端点

如果钱包已存在，但 balances 显示 0 USDC，请让用户为钱包充值——否则 x402-pay 会因 EOA 资金不足而失败。所有服务均以 Polygon 上的 USDC 结算（0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359，链 ID 137）。

如何调用服务

使用目录中的完整路由 URL。请求正文和查询参数与 上游提供商自身的 API 一致。

# POST with a JSON body (e.g. Exa web search)
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 with query params (e.g. SearchApi Google search)
agent x402-pay \
  --url "https://agent-discovery.polygon.org/api/proxy/searchapi/google?q=<query>" \
  --wallet main --method GET

# Scrape a page to clean 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 inference (Llama 3.3 70B, OpenAI-compatible chat body)
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 响应自动检测链和代币——无需手动配置。

目录

价格按次计算，以 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 — 抓取为 MarkdownPOST/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/* 路径），仍使用 Polygon 上的 USDC 结算。x402-pay 以完全相同的方式处理 402。将下方完整 URL 作为 --url 传入。

QuickNode RPC — 每次调用 $0.001，发送标准 JSON-RPC POST 请求。URL 模式为 https://x402.quicknode.com/<chain>/：

链<chain> 标识链<chain> 标识
Polygonmatic-mainnetOptimismoptimism-mainnet
Polygon Amoymatic-amoyAvalancheavalanche-mainnet
Polygon zkEVMzkevm-mainnetBSCbsc-mainnet
Basebase-mainnetLinealinea-mainnet
Ethereumethereum-mainnetScrollscroll-mainnet
Solanasolana-mainnetSuisui-mainnet
Arbitrumarbitrum-mainnetTONton-mainnet
Bitcoinbtc-mainnetTrontron-mainnet
agent x402-pay \
  --url "https://x402.quicknode.com/matic-mainnet/" \
  --wallet main --method POST \
  --body '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Allium — 链上钱包分析 — 基础 URL：https://agents.allium.so/api/v1/developer/：

端点方法完整 URL价格
钱包余额POST…/wallet/balances$0.03
钱包盈亏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 — Agent 的电子邮件收件箱 — 每次调用 $2，基础 URL：https://x402.api.agentmail.to/v0/inboxes：

端点方法完整 URL
创建收件箱POSThttps://x402.api.agentmail.to/v0/inboxes
列出邮件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

x402 的工作原理

  1. CLI 向端点发送请求。
  2. 端点返回 HTTP 402 Payment Required 和付款详情（价格、资产、网络、payTo）。
  3. CLI 为钱包签署金额精确的 EIP-3009 transferWithAuthorization。
  4. CLI 在请求中添加付款标头后重试。
  5. 端点验证请求、调用上游 API 并返回响应；结算交易哈希会通过 PAYMENT-RESPONSE 标头返回。

整个流程对 Agent 完全透明。链和代币会根据 402 响应自动检测。不要猜测端点或在网上搜索提供商——请读取实时目录（/api/discover/routes），以获取正确且最新的 URL 和价格。

评论

支持 Markdown