apify-influencer-discovery

网红发现

使用 Apify Actors 在多个平台上发现并分析网红。

前提条件

（无需预先检查）

• 包含 APIFY_TOKEN 的 .env 文件
• Node.js 20.6+（用于原生支持 --env-file）

工作流

复制此清单并跟踪进度：

Task Progress:
- [ ] Step 1: Determine discovery source (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the discovery script
- [ ] Step 5: Summarize results

步骤 1：确定发现来源

根据用户需求选择合适的 Actor：

用户需求	Actor ID	最适合的用途
网红个人资料	apify/instagram-profile-scraper	个人资料指标、简介、粉丝数
按话题标签查找	apify/instagram-hashtag-scraper	发现使用特定话题标签的网红
Reels 互动度	apify/instagram-reel-scraper	分析 Reels 的表现和互动度
按细分领域发现	apify/instagram-search-scraper	按关键词／细分领域搜索网红
品牌提及	apify/instagram-tagged-scraper	跟踪标记品牌／产品的用户
综合数据	apify/instagram-scraper	全面的个人资料、帖子和评论分析
基于 API 发现	apify/instagram-api-scraper	快速提取基于 API 的数据
互动度分析	apify/export-instagram-comments-posts	导出评论以进行情感分析
Facebook 内容	apify/facebook-posts-scraper	分析 Facebook 帖子的表现
微型网红	apify/facebook-groups-scraper	在细分社群中寻找网红
有影响力的主页	apify/facebook-search-scraper	搜索有影响力的主页
YouTube 创作者	streamers/youtube-channel-scraper	频道指标和订阅者数据
TikTok 网红	clockworks/tiktok-scraper	全面提取 TikTok 数据
TikTok（免费）	clockworks/free-tiktok-scraper	免费的 TikTok 数据提取器
直播主	clockworks/tiktok-live-scraper	发现直播网红

步骤 2：获取 Actor 架构

获取 Actor 的输入架构和详细信息：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/fetch_actor_details.js --actor "ACTOR_ID"

将 ACTOR_ID 替换为所选的 Actor（例如，apify/instagram-profile-scraper）。

返回内容包括：

• Actor 信息（标题、描述、URL、类别、统计数据、评分）
• README 摘要
• 输入架构（必填和可选参数）

步骤 3：询问用户偏好

简单查询时跳过此步骤（例如，“Nike 有多少粉丝？”，“帮我在布拉格找 5 家咖啡店”）——直接使用快速回答模式并进入步骤 4。

对于较大规模的抓取任务，请询问：

1. 输出格式：
   • 快速回答 - 在聊天中显示少量精选结果（不保存文件）
   • CSV - 包含所有字段的完整导出
   • JSON - 以 JSON 格式完整导出
2. 结果数量：根据使用场景的性质确定

成本安全：务必在 Actor 输入中设置合理的结果上限（例如 maxResults、resultsLimit、maxCrawledPages，或输入架构中的等效字段）。除非用户明确要求更多结果，否则默认设为 100 条。运行大型抓取任务（1000 条以上）前，请提醒用户，因为这会消耗更多 Apify 额度。

步骤 4：运行脚本

快速回答（在聊天中显示，不生成文件）：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.csv \
  --format csv

JSON：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.json \
  --format json

步骤 5：总结结果

完成后，报告：

• 找到的网红数量
• 文件位置和名称
• 可用的关键指标（粉丝数、互动率等）
• 建议的后续步骤（筛选、联系、深入分析）

错误处理

APIFY_TOKEN not found - 请用户创建包含 APIFY_TOKEN=your_token 的 .env Actor not found - 检查 Actor ID 拼写 Run FAILED - 请用户检查错误输出中的 Apify 控制台链接 Timeout - 减少输入大小或增加 --timeout