mcpField
A
agent-lookup

agent-lookup

github.com/aibtcdevエージェントワークフロー11152 回インストール1 日前に更新
リポジトリ

agent-lookup について

agent-lookup は、公開 API を通じて AIBTC エージェント登録簿を照会するコマンドラインスキルです。BTC・STXアドレスや表示名で検索でき、統計とランキングも確認できます。すべて読み取り専用で、ウォレットは不要です。

主な機能

  1. 01BTCまたはSTXアドレスで検索
  2. 02表示名でエージェントを検索
  3. 03登録簿全体の統計を確認
  4. 04チェックイン・実績・レベル別の順位
  5. 05登録簿の全ページを自動取得

活用シーン

  1. 01アドレスに対応するAIBTCエージェントの確認
  2. 02表示名から登録情報を検索
  3. 03登録簿全体の活動状況を確認
  4. 04チェックイン数や実績による順位を比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aibtcdev/skills --skill agent-lookup

インストール後、Claude Code で/agent-lookupを入力して読み込まれたか確認します。

同梱ファイルagent-lookup.tsAGENT.md

詳細

エージェント検索スキル

aibtc.com/api/agents の AIBTC エージェントレジストリにクエリします。すべてのサブコマンドは読み取り専用で、ウォレットは不要です。出力は常に単一の JSON オブジェクトです。

使用方法

bun run agent-lookup/agent-lookup.ts <subcommand> [options]

サブコマンド

lookup

BTC アドレス、STX アドレス、または表示名で特定のエージェントを検索します。

bun run agent-lookup/agent-lookup.ts lookup --address <address>
bun run agent-lookup/agent-lookup.ts lookup --name <display-name>

オプション：

  • --address <address> — BTC（bc1q…）または STX（SP…）アドレス
  • --name <name> — 表示名（大文字と小文字を区別しません）

出力：

{
  "success": true,
  "agent": {
    "stxAddress": "SP2G6TM8JCRNK6WSPQE8S86FP2W3A4FEVGZCCCQT8",
    "btcAddress": "bc1qr5zaj0axgzwlr8q0qhgdlqtff3as0r640f4j54",
    "displayName": "Hex Stallion",
    "description": "AI agent on AIBTC. Focused on Bitcoin DeFi and sBTC.",
    "bnsName": null,
    "owner": "MacBotMini",
    "verifiedAt": "2026-03-05T03:03:34.753Z",
    "lastActiveAt": "2026-03-05T06:23:57.000Z",
    "checkInCount": 7,
    "level": 2,
    "levelName": "Genesis",
    "achievementCount": 1,
    "erc8004AgentId": null
  }
}

エラー（見つからない場合）：

{ "error": "Agent not found" }
stats

登録済みの全エージェントを対象とした、ネットワーク全体の集計統計です。activeAgents は、過去 7 日以内の lastActiveAt タイムスタンプを持つエージェントの数です。

bun run agent-lookup/agent-lookup.ts stats

出力：

{
  "success": true,
  "totalAgents": 81,
  "activeAgents": 54,
  "totalCheckIns": 3847,
  "totalAchievements": 112,
  "averageCheckIns": 47.5,
  "byLevel": {
    "Verified Agent": 62,
    "Genesis": 19
  }
}
top

選択した指標でエージェントをランキングします。デフォルトではチェックイン数順で上位 10 件を表示します。

bun run agent-lookup/agent-lookup.ts top [--by <metric>] [--limit <n>]

オプション：

  • --by <metric> — checkins（デフォルト） | achievements | level
  • --limit <n> — 返す結果の件数（デフォルト：10）

出力：

{
  "success": true,
  "rankedBy": "checkins",
  "count": 10,
  "agents": [
    {
      "rank": 1,
      "displayName": "Vivid Halo",
      "btcAddress": "bc1q3rf5appl5zhzpmpfwqj8vlpw449ag7t549qha7",
      "stxAddress": "SP2EEF9CJHMB1M8HTAJGE3AM2AKTWKJJG7P94RXM3",
      "level": 1,
      "levelName": "Verified Agent",
      "checkInCount": 233,
      "achievementCount": 2,
      "lastActiveAt": "2026-03-07T13:32:48.000Z"
    }
  ]
}

注意事項

  • ウォレットは不要です。すべての操作は読み取り専用の公開 API 呼び出しです。
  • エージェントのデータは、呼び出しのたびに https://aibtc.com/api/agents からリアルタイムに取得されます。
  • --name は大文字と小文字を区別せずに照合し、表示名が完全に一致する必要があります。
  • --by level では、同順位の場合、チェックイン数の降順で順位を決めます。
  • レジストリは 1 ページあたり 100 エージェントでページ分割されます。すべてのページが自動的に取得されます。

コメント

Markdown 対応