mcpField
D
discovering-brand-ambassadors-across-platforms

discovering-brand-ambassadors-across-platforms

github.com/apidojo-io营销与增长1835 次安装24 周前更新
代码仓库

关于 discovering-brand-ambassadors-across-platforms

apidojo intelligence skills library 中的营销技能，使用 Apify 的 Instagram scraper 寻找并评估潜在品牌大使。它按综合触达量划分创作者等级，并分别保留各平台的受众规模。

主要功能

  1. 01抓取 Instagram 个人资料及内容
  2. 02按触达量划分创作者等级
  3. 03计算跨平台受众触达分数
  4. 04分别列出各平台受众数据

适用场景

  1. 01通过品牌标签寻找创作者
  2. 02按受众触达量排列潜在品牌大使

MCP 相关

可在 Apify MCP 服务可用时，通过它运行 Apify Instagram scraper。

安装

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

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill discovering-brand-ambassadors-across-platforms

安装后在 Claude Code 中输入/discovering-brand-ambassadors-across-platforms确认已加载。

详细介绍

跨平台发现品牌大使

使用 apidojo 抓取工具执行跨平台品牌大使发现。属于 apidojo intelligence 技能库。

前提条件

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

输入

参数类型必填默认值说明
startUrls数组✅[]Instagram URL — 主页、话题标签、地点、音频页面、Reels
until字符串可选—抓取截至此日期（YYYY-MM-DD）的帖子
maxItems数字可选不限返回的最大帖子数
customMapFunction字符串可选—用于转换每个输出对象的 JavaScript 函数

工作流

Progress:
- [ ] Step 1: Define parameters
- [ ] Step 2: Run instagram-scraper
- [ ] Step 3: Filter and classify results
- [ ] Step 4: Score by quality and relevance
- [ ] Step 5: Deliver output
步骤 2：运行 Actor

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

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

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

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

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

如果 Apify MCP 可用：

Tool: apify:run-actor
Actor: "apidojo~instagram-scraper"
Input:
{
  "searchTerms": ["#[brand]", "#[brand]ambassador", "#[brand]fam"],
  "maxItems": 100
}

REST API 备用方案：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~instagram-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["#[brand]", "#[brand]ambassador", "#[brand]fam"], "maxItems": 100}'

等待 SUCCEEDED。获取数据集：

curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN"
步骤 3：分类结果
classification: MEGA (combined reach > 500K) | MACRO (100K-500K) | MICRO (10K-100K) | NANO (1K-10K)
步骤 4：为每个结果评分
score = combined_reach = IG_followers + TikTok_followers * 0.8 + Twitter_followers * 0.5  # platform-weighted
步骤 5：边缘情况
  • 同一位创作者在不同平台上的受众规模往往差异很大 — 分别列出各平台的数据，不要直接求和

其他备用方案：

  • 少于 20 条结果：扩大搜索词范围；移除次要筛选条件
  • 没有结果：确认搜索词是否正确；尝试其他表述方式
  • 数据质量问题：移除缺少关键字段的条目；在输出中注明数量

输出格式

# Discovering Brand Ambassadors Across Platforms
Results: [N] | Date: [DATE]

| # | [Key Field] | [Metric 1] | [Metric 2] | [Classification] | [Score] |
|---|------------|-----------|-----------|-----------------|---------|
| 1 | [value] | [value] | [value] | [type] | [0.XX] |

## Summary
Top result: [description]
Key finding: [insight]

故障排除

结果太少： 扩大主要搜索词范围；移除限制性筛选条件。 结果质量较低： 应用最低分数阈值（≥ 0.50）以过滤噪声。 Actor 运行失败： 确认 API 密钥；在 apify.com/apidojo 查看 Actor 状态。

评论

支持 Markdown