用途:通过快手账号名称(profile.userName)做模糊包含匹配搜索,快速定位目标账号并获取 kwaiId,用于后续查询该账号的作品列表(queryWorkList)。触发场景包括按名称搜索快手账号、查找快手博主、定位达人账号、获取账号 kwaiId。
主要能力:名称模糊搜索,输入关键词(如「人民日报」)即可搜索,无需精确 ID;返回每个账号的平台展示 id(kwaiId);展示昵称、头像、封面、简介等账号画像;支持分页浏览,每页最多 50 条,便于翻看同名或相似账号。
鉴权与配置:API Key 从环境变量 REDFOX_API_KEY 读取,格式为 ak_xxxxxxxx。未设置时提示用户配置:export REDFOX_API_KEY=<你的apikey>。macOS/Linux 可将其追加到 ~/.zshrc 或 ~/.bashrc 后 source 生效;Windows 可用 [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User") 设置用户级永久环境变量(需重启终端)。配置后可执行 echo $REDFOX_API_KEY(macOS/Linux)或 echo %REDFOX_API_KEY%(Windows)验证。
使用方式:由 Agent 执行 scripts/search_ks_user.py(searchUser 接口);详细执行步骤、参数说明与输出格式见 references/core_workflow.md,完整接口说明与返回字段见 README.md。
适用对象:内容创作者用于搜索同赛道账号、拆解对标账号;运营与数据分析人员用于定位目标账号并获取 kwaiId;品牌与 MCN 用于筛查潜在合作达人账号。
限制:数据为广域库快照,每日早上 06:00 更新;需自备有效 API Key 与积分,具体收费与价格资料暂未提供;其余参数限制以 references/core_workflow.md 为准。