手册目录

KOLens Cowork 插件与智能体技能 — 在 Claude 里完成达人研究

最近更新: 2026-06-10

一句话总结

KOLens 插件为 Claude Cowork 打包了三样东西：一个用你的密钥调用 KOLens 托管 API 的 stdio MCP 服务（kolens_mcp）；一个 kol-research 技能，教会 Claude 完整的 SMM 研究工作流——搜索、评估、建名单、起草触达；以及一个 /kol-search 命令用于一步式关键词查询。安装只需两个环境变量（KOLENS_API_URL、KOLENS_API_KEY）加插件文件；之后用中英文自然语言工作即可：「找 50 个有邮箱的护肤达人」直接就能跑。

插件里有什么

组件	名称	作用
技能	kol-research	教 Claude 研究工作流：全新关键词搜索、数据库查询、单账号查证、触达名单整理——含正确的工具顺序与计费意识
命令	/kol-search	一步式「关键词 → 达人」流程，适合快速查询
MCP 服务	kolens_mcp	通过你的密钥调用已部署 KOLens API 的 stdio MCP——托管服务 26 个工具中面向工作流的子集

真正拉开差距的是技能：kol-research 把验证过的工作流写进规则——什么时候该新抓取、什么时候查已有数据库、如何轮询任务、哪步查询要花积分——Claude 不用瞎猜调用哪个工具，对话更短，花费更可控。触发语句中英文都行（“find KOLs for…”、「查找KOL」、「找达人」、「导出达人数据」）。

三步安装

获取 API 密钥：登录 kolens.ai，在「账户 → API 密钥」创建。
在 Cowork 可读取的位置设置两个环境变量：
在 Cowork 插件面板添加插件（拖入 kolens.plugin 文件，或走插件安装流程），然后开始对话。

export KOLENS_API_URL="https://kolens.ai"
export KOLENS_API_KEY="kol_xxxxxxxxxxxx"

一次会话长什么样

“Find 5 fitness TikTok KOLs with over 100k followers that have emails” —— 快速数据库查询，结果连数据带联系方式直接在对话里。
「搜一下 skincare 关键词，抓 100 条视频，筛出互动率 4% 以上、有邮箱的，整理成表」——先新抓取（事前确认积分），再过滤产出。
“Look up @handle — is this account worth $800 a video?” —— 单账号查证，并基于档案给出判断。
/kol-search peptides —— 不需要对话时的命令捷径。

插件 / 托管 MCP / REST —— 怎么选

形态	适用	认证
Cowork 插件（本页）	想要技能与命令打包体验的 Cowork 桌面团队	环境变量中的 API 密钥
托管 MCP（kolens.ai/mcp）	Claude.ai 与 Claude Code——零安装，OAuth 授权	OAuth 2.1（或 API 密钥）
REST API	自建软件、后端、定时管道	Bearer 密钥

提示

三种形态共享同一账号、同一积分余额和同一数据库——在 Cowork 里开始的工作可以无缝切到网页端继续，反之亦然。

高阶用法

私有化部署：把 KOLENS_API_URL 指向你自己的部署——插件本质只是客户端。
团队预算纪律：给每位成员发放带标签的独立密钥，插件用量在报表中按人归因。
结合工作区范围：插件查询与其他客户端一样遵循 personal/team 范围——代理商成员看到的是其客户工作区的数据。

常见问题

插件额外收费吗？

不收——它与其他形态共用同一套积分计费：抓取计量（1 积分 ≈ 10 条结果），读取免费。插件本身免费安装。

我用的是 Claude.ai 不是 Cowork——需要装这个吗？

不需要——Claude.ai 用户直接在 Settings → Connectors 添加托管连接器（https://kolens.ai/mcp）即可，完全无需安装。见 MCP 接入指南。

Claude 会不问就花积分吗？

kol-research 技能要求 Claude 在发起抓取前先说明积分成本，而 API 的预扣/退款机制把最坏情况的花费限制在你明确同意的范围内。

支持中文吗？

支持——技能的触发语句和工作流天生双语（查找KOL / 找达人 / 导出达人数据），抖音搜索原生接受中文关键词。