Skillppx logo

Builder Data

通过 Talent Protocol API 查询开发者信誉、身份验证及项目信息。

已扫描
适合谁
技术招聘人员、开源社区管理者
不适合谁
无 API 接入能力的普通用户、无需开发者信誉数据的非技术场景
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @juampihernandez/builder-data
下载官方 ZIP

Skill 说明

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

技能说明：Builder Data

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

使用此技能可实现：

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

所需凭证

变量是否必需描述获取方式
TALENT_API_KEY是Talent 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   # 星标最多的仓库
GET https://api.github.com/users/{username}/repos?sort=pushed&per_page=5  # 最近更新的仓库
GET https://api.github.com/users/{username}/events/public             # 公共提交记录
GET https://api.github.com/search/issues?q=author:{username}+type:pr+state:open  # 开放中的 Pull Request

推荐使用 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

相关推荐