mcp-brand-sponsor-finder

品牌赞助商查找 MCP 服务

查找过去 90 天内在某个细分领域赞助过创作者的品牌，并查看每次赞助的公开证据。每个品牌占一行，并附有近期程度评分；每次出现也各占一行，并附上证据链接、日期和优惠码。

内容概览

• 功能介绍
• 快速开始
• 前提条件
• 提示词示例
• 工具
• 输入项
• 定价
• 你的密钥
• Actor 完整文档
• 许可证

功能介绍

• 从公开的 YouTube 视频说明（频道 Feed，或你自己的 YouTube Data API 密钥）、播客节目说明、新闻邮件期刊和活动赞助商页面中读取赞助商信息、优惠码和赞助位。
• 跟踪短链接和联盟营销重定向，找到品牌自己的域名，并将每次出现合并为每个品牌域名一行。
• 检查找到的品牌是否发布了招聘合作伙伴的职位（Greenhouse、Lever、Ashby），以及创作者或联盟营销计划页面，并将其作为品牌的公开联系方式。
• 仅返回你所选日期范围内的记录，每条都附有证据链接。不读取 Instagram、TikTok 和 Meta 广告资料库。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 Actor 运行、等待运行完成，并返回数据集行。

行数上限与分页

一次运行可能返回数百行（在 30 天的健康与健身搜索中有 633 行、约 0.8 MB 文本），超出 Agent 的上下文容量。因此，每次调用最多返回 max_rows 行：默认 50 行，且最多不超过 200 行。

1. 首次调用会启动运行并返回第一页。第一个内容块是行组成的 JSON 数组。第二个是分页块，包含 run_id、total_rows、rows_returned 和 next_cursor。
2. 获取下一页时，只需再次调用 find_brand_sponsors 并设置 cursor 为 next_cursor。添加 max_rows 可更改每页行数。
3. 重复此操作，直到 next_cursor 为 null。

调用游标不会启动新的运行，而是读取首次运行已写入的下一页数据，因此不会重复计费。只要 Apify 保留该运行的数据集，游标就一直有效。

快速开始

你需要 Node.js 18 或更高版本，以及拥有 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置（claude_desktop_config.json）、Cursor 或任意 MCP 客户端中：

{
  "mcpServers": {
    "mamba-brand-sponsor-finder": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-brand-sponsor-finder"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端后，即可看到 find_brand_sponsors 工具。

前置条件

• Node.js 18 或更高版本。
• 在 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设为 APIFY_TOKEN。该服务无需令牌即可列出工具；调用工具时需要令牌。

示例提示词

• “查找过去 90 天内赞助健康与健身创作者的品牌。”
• “本月哪些品牌付费给了美妆 YouTuber？仅列出品牌行。”
• “列出赞助播客和新闻简报的咖啡品牌，并附上促销代码。”

工具

find_brand_sponsors。共一个工具。示例参数：

{
  "niche": "health and fitness",
  "window_days": "90"
}

输入

Actor 的所有面向买家的输入，保持不变，另加两个分页设置。省略的输入使用 Actor 自身的默认值。数字和布尔值以字符串形式发送。

输入	类型	描述
niche	string	受众细分领域，例如“健康与健身”“美容与护肤”或“食品与饮料”。频道、节目和新闻简报的搜索会使用此项，且每一行都会包含此项。这三个细分领域还会从 Mamba Labs 以前读取过的来源列表开始（通过 use_niche_presets 关闭）
audience_keywords	string	可选。受众的更多搜索词，每行一个或用逗号分隔，例如“力量训练”。每个词都会扩大播客、新闻简报以及（使用你的密钥时）YouTube 频道的搜索范围。最多 20 个。这是一个文本字段，因此可以直接映射 Clay 列
window_days	string	仅包含最近 N 天内的发现记录。整数，默认值为 90，最多 365。以文本形式发送，以便 Clay 正常工作。默认值：90
sources	string	可选。要运行的来源，用逗号分隔，可选项：youtube、podcast、event、newsletter、job_post、program。留空则运行全部来源。job_post 和 program 会检查其他来源发现的品牌
seed_sources	string	可选。要优先读取的 YouTube 频道 URL 或 @handle、播客 RSS 源 URL，或新闻简报 URL，每行一个或用逗号分隔。即使超出每种来源的限制，也会读取每个来源
event_calendar	string	可选。要读取其赞助商或合作伙伴页面的活动，格式为 JSON 对象列表：[{"name": "...", "url": "赞助商页面 URL", "date": "YYYY-MM-DD", "city": "...", "audience": "...", "size": "..."}]，或每行一个赞助商页面 URL。必须提供 url；其余字段均为可选。窗口期内日期明确的活动会生成带日期的行；日期不明或即将举行的活动会生成不带日期的行
use_niche_presets	string	true 或 false，默认值为 true。对于健康与健身、美容与护肤以及食品与饮料，还会读取 Mamba Labs 以前读取过的频道、节目、新闻简报和活动页面。默认值：true
include_brands	string	true 或 false，默认值为 true。每个品牌域名对应一行，包含发现次数、最近发现日期、来源、创作者或活动、联系方式和新近度评分。默认值：true
include_sightings	string	true 或 false，默认值为 true。每条发现记录对应一行，包含证据链接、日期、促销代码、展示类型和推介角度。默认值：true
max_channels	string	每次运行读取的 YouTube 频道数。整数，默认值为 20，最多 100。以文本形式发送，以便 Clay 正常工作。默认值：20
max_videos_per_channel	string	每个频道读取的最新上传视频数（公开 Feed 最多提供 15 个）。整数，默认值为 15，最多 50。以文本形式发送，以便 Clay 正常工作。默认值：15
max_podcasts	string	每次运行读取的播客节目数。整数，默认值为 15，最多 100。以文本形式发送，以便 Clay 正常工作。默认值：15
max_episodes_per_podcast	string	每个节目读取的最新剧集数。整数，默认值为 8，最多 30。以文本形式发送，以便 Clay 正常工作。默认值：8
max_newsletters	string	每次运行读取的新闻简报数。整数，默认值为 8，最多 50。以文本形式发送，以便 Clay 正常工作。默认值：8
max_issues_per_newsletter	string	每份新闻简报读取的最新期数。整数，默认值为 8，最多 30。以文本形式发送，以便 Clay 正常工作。默认值：8
max_brands_to_check	string	要检查其招聘页面和项目页面的品牌数，按发现次数从多到少排序。整数，默认值为 25，最多 200。以文本形式发送，以便 Clay 正常工作。默认值：25
max_charge_usd	string	可选。如果收费将超过此金额，则停止运行
max_rows	string	Wrapper 设置，不会发送给 Actor。每次调用返回的行数：整数，默认值为 50，最多 200
cursor	string	Wrapper 设置，不会发送给 Actor。使用上一次调用返回的 next_cursor。不会启动运行，而是返回该次运行的下一页行数据

定价

在 Apify 上按事件付费，费用计入你的 Apify 账户。价格单位为 USD。

事件	免费计划	Bronze	Silver	Gold
brand-row，以一行形式返回一个品牌：域名、出现次数、最近出现日期、来源、其赞助过的创作者或活动、公开联系方式和新近度评分	$0.02	$0.019	$0.018	$0.017
sighting-row，以一行形式返回一个公开投放：品牌、来源、创作者或活动、日期、证据链接、促销代码、投放类型和宣传角度	$0.005	$0.00475	$0.0045	$0.00425
apify-actor-start，每次运行启动	$0.002	$0.002	$0.002	$0.002

免费行：没有结果的运行会写入一条免费行，说明原因；被拒绝的输入会写入一条免费行，其 error_reason 以 input_invalid: 开头。

你的密钥

无需密钥。你可以选择使用自己的 YouTube Data API 密钥：在此服务的环境中设置 YOUTUBE_API_KEY，密钥便会作为 youtube_api_key 传递给 Actor，因此不会经过对话。使用该密钥后，Actor 会在 YouTube 上搜索相关细分领域的频道，并读取每个频道最多 50 个上传内容。

Actor 完整文档

apify.com/mambalabs/brand-sponsor-finder

许可证

MIT。请参阅 LICENSE。