skills/douyin-kol-search

stars:0
forks:0
watches:0
last updated:N/A

AI Skills 技能库：为每一个场景做真正有价值的AI技能库

大多数人用 AI 还停在「问一句答一句」。AI Skills（ai-skills.ai）想换一种姿势：把 AI 能力拆成一条条能直接执行的 Skill，像查字典一样调出来用。无论你从 AI Skills 官网、skills.sh 还是 ClawHub 进入，先按这 5 步完成接入，再继续看当前技能说明。

AI Skills 官网场景导览图

快速开始

1. 扫码登录

扫码登录 AI Skills 账号

先在 AI Skills 官网完成扫码登录，确保后续 API Key、安装命令和技能调用都绑定到同一个账号。

2. 申请 API Key

在 AI Skills 站点申请 API Key

登录后进入 API Key 页面申请密钥，后续 CLI 安装和运行技能都会读取 AISKILLS_API_KEY。

3. 复制安装命令

复制 AI Skills 技能安装命令

在 AI Skills 官网、skills.sh 或 ClawHub 页面复制安装命令，优先使用官方 CLI，避免手动拼接参数。

4. 执行安装命令

在终端执行 AI Skills 安装命令

回到终端执行安装命令，CLI 会写入 AISKILLS_API_KEY，并调用下游 skills add 完成技能安装。

5. 成功获取技能

AI Skills 技能安装成功界面

安装成功后，你会在 agent 的技能列表里看到对应 Skill，可以直接调用并复用到工作流中。

当前技能：douyin-kol-search

概述

抖音最具商业价值 KOL

什么时候使用

适用场景

  • the user asks who is worth collaborating with
  • the user asks who sells best
  • the user asks for Douyin benchmark accounts
  • the user asks for same-track / competitor / similar creators on Douyin

典型用户提问

  • 谁值得合作？
  • 谁最会带货？
  • 帮我找几个抖音对标账号
  • 帮我找母婴 / 美妆 / 本地探店赛道的同类达人

不要用于

  • the user wants a hot topic list
  • the user wants rising topic discovery
  • the user wants comment analysis

相邻技能选择

  • use douyin-hotlist-overall for hot content
  • use douyin-realtime-hot-rise for topic opportunity discovery

调用方式

通过导出的 Python runner 直接调用 AI Skills API：

命令示例

按赛道和粉丝范围筛选

python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧","contentTag":"tag-48","followerRange":"10-100"}'

只按关键词搜达人

python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧"}'

只按分类搜达人

python3 scripts/run.py --params '{"contentTag":"tag-48"}'

参数说明

参数类型必填默认说明
contentTagstring否-内容标签编码，传入 tag-{id}。可只填该字段按赛道搜索，具体映射见下方「contentTag 取值参考」；keyword、contentTag 至少填写一个
keywordstring否-赛道关键词，如「深圳烧烤酒吧」。与 contentTag 至少填写一个
followerRangestring否-格式为「最小值-最大值」，单位是万，例如 10-100 表示 10 万到 100 万粉丝

参数约束：keyword、contentTag 至少填写一个。

完整机器可读参数结构见 references/form-schema.json。

参数取值参考

contentTag

字段说明：内容分类

标签值
美妆tag-1
时尚tag-6
萌宠tag-11
测评tag-15
游戏tag-23
二次元tag-25
旅行tag-27
汽车tag-31
生活tag-36
音乐tag-41
舞蹈tag-46
美食tag-48
母婴亲子tag-55
运动健身tag-60
科技数码tag-64
教育培训tag-68
颜值达人tag-72
才艺技能tag-79
影视娱乐tag-85
艺术文化tag-87
财经投资tag-91
三农tag-95
剧情搞笑tag-97
情感tag-100
园艺tag-102
随拍tag-130
房产tag-139
生活家居tag-1001
媒体号tag-1002

支持的输入格式

当前技能直接接收 JSON 参数，不涉及分享链接解析。

示例请求

下面的示例参数可直接传给 scripts/run.py，runner 会把它们发送给 AI Skills API。

python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧","contentTag":"tag-48","followerRange":"10-100"}'

等价的 --params JSON：

{
  "keyword": "深圳烧烤酒吧",
  "contentTag": "tag-48",
  "followerRange": "10-100"
}

返回结果示例

{
  "success": true,
  "data": {
    "keyword": "深圳烧烤酒吧",
    "platformSource": "_1",
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 1
    },
    "items": [
      {
        "uid": "kol-1",
        "nickname": "深圳烧烤王",
        "region": "广东 深圳",
        "followerCount": 560000,
        "interactionRate30d": 0.082,
        "convertIndex": 82,
        "spreadIndex": 76,
        "starIndex": 91,
        "expectedPlayCount": 320000,
        "price20_60": 180000,
        "contentTags": [
          "美食"
        ]
      }
    ],
    "searchStrategy": {
      "usedFallback": true,
      "droppedFilters": [
        "contentTag"
      ],
      "localContentTagFilterApplied": true
    }
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

结果重点看什么

  • data.items：达人列表，优先看 starIndex、convertIndex、spreadIndex。
  • data.searchStrategy：是否发生了筛选回退，便于判断结果是否为宽松匹配。
  • item.contentTags：达人赛道标签，用来核对分类筛选是否准确。

运行前准备

  • AISKILLS_BASE_URL：默认 https://ai-skills.ai
  • AISKILLS_API_KEY：必填，用于认证调用
  • AISKILLS_TENANT_ID：默认 default

备注

当前导出包由 AI Skills 站点目录自动生成，运行时后端仍然指向 douyin-kol-search 对应的 AI Skills API/工作流。

    Good AI Tools