用途:在 X(Twitter)上以已连接用户身份关注或取消关注账号,并查询关注状态。仅支持单目标操作。
主要能力与端点:POST /x/users/{id}/follow 关注(写层级);DELETE /x/users/{id}/follow 取消关注(写层级);GET /x/users/{username} 将 @handle 解析为数字用户 ID(读层级);GET /x/followers/check?source=&target= 判断 A 是否关注 B(读层级)。
使用方式:基础 URL 为 https://xquik.com/api/v1,认证使用 x-api-key: xq_... 请求头。POST 关注请求体 { "account": "<connected_username>" },返回 { followed: true }。路径中的 {id} 为数字用户 ID,需先用 GET /x/users/{username} 解析。
典型流程:GET /x/accounts 选择操作账号;GET /x/users/{username} 将目标 handle 解析为数字 id;向用户展示目标 handle 与操作账号并等待确认;再调用 POST 关注或 DELETE 取消关注。
批量操作:若需批量关注或取消,先列出全部目标,要求对完整清单明确确认,再以 1-2 秒间隔逐个调用以避免速率限制。禁止静默批量。
限制与禁止:不支持基于抓取的随机大量关注;不支持未经用户审核全部清单的“关注所有点赞者”类流程;不支持后台运行取消关注循环。
错误:403 target_blocked_you(无法关注已屏蔽该账号的用户);422 login_failed(需在面板重新连接);429 x_api_rate_limited(需退避)。相关技能:extract-followers、x-twitter-scraper。