Talent Powers
Query professional data from Talent Protocol - a platform that tracks builders
Use this skill to:
- - Find verified developers by location, skills, or identity (Twitter/GitHub/Farcaster/wallet)
- Check builder reputation (ranks by default, scores only when asked)
- Map Twitter accounts with Wallet addresses
- Verify human identity from a wallet
- Search for builder's credentials (earnings, contributions, hackathons, contracts, etc)
- Check the projects each builder is shipping
Required Credentials
| Variable | Required | Description | Get it at |
|---|
| INLINECODE0 | Yes | API key for Talent Protocol (read access to profile/identity data) | https://talent.app/~/settings/api |
| INLINECODE1 |
No | Personal access token for higher GitHub rate limits (60/hr → 5,000/hr) | https://github.com/settings/tokens |
Base URL: INLINECODE2
CODEBLOCK0
Endpoints
| Endpoint | Purpose |
|---|
| INLINECODE3 | Search profiles by identity, tags, rank, verification |
| INLINECODE4 |
Get profile by ID |
|
/accounts | Get connected wallets, GitHub, socials |
|
/socials | Get social profiles + bios |
|
/credentials | Get data points (earnings, followers, hackathons, etc.) |
|
/human_checkmark | Check if human-verified (optional, don't use by default) |
|
/scores | Get ranks (default) or scores (only when explicitly asked) |
Key Parameters
Identity lookup:
CODEBLOCK1
Filters (all optional, only use when relevant to the query):
CODEBLOCK2
Sorting:
CODEBLOCK3
Pagination: page=1&per_page=250 (max 250)
URL Encoding
INLINECODE11 = %5B, ] = %5D, Space = INLINECODE15
Response Fields
Default → Ranks (always use unless user asks for scores):
- -
builder_score.rank_position - Primary rank metric - INLINECODE17 where
slug = "builder_score" - Latest rank
Only when user explicitly asks for scores:
- -
builder_score.points - Score value - INLINECODE20 - Individual score values
- -
location - User-entered location (returned in response)
Location Filter
DO NOT USE query[standardized_location]=Country - doesn't work.
USE customQuery with regex:
CODEBLOCK4
See use-cases.md for more examples.
Limitations
- - Max 250 per page
- GET only for most endpoints (POST for customQuery)
- Simple
query[standardized_location] param broken - use customQuery regex
GitHub Enrichment
Get projects/repos via GitHub after resolving username from /accounts:
CODEBLOCK5
GitHub Token (recommended): Without a token, GitHub limits to 60 requests/hr. With a personal access token, you get 5,000/hr.
- - Create one at: https://github.com/settings/tokens → "Generate new token (classic)" → no scopes needed for public data
- Use it: INLINECODE27
References
天赋能力
从Talent Protocol查询专业数据——一个追踪建设者的平台
使用此技能可以：
- - 按地点、技能或身份（Twitter/GitHub/Farcaster/钱包）查找经过验证的开发者
- 检查建设者声誉（默认返回排名，仅在被问及时返回分数）
- 将Twitter账户与钱包地址关联
- 通过钱包验证人类身份
- 搜索建设者的凭证（收入、贡献、黑客松、合约等）
- 查看每个建设者正在交付的项目
必需凭证
| 变量 | 必需 | 描述 | 获取地址 |
|---|
| TALENTAPIKEY | 是 | Talent Protocol的API密钥（对个人资料/身份数据的读取权限） | https://talent.app/~/settings/api |
| GITHUB_TOKEN |
否 | 用于提高GitHub速率限制的个人访问令牌（60/小时 → 5,000/小时） | https://github.com/settings/tokens |
基础URL： https://api.talentprotocol.com
bash
curl -H X-API-KEY: $TALENTAPIKEY 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 # 按标签筛选（开发者、设计师等）
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
响应字段
默认 → 排名（除非用户要求分数，否则始终使用）：
- - builderscore.rankposition - 主要排名指标
- scores[].rankposition 其中 slug = builderscore - 最新排名
仅当用户明确要求分数时：
- - builder_score.points - 分数值
- scores[].points - 单个分数值
- - location - 用户输入的地点（在响应中返回）
地点筛选
不要使用 query[standardized_location]=Country——此方法无效。
使用带正则表达式的 customQuery：
bash
curl -X POST -H X-API-KEY: $TALENTAPIKEY -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获取项目/仓库：
bash
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 # 开放的PR
GitHub令牌（推荐）： 没有令牌时，GitHub限制为60次请求/小时。使用个人访问令牌后，可获得5,000次/小时。
- - 在 https://github.com/settings/tokens 创建 → 生成新令牌（经典） → 公共数据无需任何作用域
- 使用方法：-H Authorization: token $GITHUB_TOKEN
参考资料
