apify-influencer-brand-collabs

网红–品牌合作

通过串联四个 Apify Actor，从 Meta 广告资料库中展示 Instagram 品牌内容合作。内容提炼自生产环境中的 influencer-brand-collabs mini-tool。

适用场景

• “本季度 Nike 花钱请了谁来推广？”
• “@bellahadid 为哪些品牌发布了赞助帖子？”
• 审核账号的品牌内容历史
• 构建竞争对手的网红阵容

不适用： 自然提及或标签（请使用话题标签／提及抓取工具）、TikTok 或 YouTube 合作（平台不同）、泛化的竞争对手广告（直接查询 Meta 广告资料库）。

需要收集的输入

1. Instagram 用户名或 URL — @adidas 或 https://www.instagram.com/adidas/
2. 回溯时间范围 — 天数；默认值为 90
3. 数据补充开关（每项都会增加成本和耗时）：
   • 内容数据 — 每项合作的点赞数、评论数、观看次数
   • 个人资料补充 — 另一方的粉丝数、简介、认证状态

合作方向（品牌还是创作者）通过实证检测。不要询问。

工作流

#	Actor	用途	必需
1	apify/instagram-profile-scraper	获取目标的 Facebook fbid	✓
2	apify/brand-collaboration-scraper	从 Meta 广告资料库抓取品牌内容帖子	✓
3	apify/instagram-post-scraper + apify/instagram-reel-scraper	互动数据	可选
4	apify/instagram-profile-scraper（再次调用）	补充结果中合作方的资料	可选

通过 mcp__claude_ai_Apify__call-actor 调用每个 Actor。如果之前从未运行过这些 Actor，并且想查看确切的输入架构，请先使用 mcp__claude_ai_Apify__fetch-actor-details。

步骤 1 — 获取目标

// actor: apify/instagram-profile-scraper
{ "usernames": ["adidas"] }

从第一项中获取 fbid。没有 fbid → 无法查询广告资料库 → 停止并告知用户。 最常见的原因：账号为私密账号。

步骤 2 — 构建 Meta 广告资料库 URL

https://www.facebook.com/ads/library/branded_content/?id={fbid}&query={username}&target=instagram&start_date={YYYY-MM-DD}&end_date={YYYY-MM-DD}

日期范围 = 回溯时间范围（默认 90 天，截止到今天）。

步骤 3 — 获取合作信息

// actor: apify/brand-collaboration-scraper
{ "startUrls": ["<ad library url>"], "resultsLimit": 10 }

架构固定：每项都有 creator（始终是网红一方）和 brandPartners[0]（始终是品牌一方）。不要尝试根据这些字段推断合作方向。

步骤 4 — 通过实证检测方向

统计目标用户名在结果两侧出现的次数：

• 目标更多出现在 creator 一侧 → 目标是网红；结果是品牌
• 目标更多出现在 brandPartners 一侧 → 目标是品牌；结果是创作者

⚠️ 不要使用 isBusinessAccount 来推断方向。该字段并不可靠——例如，@fifaworldcup 是商业账号，但会作为其自有品牌内容的创作者出现。

步骤 5 — （可选）内容指标

按类型拆分合作 URL：

• /reel/... → Reels 抓取工具
• /p/... 或 /tv/... → 帖子抓取工具

// actor: apify/instagram-post-scraper
{ "username": ["<post urls>"], "resultsLimit": 1, "dataDetailLevel": "basicData" }

// actor: apify/instagram-reel-scraper
{ "username": ["<reel urls>"], "resultsLimit": 1 }

通过 URL 中的 shortcode 匹配回合作信息：/(p|reel|tv)/([A-Za-z0-9_-]+)。

互动公式： likesCount + commentsCount + (videoViewCount ?? videoPlayCount ?? 0)。

并行运行两个抓取工具——它们相互独立。

步骤 6 — （可选）补充结果一侧的资料

从非目标的一侧收集不重复的用户名。然后：

// actor: apify/instagram-profile-scraper
{ "usernames": [<unique result-side usernames>] }

只补充用户真正关心的一侧。输入的用户名已知。

展示内容

汇总后，展示：

• 核心统计： 合作总数、合作方数量、总互动量（如果已补充指标）
• 互动量最高的 5 项合作 — 只有启用了内容数据时才有意义
• 内容类型构成： 帖子与 Reel；Reel 通常贡献大部分互动量
• 覆盖日期范围的每周时间线 — 峰值可揭示活动启动时间
• 合作方卡片（补充了个人资料时）：用户名、全名、粉丝数、认证状态、类别、本次运行中的合作数、平均互动量

对于询问“是谁”的问题，仅提供合作方列表就足够了。只有询问“哪项最好”时，指标才有意义。

URL 解析

提取用户名之前，先去掉 Instagram 的 _u/ 和 _n/ 深层链接前缀：

/instagram\.com\/(?:_u\/|_n\/)?([A-Za-z0-9_.]+)/i

这些 slug 不是用户名，应跳过： explore、reels、stories、direct、accounts、about、p、reel、tv、tags、 locations、_u、_n。

注意事项

• 目标账号是私密账号 → 个人资料爬虫不会返回 fbid。应尽早退出并给出明确提示。
• 没有结果 → 按顺序尝试：扩大日期范围、仔细检查用户名（去掉 _u/）、确认该账号确实发布了品牌内容。Meta 只会索引其归类为品牌内容的广告。
• 互动数据全为零 → 用户跳过了内容丰富化。建议重新运行并启用该选项。
• 输出中的方向似乎有误 → 重新核实实测数量。不要相信 isBusinessAccount。
• 没有指标的品牌合作仍然可以回答“是谁”这类问题，不要因为缺少丰富化数据而阻止整个流程。

成本与耗时

完整的 4 个 Actor 运行：约 3–5 分钟，Apify 计算费用为几美分。大致如下：

丰富化	运行的 Actor 数量	大约耗时
无	2	1–2 分钟
+ 内容	3–4	2–4 分钟
+ 个人资料	+1	+30–60 秒

如果用户只需要合作伙伴列表，请跳过这两个开关。

参考实现

此技能提炼自以下生产路由： mini-tools-main/src/app/api/tools/influencer-brand-collabs/route.ts — 包含完整的转换逻辑、错误处理，以及各爬虫输出的精简展示格式。