builder-data

通过 Talent Protocol API 查询开发者声誉、身份验证及 GitHub 数据。

已扫描
适合谁
区块链项目负责人、技术招聘人员
不适合谁
无 API 接入能力的普通用户、不关注开发者信誉的非技术人群
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @juampihernandez/talent-powers

Skill 说明

命令、参数、文件名以原文为准

Talent Powers

从 [Talent Protocol](https://talent.app) 平台查询专业人才数据 —— 一个用于追踪开发者的平台。

使用此技能可实现:

  • 根据地理位置、技能或身份(Twitter/GitHub/Farcaster/钱包地址)查找已验证的开发者
  • 检查构建者信誉(默认返回排名,仅在明确请求时返回分数)
  • 将 Twitter 账号与钱包地址进行映射
  • 通过钱包地址验证人类身份
  • 搜索构建者的资质信息(如收入、贡献、黑客松参赛经历、合约记录等)
  • 查看每位构建者正在开发的项目

所需凭证

变量必填说明获取方式
TALENT_API_KEYTalent Protocol 的 API 密钥(用于读取个人资料/身份数据)https://talent.app/~/settings/api
GITHUB_TOKEN个人访问令牌,用于提升 GitHub 请求频率限制(60次/小时 → 5,000次/小时)https://github.com/settings/tokens

基础 URL: https://api.talentprotocol.com

curl -H "X-API-KEY: $TALENT_API_KEY" "https://api.talentprotocol.com/..."

接口端点

端点用途
/search/advanced/profiles根据身份、标签、排名、验证状态等条件搜索用户资料
/profile根据 ID 获取用户个人资料
/accounts获取关联的钱包、GitHub、社交账号信息
/socials获取社交账号详情及简介
/credentials获取资质数据点(如收入、粉丝数、黑客松经历等)
/human_checkmark检查是否为人类验证用户(可选,不建议默认使用)
/scores获取排名(默认)或分数(仅在明确请求时返回)

关键参数

身份查询:

query[identity]={handle}&query[identity_type]={twitter|github|farcaster|ens|wallet}

筛选条件(全部可选,仅在查询需要时使用):

query[tags][]=developer              # 按标签筛选(如 developer、designer 等)
query[verified_nationality]=true     # 仅返回已验证国籍的用户
query[human_checkmark]=true          # 仅返回人类验证用户(会显著减少结果数量)

排序方式:

sort[score][order]=desc&sort[score][scorer]=Builder%20Score

分页设置: page=1&per_page=250(最大每页 250 条)

URL 编码规则

[ = %5B, ] = %5D, 空格 = %20

响应字段

默认返回 → 排名(除非用户明确要求分数):

  • builder_score.rank_position - 主要排名指标
  • scores[].rank_position,其中 slug = "builder_score" - 最新排名

仅当用户明确请求分数时返回:

  • builder_score.points - 分数数值
  • scores[].points - 各项具体分数
  • location - 用户填写的地理位置(在响应中返回)

地理位置筛选

不要使用 query[standardized_location]=Country —— 此参数无效。

**请使用 customQuery 配合正则表达式:**

curl -X POST -H "X-API-KEY: $TALENT_API_KEY" -H "Content-Type: application/json" \
  "https://api.talentprotocol.com/search/advanced/profiles" \
  -d '{
    "customQuery": {
      "regexp": {
        "standardized_location": {
          "value": ".*argentina.*",
          "case_insensitive": true
        }
      }
    },
    "sort": { "score": { "order": "desc", "scorer": "Builder Score" } },
    "perPage": 50
  }'

更多示例请参考 [use-cases.md](references/use-cases.md#by-location-country)。

限制说明

  • 单页最多返回 250 条数据
  • 多数端点仅支持 GET 请求(customQuery 使用 POST)
  • 简单的 query[standardized_location] 参数已失效,必须使用 customQuery 的正则方式

GitHub 数据补充

在通过 /accounts 接口解析出 GitHub 用户名后,可进一步获取其项目和仓库信息:

# 1. 获取 GitHub 用户名
/accounts?id={profile_id} → { "source": "github", "username": "..." }

# 2. 查询 GitHub 数据
GET https://api.github.com/users/{username}                           # 用户资料
GET https://api.github.com/users/{username}/repos?sort=stars&per_page=5   # 按星级排序的前 5 个仓库
GET https://api.github.com/users/{username}/repos?sort=pushed&per_page=5  # 最近更新的前 5 个仓库
GET https://api.github.com/users/{username}/events/public             # 公共活动(提交记录)
GET https://api.github.com/search/issues?q=author:{username}+type:pr+state:open  # 开放中的 PR 列表

推荐使用 GitHub Token:

未提供 Token 时,GitHub 请求限制为 60 次/小时;使用个人访问令牌后可提升至 5,000 次/小时。

  • 创建方式:前往 https://github.com/settings/tokens → “生成新令牌(经典)” → 无需选择权限范围即可获取公开数据
  • 使用方法:添加请求头 -H "Authorization: token $GITHUB_TOKEN"

参考文档

  • [endpoints.md](references/endpoints.md) - 完整接口说明
  • [use-cases.md](references/use-cases.md) - 常见使用场景
  • [github-enrichment.md](references/github-enrichment.md) - GitHub 数据补充指南
J
@juampihernandez

已收录 2 个 Skill

相关推荐