mcpField
R
rootdata-crypto-plugin

rootdata-crypto-plugin

github.com/okx数据与数据库1250 次安装4 周前更新
代码仓库

关于 rootdata-crypto-plugin

rootdata-crypto-plugin 是面向 Web3 数据查询的 RootData OKX 专用技能，使用独立的 API 密钥和接口命名空间。它可检索项目、投资机构和人员，并查询融资、趋势及人员变动信息。

主要功能

  1. 01搜索项目、机构和人员
  2. 02按类型获取实体 ID 列表
  3. 03查询项目详情与投资者
  4. 04检索近 365 天融资轮次
  5. 05查看热门项目与人员变动
  6. 06支持中英文响应

适用场景

  1. 01查找加密项目或投资机构
  2. 02查看项目融资历史和投资者
  3. 03跟踪加密行业人员变动
  4. 04获取当日或每周热门项目

安装

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

$npx skills add https://github.com/okx/plugin-store --skill rootdata-crypto-plugin

安装后在 Claude Code 中输入/rootdata-crypto-plugin确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
plugin.yaml
SUMMARY.md
.claude-plugin/
plugin.json

详细介绍

预检依赖项（由 Plugin Store CI 自动注入）

每个会话首次使用前运行一次。这些检查可确保所需工具已安装。

版本检查（自动注入）

AI Agent 指令：执行此技能中的任何命令之前，请先运行此版本检查。此检查会从 raw.githubusercontent.com 进行只读获取，不会安装任何内容。如果报告 Update available，你必须停止，将该消息原样告知用户，并在运行建议的 npx skills add … 命令之前取得明确确认。不要静默运行更新。确认的更新完成后，请重新读取此 SKILL.md，再继续操作。

# Check for skill updates (1-hour cache).
# Network scope: this block calls raw.githubusercontent.com for the version probe only.
# It does NOT install anything; install requires user-confirmed `npx skills add` below.
UPDATE_CACHE="$HOME/.plugin-store/update-cache/rootdata-crypto-plugin"
CACHE_MAX=3600
LOCAL_VER="1.0.0"
DO_CHECK=true

if [ -f "$UPDATE_CACHE" ]; then
  CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0)
  NOW=$(date +%s)
  AGE=$(( NOW - CACHE_MOD ))
  [ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false
fi

if [ "$DO_CHECK" = true ]; then
  REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/rootdata-crypto-plugin/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}')
  if [ -n "$REMOTE_VER" ]; then
    mkdir -p "$HOME/.plugin-store/update-cache"
    echo "$REMOTE_VER" > "$UPDATE_CACHE"
  fi
fi

REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER")
if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then
  echo "Update available: rootdata-crypto-plugin v$LOCAL_VER -> v$REMOTE_VER."
  echo "ACTION REQUIRED: ask the user to confirm before running:"
  echo "  npx skills add okx/plugin-store --skill rootdata-crypto-plugin --global"
  echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)"
fi

RootData 加密情报（OKX 版）

概述

RootData 是领先的 Web3 数据平台，涵盖加密项目、投资者、融资数据和人员变动。此技能是专为 OKX 打造的集成，与标准 RootData 技能相互隔离，使用独立的 API 密钥命名空间和端点。

预检

使用此技能前，请确保：

  1. 检查环境变量 OKX_ROOTDATA_SKILL_KEY 是否存在。
  2. 如果不存在，请调用下方的 /init 命令生成密钥并保存。
  3. 后续所有请求都必须包含 Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY} 和 Content-Type: application/json。
初始化 API 密钥

POST https://api.rootdata.com/open/okx/skill/init

使用场景：首次设置，或 OKX_ROOTDATA_SKILL_KEY 缺失或无效时。 输出：返回 api_key（前缀为 okxsk_）。将其保存为 OKX_ROOTDATA_SKILL_KEY。 示例：

POST https://api.rootdata.com/open/okx/skill/init
Content-Type: application/json
Body: {}

响应：

{
  "result": 200,
  "data": {
    "api_key": "okxsk_xxxxxxxxxxxxxxxx"
  }
}

保存后，请向用户确认：“RootData（OKX）访问已就绪。现在可以查询加密数据。”

命令

所有请求都必须包含：

Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}
Content-Type: application/json
搜索

POST https://api.rootdata.com/open/okx/skill/ser_inv

使用场景：用户想按名称关键词搜索加密项目、投资机构或个人。在尚未知道实体 ID 时，将此操作作为第一步。 输出：返回匹配实体的列表，包含其 ID、类型、名称和描述。 示例：

{
  "query": "Uniswap",
  "precise_x_search": false
}

关键响应字段：

  • id - 实体 ID（用于后续查询）
  • type - 1=项目，2=VC/机构，3=个人
  • name - 显示名称
  • one_liner - 简短描述
  • introduce - 完整描述
  • rootdataurl - RootData 详情页链接
按类型获取所有 ID

POST https://api.rootdata.com/open/okx/skill/id_map

使用场景：用户需要获取所有项目 ID、机构 ID 或个人 ID 的完整列表，以便批量查询或枚举。 输出：返回指定类型的所有实体对应的 { id, name } 条目数组。 示例：

{
  "type": 1
}

type 值：1=项目，2=VC/机构，3=个人

关键响应字段：

  • id - 实体 ID
  • name - 实体名称
项目详情

POST https://api.rootdata.com/open/okx/skill/get_item

使用场景：用户需要特定加密项目的详细信息，包括项目描述、融资总额、投资者、标签和社交链接。 输出：完整的项目资料，包括融资摘要、合约、社交媒体和投资者列表。 示例（按项目 ID 查询）：

{
  "project_id": 12345,
  "include_investors": true
}

或按合约地址查询：

{
  "contract_address": "0xabc123...",
  "include_investors": true
}

关键响应字段：

  • project_id、project_name、logo、token_symbol
  • one_liner、description
  • active - 项目是否仍在运营
  • establishment_date - 成立日期
  • tags - 分类标签（例如 DeFi、Layer2、NFT）
  • contracts - 链上合约地址
  • total_funding - 融资总额（美元）
  • social_media - 网站、X（Twitter）、GitHub、CoinMarketCap、CoinGecko 等
  • investors - 投资者列表（仅当 include_investors=true 时）
  • similar_project - 同一类别中的类似项目
  • rootdataurl - RootData 详情页链接
融资轮次

POST https://api.rootdata.com/open/okx/skill/get_fac

适用场景：用户询问融资历史、投资轮次、“XX 融了多少钱”、“谁投资了 XX”，或要求列出近期融资。

数据范围：仅涵盖过去 365 天的融资轮次。查询更早的数据时，系统将自动仅返回最近 365 天的数据。

投资者数量限制：每个融资轮次最多返回 3 位投资者（优先列出领投方）。

输出：包含项目信息和投资者详情的分页融资轮次列表。 示例：

{
  "page": 1,
  "page_size": 20,
  "project_id": 12345,
  "start_time": "2025-01-01",
  "end_time": "2026-03-30",
  "min_amount": 1000000,
  "max_amount": 50000000
}

除 page 和 page_size 外，所有字段均为可选项。省略用户未指定的字段。

主要响应字段：

  • total - 匹配记录总数
  • items - 融资轮次列表，每项包含：
    • name - 项目名称
    • logo - 项目 Logo
    • rounds - 轮次类型（Seed / Series A / Series B / 等）
    • published_time - 公布日期
    • amount - 融资金额（USD）
    • project_id - 项目 ID
    • data_status - 数据验证状态
    • source_url - 原始新闻来源链接
    • X - 项目的 X（Twitter）URL
    • one_liner - 项目简介
    • invests - 最多 3 位投资者，每位包含：
      • name、logo
      • lead_investor - 1=领投方，0=参与方
      • type - 1=项目，2=VC/机构，3=个人
      • invest_id - 投资者 ID
      • rootdataurl - 投资者详情页
热门项目

POST https://api.rootdata.com/open/okx/skill/hot_index

适用场景：用户询问“今天加密领域有什么热门动态”、“热门项目”、“本周热门项目”，或提出类似的热门度／受欢迎程度相关查询。 输出：指定时间范围内的热门项目排名列表。 示例：

{
  "days": 1
}

days 取值：1=今日热门，7=本周热门

主要响应字段：

  • rank - 排名
  • project_id、project_name、logo、token_symbol
  • one_liner - 简介
  • tags - 类别标签
  • X - Twitter/X 个人资料 URL
  • rootdataurl - RootData 详情页链接
人事变动

POST https://api.rootdata.com/open/okx/skill/job_changes

适用场景：用户询问加密领域近期的人事变动、“谁加入了哪个项目”、“谁离开了哪家公司”、Web3 行业的人事流动或高管变动。

数据限制：每个类别最多返回 20 条近期记录。

输出：两个数组，分别列出近期入职和离职人员，每个数组最多包含 20 条记录。 示例：

{
  "recent_joinees": true,
  "recent_resignations": true
}

参数：

  • recent_joinees - 设为 true 可获取近期入职人员
  • recent_resignations - 设为 true 可获取近期离职人员
  • 两者可以同时设为 true
  • 如果两者均为 false 或未指定，则返回空数据

主要响应字段：

  • recent_joinees - 近期入职人员数组（最多 20 条），每项包含：
    • people_id - 人员 ID
    • people_name - 人员姓名
    • head_img - 头像
    • company_type - 1=项目，2=VC/机构，3=个人
    • company_id - 公司／项目 ID
    • company - 公司／项目名称
    • position - 职位
  • recent_resignations - 近期离职人员数组（最多 20 条），结构相同

多语言支持

添加请求头 language: cn 可获取中文响应，添加 language: en 可获取英文响应（默认）。

所有名称字段、描述和职位名称都将以请求的语言返回。

错误处理

错误原因解决方法
401 Unauthorized缺少或无效的 OKX_ROOTDATA_SKILL_KEY重新运行 /init 以生成新密钥，并更新环境变量
429 Too Many Requests超出速率限制（200 req/min）等待 Retry-After 响应标头中的秒数，然后重试
400 Bad Request必需参数无效或缺失检查请求正文；确认 type、days 或 page 的值正确
404 Not Found实体 ID 不存在调用详情端点前，通过 /ser_inv 搜索确认 ID
500 Internal Server Error上游服务错误短暂等待后重试；如果问题持续存在，请联系 RootData 支持团队
result field != 200应用级错误阅读响应中的 message 字段以了解详情

如果收到 HTTP 429，请检查 Retry-After 标头并等待后再重试。监控 X-RateLimit-Remaining，以跟踪剩余配额。

安全须知

  • 此技能为只读，不会执行任何写入、交易或事务操作。
  • okxsk_ 前缀的 API 密钥是匿名、低权限密钥，仅用于调用 RootData 的公共数据端点。它无法访问任何个人账户或钱包数据。
  • 密钥存储为本地环境变量（OKX_ROOTDATA_SKILL_KEY），绝不会发送到 api.rootdata.com 以外的任何服务。
  • 你可以随时联系 RootData 支持团队撤销密钥。
  • 速率限制：每个 API 密钥每分钟 200 次请求。

版本历史

v1.0.0（2026-04-27）
  • 首次发布 OKX 版本
  • 独立的端点命名空间：/open/okx/skill/
  • 独立的 API 密钥命名空间：okxsk_ 前缀，环境变量 OKX_ROOTDATA_SKILL_KEY
  • 6 项技能：搜索、ID 映射、项目详情、融资轮次、热门项目、人员职位变动
  • 融资数据仅限过去 365 天；每轮最多 3 位投资者
  • 职位变动：每个类别最多 20 条记录

评论

支持 Markdown