finding-tiktok-creators-by-location

用途

该技能用于按地理位置发现 TikTok 创作者和内容。它调用 Apify 平台上的 apidojo TikTok Location Scraper，根据给定的 TikTok 地点或标签页面 URL 抓取该位置下的帖子，从而帮助识别特定地区的创作者与内容。

主要能力

按地点抓取：输入 TikTok 地点/标签 URL（例如 https://www.tiktok.com/tag/newyork?location=true 或 https://www.tiktok.com/place/Miami-Florida-123456），抓取该位置下的帖子。
数量控制：通过 maxItems 参数限制返回的最大帖子数，默认不限。
输出转换：通过 customMapFunction 传入 JavaScript 函数，对每个输出对象进行转换。
多种输出格式：支持表格（快速答案）、CSV、JSON。
创作者评分与分级：对每个创作者按粉丝数、平均互动率、是否认证计算得分并分级。

输入参数

startUrls（数组，必填，默认 []）：TikTok 地点/位置 URL。
maxItems（数字，可选，默认不限）：返回的最大帖子数。
customMapFunction（字符串，可选）：用于转换每个输出对象的 JavaScript 函数。

使用方式

推荐使用 run_actor.js 脚本运行。

快速答案（表格）：

node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/Miami-Florida-123456"], "maxItems": 100}'

保存为 CSV：

node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/Miami-Florida-123456"], "maxItems": 100}' --output results.csv --format csv

保存为 JSON：

node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/Miami-Florida-123456"], "maxItems": 100}' --output results.json --format json

REST API 备用方式：

curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-location-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.tiktok.com/place/Miami-Florida-123456"], "maxItems": 100}'

如果 Apify MCP 可用：使用 Apify MCP 的 call_actor 工具，actor 为 apidojo~tiktok-location-scraper，输入同上。

评分与排名

对每个创作者按以下方式评分：

followers → 归一化到 0-1（上限 500K），权重 0.40
avg_engagement = (likes + comments + shares) / views → 权重 0.35
verified → 0 或 1，权重 0.25

score = 0.40 * min(followers / 500000, 1.0) + 0.35 * min(avg_engagement / 0.08, 1.0) + 0.25 * int(verified)

分级

得分 ≥ 0.70：A 级，PRIME_CREATOR
得分 0.40–0.69：B 级，GOOD_FIT
得分 < 0.40：C 级，LOW_PRIORITY

适用场景

按城市或地点寻找本地 TikTok 创作者。
分析特定地理位置的内容分布。
为地域性营销或合作筛选创作者。

限制与边界情况

必须提供 TikTok 地点页面 URL，而不是城市名称；需提示用户通过 TikTok 搜索找到该 URL。
部分地点的地理标记内容有限，只能返回可获取的结果。
同一创作者可能在该地点发布多个视频，需按 channel.username 去重。
地点帖子可能包含游客而非本地人，可交叉检查个人简介中的位置信号。
如需时效性，应按最新排序。