TikTok 数据抓取器 — TKLens 技术文档

TKLens 是做什么的？
你可以从 TikTok 获取哪些数据？
如何使用 TKLens 抓取 TikTok 内容？
输入参数
输出格式
深度分析报告（独有）
定价
错误码
系统架构
API 与 MCP 集成
常见问题

一、TKLens 是做什么的？

TKLens 可以从 TikTok 提取公开数据，并将其导出为你选择的格式。之后，你可以将这些数据用于自己的数据项目、业务报告，或作为新应用的基础。

从选定的用户主页提取全部视频，包括标题、播放量、点赞、评论、转发、收藏、音乐、标签、发布时间
获取账号画像：粉丝数、关注数、获赞数、简介、认证状态
平台直出字段：是否为广告（isAd）、创作地点、文本语言
以多种格式导出：JSON、CSV、Excel、HTML
独有：深度分析报告——爆款归因、投流判定、标签/音乐统计、更新节奏、风险信号（某些数据平台不做这层）
通过 MCP 服务器把 TKLens 接到任何 AI 聊天机器人

二、你可以从 TikTok 获取哪些数据？

字段	说明
👤 账号名 / 昵称 / ID	authorMeta.name、nickName、id
📝 个人简介	signature，含 bio 链接
👥 粉丝数 / 关注数	fans、following
❤️ 获赞总数	heart
▶️ 播放量	playCount（每条视频）
❤️ 点赞 / 💬 评论 / 🔁 分享	diggCount、commentCount、shareCount
📝 视频文案	text（全文案）
🏷️ 标签	hashtags（平台结构化 + 文案正则补全）
🎵 音乐	musicMeta：歌名、作者、是否原声、播放链接
🕐 发布时间	createTime / createTimeISO
🔗 视频链接	webVideoUrl
📢 是否广告	isAd（平台直标，非推断）
📍 创作地点	locationCreated（国家二字码）
🈹 文本语言	textLanguage
📌 是否置顶	isPinned
🎬 视频直链	playAddr（可下载）

三、如何使用 TKLens 抓取 TikTok 内容？

注册：用邮箱免费注册 TKLens 账号（测试阶段免费）
提交：在控制台输入任意 TikTok 用户名，如 @princessbridediamonds
等待：后台全量采集该账号所有公开视频（一般几小时内，大号最多 24 小时）
看报告：九大板块深度分析，页面看 Top10
下数据：全量 CSV 下载（视频明细/文案库/标签/音乐）

四、输入参数

网页控制台

参数	说明
`handle`	TikTok 用户名（带或不带 @ 均可）

MCP / API（traverse_account）

{
  "handle": "princessbridediamonds",
  "max_videos": 40
}

参数	类型	默认	说明
`handle`	string	必填	TikTok 用户名
`max_videos`	integer	40	最大视频数；null = 全部

五、输出格式

每条视频的 JSON 结构示例：

{
  "id": "7697441806480461070",
  "text": "How well do you know your girl? 🥰💍✨ #ring #engagementring",
  "textLanguage": "en",
  "createTime": 1756403075,
  "createTimeISO": "2025-08-28T17:44:35.000Z",
  "isAd": false,
  "locationCreated": "US",
  "authorMeta": {
    "name": "princessbridediamonds",
    "nickName": "Princess Bride Diamonds",
    "verified": false,
    "fans": 349600,
    "following": 1,
    "heart": 31800000,
    "video": 2692,
    "signature": "💍 Custom engagement rings & fine jewelry"
  },
  "musicMeta": {
    "musicName": "original sound",
    "musicAuthor": "princessbridediamonds",
    "musicOriginal": true
  },
  "playCount": 8900000,
  "diggCount": 23400,
  "commentCount": 46,
  "shareCount": 145,
  "collectCount": 1637,
  "hashtags": [{"name": "ring"}, {"name": "engagementring"}],
  "webVideoUrl": "https://www.tiktok.com/@princessbridediamonds/video/7697441806480461070"
}

六、深度分析报告（独有）

原始数据之外，TKLens 自动生成九大板块分析报告：

板块	内容
一、账号画像	粉丝/关注/获赞/简介/认证/国家一览
二、核心指标	播放中位、爆款数、互动率、更新频率、断更天数
三、投流判定	平台直标广告实锤（isAd）+ 启发式疑似投流清单
四、爆款视频	Top10 明细
五、文案库	全部文案 Top10 + 全量 CSV
六、标签统计	全量词频
七、音乐统计	BGM 使用频次
八、风险信号	疑似水军、异常涨粉预警
九、粉丝画像	待开发（测试阶段暂不可用）

查看案例：Princess Bride Diamonds 完整报告（2,730 条视频全量分析）

七、定价

测试阶段免费（需注册，每用户每天最多 10 个任务）。正式定价即将公布。

全量数据下载：与付费报告绑定。报告页面可下载全部 CSV（视频明细/文案库/标签/音乐），仅报告购买者可下载，防止数据被免费拿走自行分析。

八、错误码

errorCode	意义
`NOT_FOUND`	账号不存在
`PROFILE_PRIVATE`	账号设为私密
`PROFILE_EMPTY`	账号没有视频
`RATE_LIMITED`	采集超时/限流，稍后重试
`INVALID_INPUT`	输入参数错误

错误项结构：{"url": "...", "input": "...", "error": "...", "errorCode": "..."}

九、系统架构（前后端分离）

TKLens 采用前后端分离架构，核心分析引擎不出服务器：

前端（浏览器）：只接收渲染好的 HTML 报告和 JSON 数据，看不到任何源码
后端（服务器）：采集、分析、报告生成全在服务端 Python 中运行
接口：Web API + MCP，Token 鉴权，按调用计费

这意味着分析算法、采集策略等核心资产始终留在服务端，是收费模式的技术基础。

十、API 与 MCP 集成

Web API

端点	说明
`POST api/register`	注册 {email, password} → {token}
`POST api/login`	登录 → {token}
`POST api/tasks`	提交任务 {handle, proxy} → {task_id}（需登录；proxy 必填，http/socks5）
`GET api/tasks`	任务列表（需登录）
`GET r/{id}.html`	HTML 报告（需登录本人）

鉴权：Authorization: Bearer <token> 或 Cookie tklens_token。

MCP 服务器

端点 POST /mcp，JSON-RPC 2.0（Streamable HTTP）。7 个 tools：traverse_account、analyze_account、normalize_video、normalize_profile、extract_hashtags、detect_ad、export_report。可接入 Claude Desktop 等任何 MCP 客户端。

十一、常见问题

多久出报告？
视频分析报告：提交后后台排队处理，一般几小时内出（大号最多 24 小时），控制台实时看状态。粉丝画像数据为 T+1（约 24 小时），且测试阶段暂不可用。

支持私密账号吗？
仅公开账号。

数据准吗？
播放/粉丝为采集时刻快照；isAd 为平台实锤；投流启发式仅供参考。

和某某数据平台的区别？
某某平台卖原始数据（按条计费）；TKLens 给分析结论（按账号计费），且视频全量采集零签名成本。投流判定、爆款归因、风险信号是某某平台不做的层。

合法吗？
只采集用户选择公开分享的信息，不碰私密数据。报告仅供研究分析使用。

数据隔离吗？
每个用户的任务、报告、下载数据完全独立，只能看到自己的。所有查询记录永久保留。

用什么 IP 抓取？
必须自备代理，不走服务器 IP。支持 http://、socks5://（SS/V2Ray 均可），格式如 socks5://user:pass@host:port。不填代理无法提交任务。