Agent Skills
返回列表
The Graph 子图注册表 MCP

The Graph 子图注册表 MCP

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，将 @user_15292d5a/yjkj-subgraph-registry 安装到你的 AI 助手中。

技能介绍

要解决的问题

The Graph 上的子图数量大、命名不一致，Agent 若直接找数据源，常要先在 Studio 页面里人工筛选，再复制 API Key、确认实体字段，流程容易打断自动化。这个技能把 15,500+ 个已分类子图做成本地注册表，让 Agent 可以直接按 defi、nfts、dao、ethereum、arbitrum 或自然语言目标检索，并拿到可执行的查询 URL。

工作方式

核心工具包括：

  • search_subgraphs：按领域、网络、协议类型、实体类型或关键词过滤；
  • recommend_subgraph：把“找 Arbitrum 上的 DEX 交易”这类目标匹配到最合适的子图；
  • get_subgraph_detail：返回分类、实体、可靠性评分、query_url_x402 与 legacy URL；
  • list_registry_stats：查看注册表覆盖的领域、网络和协议。

结果优先给出 x402 路径：Agent 向 query_url_x402 发送 GraphQL 查询，网关返回 HTTP 402 和支付 manifest，随后用 x402 客户端在 Base 上完成约 $0.01 USDC 的 EIP-3009 支付并重试。无需 Studio Key。也保留 legacy API Key 路径，适合已有密钥的集成。

边界与注意

该技能适合“先发现正确子图，再执行查询”的场景，不替代 GraphQL 客户端本身。查询阶段读本地 SQLite，首次运行会拉取约 5MB 的 registry.db 并校验 SHA-256；如果哈希不一致会拒绝启动。使用 x402 需要签名钱包里有 Base USDC。若启动本地 HTTP/SSE 服务，只应绑定可信网络。自主 Agent 使用前应审计源码。

使用场景

  • 为 Arbitrum DEX 交易监控 Agent 选择子图时，用自然语言目标检索候选并读取实体字段。
  • 在评估 Base 链 lending 协议数据源时，按领域、网络和可靠性评分比较多个子图并取查询 URL。
  • 给 DAO 治理分析工具配置数据接口时，列出注册表覆盖领域，筛选治理相关子图并获取 x402 URL。
  • 编写 The Graph 查询前，获取子图实体结构与查询说明，减少手动在 Studio 中探索字段。

适合人员

  • 做链上交易数据 Agent 的工程师，需要快速选择 DEX 子图并拿到可执行查询地址。
  • 构建 DeFi 监控工具的开发者，想按网络比较 lending 和 DEX 数据源的可靠性评分。
  • 接入 The Graph 的 AI Agent 开发者，需要无 Studio key 的子图发现流程和 x402 查询说明。
  • 负责 Web3 数据管道集成的后端工程师，想从注册表取实体字段和查询 URL，避免人工搜索。