快手账号搜索(广域库)
📝 简介
通过快手账号名称(profile.userName)模糊包含匹配搜索账号,快速定位目标账号并拿到 kwaiId,用于后续查询该账号的作品列表。
✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---|---|---|
| 名称模糊搜索 | 输入账号名称关键词即可搜索(如「人民日报」) | 无需精确 ID,输入名字即可定位 |
| 返回 kwaiId | 每个账号返回平台展示 id(kwaiId) | 直接用于 queryWorkList 查询作品 |
| 账号画像 | 昵称、头像、封面、简介一览无余 | 快速判断账号定位与内容方向 |
| 分页浏览 | 每页最多 50 条,支持多页翻看 | 同名/相似账号不遗漏 |
🎯 适用对象
- 🔍 内容创作者 — 搜索同赛道账号,拆解对标账号。
- 📊 运营 / 数据分析 — 快速定位目标账号并获取其 kwaiId。
- 🏢 品牌 / MCN — 筛查潜在合作达人账号。
🔑 鉴权
获取 API Key
配置 API Key
REDFOX_API_KEY从环境变量获取,格式ak_xxxxxxxx- 若未设置,提示用户自行配置:
export REDFOX_API_KEY=<你的apikey>;若用户不会配置,Agent应主动帮用户设置:- macOS/Linux:将
export REDFOX_API_KEY=<值>追加到~/.zshrc(zsh)或~/.bashrc(bash),然后source对应文件使其全局生效 - Windows:使用
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")设置用户级永久环境变量(需重启终端生效) - 配置完成后应验证:
echo $REDFOX_API_KEY(macOS/Linux)或echo %REDFOX_API_KEY%(Windows),确保换一个skill也能读取到
- macOS/Linux:将
🔄 使用指南
通过快手账号名称模糊搜索定位目标账号,获取 kwaiId 后可直接用于查询该账号作品列表。
详细执行步骤、参数说明与输出格式详见
references/core_workflow.md
⏰ 数据时效说明
数据每日早上 06:00 更新(广域库快照)。
📂 相关文件
| 路径 | 用途 |
|---|---|
scripts/search_ks_user.py |
账号搜索脚本(searchUser 接口) |
references/core_workflow.md |
核心执行流程与输出规范 |
README.md |
完整接口说明与返回字段文档 |