SuperAPI AI 工具集

tiktok-keyword-user-search

数据与分析

查看项目

更新于 10-23 22:59

技能介绍

TikTok 账号搜索与关注列表查询工具,基于红狐数据提供两项能力,并可串联使用完成“搜索定位 → 查关注列表”的完整流程。

用途

用于在 TikTok 上按昵称或 handle 定位目标账号,查看其粉丝、作品、获赞与认证等画像;也用于查询指定账号关注的账号列表,分析其关注对象情况。

主要能力

一、关键词搜索用户(searchUser):按昵称或 handle 搜索 TikTok 账号,返回 userId、粉丝数、关注数、获赞、作品数;支持按粉丝数区间(0–1K、1K–10K、10K–100K、100K 以上)筛选,以及仅认证账号筛选。输出为 Markdown 表格,含序号、昵称、Handle、userId、粉丝、关注、获赞、作品,其中 userId 列可直接用于链式查询关注列表。默认按粉丝数降序输出,可通过 --sort none 保留接口原始相关度顺序。

二、关注列表查询(userFollowing):查询某个 TikTok 账号关注了哪些账号,输出关注对象表格,含序号、昵称、Handle、粉丝、作品、获赞、地区、认证;isSecret=1 的关注对象在昵称后追加“(私密)”。默认按接口原始顺序输出(关注时间从近到早),用户指定时可按粉丝数、作品数、获赞本地降序。

三、链式查询:用户只给昵称或 handle、没有 userId 时,先搜索定位账号并列出候选(含 userId、粉丝数),用户确认目标后查询其关注列表。

使用方式

直接用自然语言描述查询需求,无需记忆命令。例如“搜一下 TikTok 上叫南浔的用户”“查 userId 6748953635118187521 的关注列表”“查 solid.guts 的关注列表”“搜 xxx,只看 10 万粉以上的账号”“按粉丝数排序看看他关注了哪些大号”“只看前 10 个关注”“下一页”。

安装与前置条件

需要 Python 3.8+(仅使用标准库,无需安装额外依赖)以及红狐数据 API Key。安装时将技能文件夹放入 Skills 目录,并配置环境变量 REDFOX_API_KEY(格式 ak_xxxxxxxx,前往红狐 hub 注册获取)。

注意事项与限制

关注列表接口只接受纯数字 userId 或 MS4wLjAB 开头的 secUserId,不接受 @handle 昵称;只给 handle 时需先用关键词搜索定位。每次成功查询可能消耗积分,默认只查一页,翻页需明确指示“下一页”;链式查询涉及两次独立调用,搜索结果需先向用户确认目标后再查关注列表。数据均来自接口返回,如实展示,不估算或编造;接口未返回的字段(如主页地址)不构造输出;任一能力返回空列表时只输出“暂无数据”及可能原因,不主动改查其他用户或关键词。