mcpField
R
rootdata

rootdata

github.com/starchild-ai-agent生产力30221 次安装6 天前更新
代码仓库

关于 rootdata

RootData 是通过 RootData API 查询 Web3 项目、投资机构和人物信息的脚本技能，支持实体检索、融资数据、热门排名及人员变动查询。

主要功能

  1. 01搜索项目、投资机构和人物
  2. 02获取项目详情及投资者
  3. 03筛选近期融资轮次
  4. 04查看每日或每周热门项目
  5. 05查询人员职位变动

适用场景

  1. 01按关键词查找 Web3 项目或投资者
  2. 02研究项目及其投资者
  3. 03查看过去 365 天的融资轮次
  4. 04跟踪热门项目和人员变动

安装

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

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill rootdata

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

附带文件_cost_track.pyexports.py

详细介绍

RootData

RootData Web3 情报 API，可用于：

  • 搜索项目／投资方／人物
  • 查询项目详情
  • 查询近期融资轮次
  • 查询热门项目（每日／每周）
  • 查询人员职位变动

脚本用法

这是脚本模式的技能。请在 bash 代码块中使用：

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/rootdata")
from exports import rd_search, rd_project_detail, rd_funding_rounds

print(rd_search(query="berachain")[:2])
print(rd_project_detail(project_id=3375, include_investors=True).get("project_name"))
print(rd_funding_rounds(page=1, page_size=5).get("total"))
EOF

exports.py 中提供的函数： rd_init_key、rd_search、rd_id_map、rd_project_detail、rd_funding_rounds、rd_hot_index、rd_job_changes。

首次设置（自动初始化密钥）

RootData 通过初始化 API 提供匿名低权限密钥。

  • 此技能使用的环境变量：ROOTDATA_SKILL_KEY
  • 如果该变量缺失，请调用一次 rd_init_key() 并将其保存到环境中。

初始化端点：

  • POST https://api.rootdata.com/open/skill/init
  • 请求体：{}
  • 返回 api_key

函数

rd_init_key()

从 RootData 初始化端点获取新的匿名 API 密钥。

返回字典：

  • api_key
  • message
rd_search(query, precise_x_search=False, language='en')

按关键词搜索项目／投资方／人物。

端点：POST /open/skill/ser_inv

请求体：

  • query：字符串
  • precise_x_search：布尔值

返回实体列表。常见字段：

  • id
  • type（1=项目，2=机构，3=人物）
  • name
  • one_liner
  • introduce
  • rootdataurl
rd_id_map(type, language='en')

按类型获取所有 ID。

端点：POST /open/skill/id_map

请求体：

  • type：1（项目）| 2（机构）| 3（人物）

返回包含 id、name 的列表。

rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en')

通过 project_id 或合约地址获取项目详情。

端点：POST /open/skill/get_item

请求体（二选一）：

  • project_id：整数
  • contract_address：字符串
  • include_investors：布尔值

返回项目详情（字段因情况而异），通常包括：

  • project_id、project_name、token_symbol
  • one_liner、description、tags
  • contracts、social_media
  • total_funding
  • investors（按需请求时）
rd_funding_rounds(page=1, page_size=20, project_id=None, start_time=None, end_time=None, min_amount=None, max_amount=None, language='en')

按筛选条件获取融资轮次列表。

端点：POST /open/skill/get_fac

注意：

  • 数据涵盖过去 365 天
  • 每轮最多显示 3 位投资方
  • 上游已移除 valuation 字段

返回字典：

  • total
  • items（列表）
rd_hot_index(days=1, language='en')

获取热门项目排名。

端点：POST /open/skill/hot_index

请求体：

  • days：1（今天）| 7（本周）

返回列表，常见字段：

  • rank、project_id、project_name、token_symbol、one_liner、tags、X、rootdataurl
rd_job_changes(recent_joinees=True, recent_resignations=True, language='en')

获取近期人员变动。

端点：POST /open/skill/job_changes

请求体：

  • recent_joinees：布尔值
  • recent_resignations：布尔值

返回包含以下内容的字典：

  • recent_joinees（最多 20 条）
  • recent_resignations（最多 20 条）

语言请求头

传入 language 请求头：

  • en（默认）
  • cn

错误处理

HTTP 状态码：

  • 200 成功
  • 400 参数错误
  • 401 密钥无效
  • 404 未找到
  • 429 请求过于频繁
  • 500 内部错误

速率限制：

  • 每个密钥每分钟 200 次请求
  • 遇到 429 时，请根据 Retry-After 请求头等待后再重试

使用说明

  • 缓存 ROOTDATA_SKILL_KEY，避免频繁调用初始化接口。
  • 研究任务建议按以下流程进行：
    1. 使用 rd_search 查找实体 ID
    2. 使用 rd_project_detail／rd_funding_rounds 深入分析
  • 融资轮次端点仅提供近期数据（365 天），请在输出中明确说明这一点。

评论

支持 Markdown