rootdata-crypto-plugin について
rootdata-crypto-pluginは、専用のAPIキーとエンドポイント名前空間を使ってRootDataのWeb3データを検索する、OKX専用スキルです。プロジェクト、投資家、人員を検索し、資金調達、トレンド、人事異動の情報を取得できます。
主な機能
- 01プロジェクト・機関・人物の検索
- 02種類別のエンティティID一覧
- 03プロジェクト詳細と投資家の取得
- 04過去365日分の資金調達ラウンド検索
- 05トレンドプロジェクトと人事異動の確認
- 06中国語・英語での応答指定
活用シーン
- 01暗号資産プロジェクトや投資機関の検索
- 02プロジェクトの資金調達履歴と投資家の確認
- 03暗号資産業界の人事異動の追跡
- 04日次・週次のトレンドプロジェクトの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ okx/ plugin-store --skill rootdata-crypto-pluginインストール後、Claude Code で/rootdata-crypto-pluginを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEplugin.yamlSUMMARY.md.claude-plugin/plugin.json詳細
事前確認の依存関係(Plugin Store CI により自動挿入)
初回使用前に、セッションごとに一度実行してください。これらの確認により、必要なツールがインストールされていることを確かめます。
バージョン確認(自動挿入)
AI エージェントへの指示:このスキルのコマンドを実行する前に、このバージョン確認を実行してください。この確認は
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 キー名前空間とエンドポイントを使用します。
事前確認
このスキルを使用する前に、以下を確認してください。
- 環境変数
OKX_ROOTDATA_SKILL_KEYが存在するか確認します。 - 存在しない場合は、以下の
/initコマンドを呼び出してキーを生成し、保存します。 - 以降のすべてのリクエストには、
Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}とContent-Type: application/jsonを含める必要があります。
API キーを初期化する
POST https://api.rootdata.com/open/okx/skill/init
使用するタイミング:初回設定時、または OKX_ROOTDATA_SKILL_KEY がないか無効な場合。
出力:okxsk_ で始まる api_key が返されます。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- エンティティ IDname- エンティティ名
プロジェクト詳細
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_symbolone_liner、descriptionactive- プロジェクトが現在も活動中かどうかestablishment_date- 設立日tags- カテゴリータグ(例:DeFi、Layer2、NFT)contracts- オンチェーンのコントラクトアドレスtotal_funding- 資金調達総額(USD)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- プロジェクトのロゴrounds- ラウンドの種類(Seed / Series A / Series B など)published_time- 発表日amount- 資金調達額(USD)project_id- プロジェクト IDdata_status- データの検証状況source_url- 元のニュースソースへのリンクX- プロジェクトの X(Twitter)URLone_liner- プロジェクトの簡単な説明invests- 最大 3 名の投資家。各投資家には以下が含まれます:name、logolead_investor-1=リード投資家、0=参加投資家type-1=プロジェクト、2=VC/機関、3=個人invest_id- 投資家 IDrootdataurl- 投資家の詳細ページ
トレンドのプロジェクト
POST https://api.rootdata.com/open/okx/skill/hot_index
使用する場面:ユーザーが「今日の暗号資産界隈の注目は」「トレンドのプロジェクト」「今週のトッププロジェクト」など、トレンドや人気に関する情報を尋ねている場合。 出力:指定された期間のトレンドプロジェクトをランキング形式で返します。 例:
{
"days": 1
}
days の値:1=今日のトレンド、7=今週のトレンド
主なレスポンスフィールド:
rank- ランキング順位project_id、project_name、logo、token_symbolone_liner- 簡単な説明tags- カテゴリータグX- Twitter/X のプロフィール URLrootdataurl- RootData の詳細ページへのリンク
人事異動
POST https://api.rootdata.com/open/okx/skill/job_changes
使用する場面:ユーザーが暗号資産業界の最近の人事異動、「誰がどのプロジェクトに入ったか」「誰がどの会社を辞めたか」、人材の異動、または Web3 業界の経営幹部の異動について尋ねている場合。
データ上限:各カテゴリーで最近の項目を最大 20 件返します。
出力:最近の入社者と退職者の 2 つの配列。それぞれ最大 20 件の項目が含まれます。 例:
{
"recent_joinees": true,
"recent_resignations": true
}
パラメーター:
recent_joinees- 最近の入社者を取得する場合はtruerecent_resignations- 最近の退職者を取得する場合はtrue- 両方を同時に
trueにできます - 両方が
falseまたは省略されている場合、空のデータが返されます
主なレスポンスフィールド:
recent_joinees- 最近の入社者の配列(最大 20 件)。各項目には以下が含まれます:people_id- 人物 IDpeople_name- 人物名head_img- プロフィール写真company_type-1=プロジェクト、2=VC/機関、3=個人company_id- 会社/プロジェクト IDcompany- 会社/プロジェクト名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 フィールド != 200 | アプリケーションレベルのエラーです | 詳細について、レスポンス内の message フィールドを確認してください |
HTTP 429 を受け取った場合は、Retry-After ヘッダーを確認して、再試行する前に待機してください。残りのクォータを追跡するには、X-RateLimit-Remaining を監視してください。
セキュリティに関する注意事項
- このスキルは読み取り専用であり、書き込み、取引、トランザクション操作は行いません。
okxsk_プレフィックスが付いた API キーは、RootData の公開データエンドポイントの呼び出しにのみ使用する、匿名の低権限キーです。個人アカウントやウォレットのデータにはアクセスできません。- キーはローカル環境変数(
OKX_ROOTDATA_SKILL_KEY)として保存され、api.rootdata.com以外のサービスに送信されることはありません。 - RootData サポートに連絡すれば、いつでもキーを無効化できます。
- レート制限:API キーごとに1 分あたり 200 リクエストです。
バージョン履歴
v1.0.0 (2026-04-27)
- OKX 版の初回リリース
- エンドポイント名前空間を分離:
/open/okx/skill/ - API キー名前空間を分離:
okxsk_プレフィックス、環境変数OKX_ROOTDATA_SKILL_KEY - 6 つのスキル:検索、ID マップ、プロジェクト詳細、資金調達ラウンド、注目プロジェクト、人事異動
- 資金調達データは過去 365 日分に限定。1 ラウンドあたり投資家は最大 3 人
- 人事異動:カテゴリごとに最大 20 件