KOLens MCP 服务 — 让 Claude 与 AI 智能体直接调用达人数据

为什么用 MCP 而不是 REST API

MCP 是 AI 助手调用外部工具的开放协议。通过 MCP 接入 KOLens 后，Claude 可以自主跑完整个研究闭环——搜索细分领域、评估结果、建立候选名单、起草触达邮件——只需一句自然语言指令，由它自己选择并串联工具，无需编写任何集成代码。REST API（见 API 参考）适合自建软件；MCP 适合智能体与助手。

在 Claude.ai 中接入（无需安装）

1. 在 Claude.ai 打开 Settings → Connectors → Add custom connector。
2. 粘贴连接器地址：https://kolens.ai/mcp
3. Claude 会打开 KOLens 授权页——用你的 KOLens 账号确认即可。OAuth 2.1 流程（动态客户端注册 + PKCE）自动签发带权限范围的令牌，全程无需手动复制密钥。
4. 直接对 Claude 下指令，例如：“搜 50 个 ‘home fitness’ 方向的 TikTok 达人，留下有邮箱且互动率 ≥4% 的，把最好的 10 个加进名单 Q3 Fitness。”

在 Claude Code 中接入

claude mcp add --transport http kolens https://kolens.ai/mcp

首次使用时 Claude Code 会在浏览器里发起同样的 OAuth 授权。之后每个会话都能直接使用 KOLens 工具——适合研究脚本、定时智能体任务，或把达人数据接进自动化流程。

接入其他 MCP 客户端（API 密钥）

自行配置的客户端（Cursor、自建智能体、MCP SDK）可以跳过 OAuth，直接使用 Bearer 令牌。在网页端「账户 → API 密钥」创建密钥，然后让客户端携带 Authorization 头访问端点：

{
  "mcpServers": {
    "kolens": {
      "type": "http",
      "url": "https://kolens.ai/mcp",
      "headers": { "Authorization": "Bearer kol_xxxxxxxxxxxx" }
    }
  }
}

全部 26 个工具

工具名是稳定标识符——可以放心写进提示词、技能和智能体代码。按工作流分组：

OAuth 令牌带权限范围：read:kols（全部读取工具）、write:lists（监控、名单、预警、CRM 的写操作）、run:scrape（所有消耗积分的操作）。授权页会显示客户端申请的范围。

用法配方 — 可以这样下指令

• 扫一个细分领域：「抓 100 条 ‘pet grooming’ 的 TikTok 视频，然后列出有邮箱、互动率 ≥4%、粉丝 1 万–25 万的达人，按平均播放排序。」（scrape_tiktok_by_keyword → get_job_status → list_kols）
• 下单前先验真：「调出 @handle 的档案、受众画像和近期动态——受众真的在美国吗？账号真实度如何？」（get_kol_profile → get_audience_snapshot → get_kol_activity_summary）
• 周一晨报：「汇总我监控列表本周的变化，标出涨得快的。」（list_watchlist → list_alerts）
• 投放复盘：「把我们三月投放的三条追踪视频和竞品那条对比一下。」（compare_videos）
• 触达：「给 @handle 起草一封合作邮件，推我们的植物蛋白品牌，语气轻松。」（draft_outreach——草稿返回给你；KOLens 不会代发邮件。）