用途 该技能用于从任意 TikTok 视频链接抓取评论，导出原始评论数据集，供情感分析、社区研究或产品反馈提取等用途。
主要能力
- 从指定的 TikTok 视频 URL 抓取评论。
- 支持选择是否包含嵌套的回复评论。
- 支持设置最大返回评论条数。
- 支持通过自定义 JavaScript 函数对每条输出对象进行转换。
- 输出字段包括：id、text、authorUsername、diggCount、replyCount、createTime、isReply、parentCommentId。
输入参数
- startUrls：数组，必填，默认空数组，指要抓取评论的 TikTok 视频 URL。
- includeReplies：布尔值，可选，默认 false，是否包含回复评论（嵌套）。
- maxItems：数字，可选，默认不限，最大返回评论数。
- customMapFunction：字符串，可选，用于转换每个输出对象的 JavaScript 函数。
使用方式 前置条件：设置 APIFY_TOKEN 环境变量；可选安装 Apify MCP 服务器。
方式一：运行 node 脚本 run_actor.js（会自动等待、输出并保存文件）。
快速查看（在聊天中打印表格）：
node scripts/run_actor.js
--actor "apidojo~tiktok-comments-scraper"
--input '{"param": "value"}'
保存为 CSV：
node scripts/run_actor.js
--actor "apidojo~tiktok-comments-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.csv --format csv
保存为 JSON：
node scripts/run_actor.js
--actor "apidojo~tiktok-comments-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.json --format json
方式二：若可用 Apify MCP，使用工具 apify:run-actor，Actor 为 "apidojo~tiktok-comments-scraper"，输入示例： { "videoUrls": ["https://www.tiktok.com/@user/video/123456"], "maxItems": 200, "includeReplies": false }
方式三：REST API 备用方式。
发起运行：
curl -X POST
"https://api.apify.com/v2/acts/apidojo~tiktok-comments-scraper/runs?token=$APIFY_TOKEN"
-H "Content-Type: application/json"
-d '{"videoUrls": ["<url>"], "maxItems": 200}'
保存返回的 id 为 RUN_ID，轮询直到状态为 SUCCEEDED：
curl "https://api.apify.com/v2/actor-runs/$RUN_ID?token=$APIFY_TOKEN" | grep '"status"'
获取结果：
curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN&format=json"
工作流程
- 验证视频 URL。
- 运行 tiktok-comments-scraper。
- 轮询直到 SUCCEEDED。
- 交付评论数据集。
输出格式
TikTok Comment Dataset
Video: <url> | Comments collected: N | Includes replies: YES/NO
| Comment ID | Author | Text | Likes | Replies | Timestamp |
|---|---|---|---|---|---|
| ... | ... | ... | ... | ... | ... |
边界情况处理
- 0 条评论：视频可能已关闭评论或为私密，需向用户报告。
- 视频被删除或不可用：Actor 返回错误，需从批次中移除该 URL 并通知。
- 评论数少于预期：TikTok 会在服务端过滤垃圾评论，属预期情况。
故障排查
- 评论被关闭：创作者已关闭评论，无变通办法。
- 评论被截断：部分评论可能被 TikTok API 截断，完整文本可通过视频页面查看。
适用场景 适用于需要对 TikTok 视频评论进行批量获取和分析的场景，如情感分析、社区研究、产品反馈提取等。
限制 使用前必须设置 APIFY_TOKEN。该技能依赖 Apify 平台的 apidojo~tiktok-comments-scraper Actor 及网络访问。评论被关闭时无法获取。部分评论可能被平台过滤或截断。关于费用、价格、平台支持范围等更多信息，资料中暂未提供。