mcpField
A
agent-lookup

agent-lookup

github.com/aibtcdevAgent 工作流11152 次安装1 天前更新
代码仓库

关于 agent-lookup

agent-lookup 是查询 AIBTC Agent 注册表的命令行技能，通过公开 API 按 BTC 或 STX 地址、显示名称查找 Agent，并查看统计和排名。所有操作均为只读，无需钱包。

主要功能

  1. 01按 BTC 或 STX 地址查找 Agent
  2. 02按显示名称查找 Agent
  3. 03查看全网注册统计
  4. 04按签到、成就或等级排名
  5. 05自动获取注册表全部分页

适用场景

  1. 01核验某个地址对应的 AIBTC Agent
  2. 02按显示名称查找注册信息
  3. 03了解 Agent 注册表整体活跃情况
  4. 04比较 Agent 的签到或成就排名

安装

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

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

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

附带文件agent-lookup.tsAGENT.md

详细介绍

Agent 查询技能

查询 AIBTC Agent 注册表：aibtc.com/api/agents。所有子命令均为只读操作，无需钱包。输出始终为单个 JSON 对象。

用法

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

子命令

lookup

通过 BTC 地址、STX 地址或显示名称查找特定 Agent。

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

所有已注册 Agent 的全网汇总统计。activeAgents 统计过去 7 天内带有 lastActiveAt 时间戳的 Agent。

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

按所选指标对 Agent 排名。默认按签到次数排名，显示前 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 实时获取 Agent 数据。
  • --name 匹配不区分大小写，且要求显示名称完全匹配。
  • 使用 --by level 时，等级相同的 Agent 按签到次数降序排列。
  • 注册表每页显示 100 个 Agent；所有页面都会自动获取。

评论

支持 Markdown