人才能力（Talent Powers）

从 Talent Protocol 平台查询专业数据——一个追踪建设者（builders）的平台

使用此能力可实现以下操作：

• 按地理位置、技能或身份（Twitter / GitHub / Farcaster / 钱包地址）查找已验证开发者
• 查看建设者声誉（默认返回排名；仅当明确要求时才返回分数）
• 将 Twitter 账户映射至钱包地址
• 通过钱包地址验证人类身份
• 检索建设者的资质信息（收入、贡献、参与的黑客松、签署的合约等）
• 查看每位建设者正在开发的项目

必需凭证

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

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

接口端点（Endpoints）

关键参数

身份查询：

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。

限制条件

• 单页最多返回 250 条结果
• 大多数端点仅支持 GET 方法（customQuery 查询需使用 POST）
• query[standardized_location] 简单参数不可用 — 必须使用 customQuery 正则匹配

GitHub 数据增强

在通过 /accounts 接口解析出 GitHub 用户名后，可进一步调用 GitHub API 获取项目/仓库信息：

# 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   # 星标最多的仓库（Top repos）
GET https://api.github.com/users/{username}/repos?sort=pushed&per_page=5  # 最近更新的仓库（Recent）
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 → “Generate new token (classic)” → 公共数据无需任何权限范围（scopes）
• 使用方式：-H "Authorization: token $GITHUB_TOKEN"

参考资料

• endpoints.md — 完整端点文档
• use-cases.md — 常见使用模式
• github-enrichment.md — GitHub 数据集成说明