find-influencers

用途

该技能用于在 X（Twitter）上按细分领域（niche）发现活跃账号。它通过简介或账号关键词搜索用户，并在结果中按粉丝数和活跃度进行筛选，帮助用户找到特定领域的潜在影响者。整个流程为只读操作。

主要能力

按关键词或简介搜索用户（people_search）。
在提取前预览积分成本。
获取单个账号的资料快照，用于补充近期活跃信号。
将原始数据导出为 CSV。

接口与认证

基础地址：https://xquik.com/api/v1 认证方式：请求头 x-api-key: xq_...

相关端点：

端点	用途	成本
POST /extractions，toolType=people_search	按关键词/简介搜索用户	按行计费
POST /extractions/estimate	运行前预览积分成本	免费
GET /x/users/{username}	获取入围账号的资料快照	读取层级

快速参考：

POST /extractions/estimate { "toolType": "people_search", "searchQuery": "crypto trader" }

POST /extractions { "toolType": "people_search", "searchQuery": "crypto trader" } -> 202 { "id": "", "toolType": "people_search", "status": "running" }

服务器仅接受 toolType 和 searchQuery 两个参数。粉丝数过滤和仅认证账号的筛选发生在提取之后，针对返回的行在客户端进行。

使用方式（典型流程）

向用户询问细分领域关键词，以及粉丝数区间或认证偏好（在客户端应用）。
调用 POST /extractions/estimate，展示成本。
用户确认后，调用 POST /extractions。
轮询 GET /extractions/{id}，直到状态为 completed。
调用 GET /extractions/{id}/results?cursor=<cursor> 获取结果，并在本地按 followers_count 区间和 verified 标志过滤。
可选：用 GET /x/users/{username} 为入围名单补充近期活跃信号。
如需原始数据，通过 GET /extractions/{id}/export?format=csv 导出。

适用场景

在某个细分领域寻找活跃的 X 账号，用于研究或发现。
需要按粉丝数和认证状态筛选候选账号。
需要导出原始搜索结果做进一步分析。

限制与伦理说明

该技能仅用于发现与研究。不得用于批量私信、批量关注或自动化外联。
如果用户希望进行外联，必须先逐一审核每个目标账号，再进行任何操作。
粉丝数过滤和仅认证筛选不在服务端完成，需在返回结果上本地处理。
服务器仅接受 toolType 和 searchQuery 参数。