图谱

把区块链数据查询请求路由至最适合的Graph Protocol服务，返回实时链上数据，支持中文交互与多场景自动化分析。

核心功能: 本技能提供中文交互、化工作流场景等能力。

Graph Advocate

付费版进阶功能

能力	免费版	付费版
基础功能	支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持
分布式任务调度与负载均衡	不支持	支持

主要能力

• Route any blockchain data question to the right Graph Protocol service
• Returns live data from 15

典型场景

场景	输入	输出
区块链数据查询	链上数据问题和子图类型	Graph Protocol服务路由和建议
子图选择	数据需求和合约地址	最优子图索引和查询端点
查询优化	GraphQL查询和子图模式	优化查询和性能建议

不适用于：非区块链数据的图数据库查询

操作步骤

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

参数说明

参数名	类型	必填	说明
question	string	是	区块链数据查询问题
chain	string	否	区块链网络, 可选: ethereum/polygon/arbitrum, 默认: ethereum

返回格式

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

安装与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

工具依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

text

"Top 10 USDC holders on Ethereum"           → token-api
"Best subgraph for Uniswap V3 on Arbitrum?" → subgraph-registry
"Aave V3 liquidations above $50K"           → graph-aave-connector
"Hottest Polymarket markets"                → token-api (/v1/polymarket/markets)
"Polymarket OHLCV for Bitcoin market"       → token-api (/v1/polymarket/markets/ohlc)
"Polymarket trader P&L for 0x..."           → token-api (/v1/polymarket/users/positions)
"Polymarket live orderbook depth"           → graph-polymarket-connector (advanced)
"Polymarket trader winrate/drawdown"        → graph-polymarket-connector (subgraph P&L stats)
"Score Hyperliquid trader 0x..."            → /hyperliquid/score (paid)
"Hyperliquid top traders for HYPE"          → /hyperliquid/screen (paid)
"Evaluate Hyperliquid vault 0x..."          → /hyperliquid/vault (paid)
"Compare Aave vs Compound TVL"              → graph-lending-connector
"x402 payment volume on Base today"         → x402-analytics
"Top 10 x402 recipients in the last 30 days" → /ask (paid, NL→SQL)
"When did x402 volume on Base inflect?"     → /ask (paid, NL→SQL)
"Has 0x0FF5A6… ever been paid via x402?"     → /onchain-x402/address (paid, decentralized)
"Polymarket vs Limitless spread on 'trump'"  → /predmarket/spread (paid, cross-venue JOIN)
"Kalshi vs Polymarket fed-rate arbitrage"    → /kalshi-polymarket/spread (paid)
"Find agents that do trading"               → 8004scan

问答集成汇总

Q1: 如何开始使用Graph Advocate？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

错误处理体系

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

注意事项

• 需要API Key，无Key环境无法使用

创新优势

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
数据查询	30分钟	2分钟	28分钟	10%
数据分析	4小时	30分钟	3.5小时	5%
报表生成	2小时	20分钟	1.5小时	3%
统计洞察	6小时	1小时	5小时	8%
数据可视化	3小时	30分钟	2.5小时	4%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
功能丰富性	全面支持Graph Protocol服务	部分支持	基本支持	全面支持
操作便捷性	一键调用，快速返回结果	需编写脚本	需编写脚本	需专业操作
成本效益	付费版提供高级功能，免费版基础功能充足	需购买软件或编写脚本	需购买软件或编写脚本	需购买软件
易用性	界面友好，易于上手	需学习编程	需学习编程	需学习专业软件操作
维护成本	定期更新，维护成本低	需持续维护	需持续维护	需持续维护

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
数据查询效率低	手动查询区块链数据耗时较长，影响工作效率	所有区块链数据查询场景	提供自动化查询工具，快速返回结果	时间节约达28分钟
数据分析困难	手动分析数据过程复杂，结果不准确	所有数据分析场景	提供数据分析工具，提高分析准确率	准确率提升8%
报表生成繁琐	手动生成报表耗时较长，且格式不统一	所有报表生成场景	提供报表生成工具，提高报表生成效率	时间节约达1.5小时

常见问题FAQ

Q1: [具体问题]

A: [详细回答]

Q2: [具体问题]

A: [详细回答]

Q3: [具体问题]

A: [详细回答]

Q4: [具体问题]

A: [详细回答]

Q5: [具体问题]

A: [详细回答]

问题排查手册

错误现象	可能原因	诊断步骤	解决方案
无法连接Graph Protocol服务	网络连接问题或API Key配置错误	检查网络连接，重新配置API Key	重新配置API Key，确保网络连接正常
返回结果为空	请求参数错误或Graph Protocol服务无相关数据	检查请求参数，确认Graph Protocol服务有相关数据	修正请求参数，确认Graph Protocol服务有相关数据
返回结果错误	Graph Protocol服务错误或请求参数错误	检查Graph Protocol服务状态，确认请求参数正确	修复Graph Protocol服务错误，修正请求参数
执行时间过长	请求参数复杂或Graph Protocol服务响应慢	简化请求参数，检查Graph Protocol服务响应时间	简化请求参数，优化Graph Protocol服务

安全提示

1. 确保API Key安全，避免泄露到版本控制系统。
2. 限制技能访问权限，防止未授权访问。
3. 定期更新Graph Protocol服务，确保安全性和稳定性。
4. 对敏感数据进行加密处理，防止数据泄露。
5. 监控技能运行日志，及时发现并处理异常情况。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能介绍

• 自动化执行: 把区块链数据问题路由到对的Graph Protocol服务,返实时数据。Route any blockchain dat
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

上线流程

1. 配置API密钥: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent
• 操作系统: Windows / macOS / Linux

可用性分类

• 分类: MD（纯Markdown指令，通过自然语言驱动Agent完成操作）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作。