用途:按关键词搜索 TikTok(海外抖音)博主账号,用于找同赛道对标、掌握竞争格局、筛选合作达人、跨境达人搜集与创作者研究。一个关键词一次搜索,结果以终端表格按粉丝数从高到低展示账号、昵称、粉丝数与简介。
主要能力:支持中英文关键词;支持翻页(--page,默认 1),服务端内部把 page 映射为游标;数字格式化(<10000 用原始数字,≥10000 用 x.xw),昵称超 20 字、简介超 40 字截断,为空显示 —;账号字段可能缺失或命名略有差异,需防御式读取。搜不到时说明该词较小众或当前页无数据,并给 10 个相近关键词(2~6 字)建议换方向重试,不编造数据。
使用方式:配置环境变量 DOUBAOYA_API_KEY(形如 dyh_…,在 doubaoya.com 登录后进口令中心生成)。调用脚本: python3 "$SKILL_PATH/scripts/search_tiktok_user.py" "fitness" 翻页: python3 "$SKILL_PATH/scripts/search_tiktok_user.py" "美妆" --page 2 脚本每次查询只运行一次,直接读完整 stdout,不要用 head/tail 预览或重复调用同一关键词。接口为 POST https://doubaoya.com/api/apis/tiktok/search-user/call,鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY,请求体 { "keyword": "fitness", "page": 1 }。返回信封含 success、requestId、data(items、hasMore、rid)、error。先看 success,为 true 才读 data。
限制与注意:口令绝不打印、不写进文件、不回显;所有请求只发往 doubaoya.com。常见错误:401 没带或无效口令,400 参数不合法,402 额度不足需充值/续额,404 接口路径不对,502 上游临时故障(自动退款,可安全重试),NETWORK_ERROR 连不上 doubaoya.com。本接口没有日期/发布时间参数,账号搜索不涉及时间筛选。目录结构含 SKILL.md 与 scripts/search_tiktok_user.py(零依赖 urllib 脚本)。