mcpField
S
scraping-tiktok-profile-data

scraping-tiktok-profile-data

github.com/apidojo-io数据与数据库1866 次安装24 周前更新
代码仓库

关于 scraping-tiktok-profile-data

用于批量收集 TikTok 用户名对应的账号统计数据，适合社交媒体研究。它运行 Apify 抓取器，返回个人资料信息及视频相关数据。

主要功能

  1. 01批量查询 TikTok 个人资料
  2. 02获取粉丝与关注数
  3. 03获取点赞、简介和视频数
  4. 04按日期和帖子数筛选
  5. 05导出 JSON 或 CSV

适用场景

  1. 01比较多个创作者账号的数据
  2. 02构建 TikTok 个人资料数据集
  3. 03查看指定用户名的账号信息

MCP 相关

如已安装 Apify MCP 服务，可通过它运行 Apify 抓取器；也可使用所提供的脚本或 REST API。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill scraping-tiktok-profile-data

安装后在 Claude Code 中输入/scraping-tiktok-profile-data确认已加载。

详细介绍

抓取 TikTok 个人资料数据

批量获取任意一组 TikTok 用户名的账号级统计数据。返回粉丝数、互动总数、个人简介和视频数量。

前提条件

  • 设置 APIFY_TOKEN 环境变量
  • 可选：已安装 Apify MCP 服务

输入

参数类型必填默认值备注
startUrls数组可选[]TikTok 个人资料 URL
usernames数组可选[]TikTok 用户名（不带 @）
since字符串可选—返回此日期之后发布的帖子（YYYY-MM-DD）
until字符串可选—返回此日期之前发布的帖子（YYYY-MM-DD）
maxItems数字可选不限返回的帖子数量上限
customMapFunction字符串可选—用于转换每个输出对象的 JavaScript 函数

工作流

Progress:
- [ ] Step 1: Normalize username list
- [ ] Step 2: Run tiktok-profile-scraper
- [ ] Step 3: Poll for SUCCEEDED
- [ ] Step 4: Deliver profile dataset
步骤 2：运行 Actor

推荐 — run_actor.js（自动处理等待、输出和文件保存）：

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~tiktok-profile-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~tiktok-profile-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~tiktok-profile-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

必须在环境变量或 .env 文件中设置 APIFY_TOKEN。

如果 Apify MCP 可用：

Tool: apify:run-actor
Actor: "apidojo~tiktok-profile-scraper"
Input:
{
  "usernames": ["creator1", "creator2"]
}

REST API 备用方案：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tiktok-profile-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["creator1", "creator2"]}'

将 id 保存为 RUN_ID。轮询直到 status = 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"
步骤 3：处理边缘情况
  • 未找到账号：用户名已被封禁、删除或更改。在输出中标记。
  • 私人账号：返回视频数量为 0，并附带个人资料元数据 — 标记 isPrivate: true。
  • 批次 > 500：拆分为更小的批次，以提高可靠性。

输出格式

# TikTok Profile Dataset
Accounts requested: N | Returned: N | Not found: N

| Username | Followers | Following | Total Likes | Videos | Bio (truncated) | Verified |
|----------|-----------|-----------|-------------|--------|-----------------|----------|
| ...      | ...       | ...       | ...         | ...    | ...             | ...      |

Available fields: username, nickname, followerCount, followingCount, heartCount,
videoCount, signature, verified, bioLink, avatarUrl

故障排除

缺少账号： 用户名可能已更改 — 请直接在 TikTok 上确认。 粉丝数过时： TikTok 数据可能延迟 24–48 小时；重新运行以获取最新数据。

评论

支持 Markdown