apify-influencer-discovery

达人发现

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

前提条件

（无需提前检查）

• .env 文件中包含 APIFY_TOKEN
• Node.js 20.6+（支持原生 --env-file）
• mcpc CLI 工具：npm install -g @apify/mcpc

工作流

复制此清单并跟踪进度：

Task Progress:
- [ ] Step 1: Determine discovery source (select Actor)
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] 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 架构

使用 mcpc 动态获取 Actor 的输入架构和详细信息：

export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content"

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

返回内容包括：

• Actor 描述和 README
• 必填和可选输入参数
• 输出字段（如果有）

第 3 步：询问用户偏好

运行前，询问：

1. 输出格式：
   • 快速回答 - 在聊天中显示前几个结果（不保存文件）
   • CSV - 导出全部字段
   • JSON - 以 JSON 格式完整导出
2. 结果数量：根据用例特点确定

第 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 文件 mcpc not found - 请用户安装 npm install -g @apify/mcpc Actor not found - 检查 Actor ID 拼写 Run FAILED - 请用户检查错误输出中的 Apify 控制台链接 Timeout - 减少输入量或增大 --timeout