mcpField
M
meta-ads-scraper

meta-ads-scraper

github.com/cold-iq营销与增长348 次安装2 周前更新
代码仓库

关于 meta-ads-scraper

用于搜索 Meta 广告库的营销 Agent 技能,通过 ColdIQ 异步端点按关键词或网址查找正在投放视频广告的品牌。适合 DTC 和电商客户的潜在客户开发,并提供分阶段搜索词策略。

主要功能

  1. 01提交 Meta 广告搜索任务
  2. 02轮询异步任务并读取结果
  3. 03按四阶段搜索词策略查找品牌
  4. 04汇总并去重发现的品牌
  5. 05指导后续线索补全与评分

适用场景

  1. 01为 DTC 客户寻找活跃广告品牌
  2. 02按行业或地区搜索广告主
  3. 03筛选品牌并补全潜在客户信息

安装

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

$npx skills add https://github.com/cold-iq/coldiq-marketplace-skills --skill meta-ads-scraper

安装后在 Claude Code 中输入/meta-ads-scraper确认已加载。

附带文件resources/async-job-pattern.md

详细介绍

Meta Ad Library 搜索

在 Meta 上查找正在投放视频广告的品牌——这是营销预算充足且数字化成熟度较高的有力信号——并将它们转化为 DTC/电商客户的新潜在账户。

此方案使用 ColdIQ 的异步 Meta Ads 端点,取代任何本地 Playwright/SQLite Meta 爬虫:无需本地浏览器,也无需维护数据库。核心价值——135 个搜索词的策略——保留在下方,作为提交的查询集。

ColdIQ Marketplace 端点

任务方法路径积分端点 ID说明
发起 Meta Ads 搜索POST/v1/meta-ads/search固定meta_ads.search.create异步;返回 jobId
获取搜索结果GET/v1/meta-ads/search/{jobId}免费meta_ads.search.result运行中返回 202,完成后返回 200

运行方法

对每个搜索词,提交一个任务并轮询结果(参见 resources/async-job-pattern.md):

  1. 提交一个关键词/搜索词(或 URL)。 → POST /v1/meta-ads/search · 固定 · meta_ads.search.create
    { "query": "shop now free shipping", "country": "US" }
    
  2. 持续轮询,直到任务完成,然后读取广告。 → GET /v1/meta-ads/search/{jobId} · 免费 · meta_ads.search.result

遍历下方的搜索词集(每个搜索词提交一个任务),汇总品牌,然后去重。

搜索策略——4 个阶段,共 135 个搜索词

关键洞察:通用 DTC 广告用语比细分产品关键词更有效。 珠宝、婴儿用品和营养补充剂品牌都会投放“立即购买,免运费”广告。拥有 10 条以上视频广告的品牌,意味着其广告运营真实且成熟(有预算、创意团队和效果营销负责人)。

  • 阶段 1——通用 DTC 视频广告钩子(35 个,美国):“立即购买,免运费”、“使用优惠码立省”、“订阅省钱”、“限时优惠”、“使用前后效果”、“真实客户,真实效果”、“无风险试用”、“登上《创智赢家》”、“畅销品”、“经临床验证的效果”、“看接下来会发生什么”、“我试用了这个”、“真实评价”、“颠覆性产品”、“为什么大家都在转用”、“领取免费样品”、“今日独家优惠”、“立省 20%”、“首单免费”、“组合购买更省”、“即将售罄”……
  • **阶段 2——待覆盖的垂直品类(47 个,美国):**婴儿与育儿(婴儿必需品、婴儿房必备、幼儿零食、尿布订阅、产后用品、孕妇装、有机婴儿食品、儿童维生素软糖……);珠宝与配饰(高级珠宝、订婚戒指、个性化珠宝、精巧珠宝、诞生石、男士珠宝……);葡萄酒与烈酒(葡萄酒配送、精酿烈酒、龙舌兰酒、葡萄酒俱乐部、天然葡萄酒、梅斯卡尔酒、硬苏打酒、无酒精烈酒……);乳制品与替代乳制品(燕麦奶、植物奶、希腊酸奶、奶酪订阅、草饲黄油、益生菌开菲尔……)。
  • **阶段 3——品牌相关信号(33 个,美国):**订阅盒、精选订阅、自动配送、会员专享;品牌新品发布、DTC 品牌首发、创始人故事、小批量手工制作;免费退货、买一赠一、限时闪购、新品上架、当下热门;情人节/母亲节/父亲节/节日礼物指南/夏日必备。
  • **阶段 4——加拿大(20 个,加拿大):**重新运行阶段 1–3 中排名靠前的搜索词,目标设为加拿大。

爬取后——后续步骤

  1. 去重发现的品牌(参见 list-dedup)。
  2. 解析并丰富信息:域名 → 公司 LinkedIn → 公司资料 (参见 coldiq-search-enrich、contact-enrichment)。
  3. 评分,对照客户 ICP(参见 tam-scoring)。
  4. 为符合条件的公司获取联系人,然后将其添加到营销活动(参见 instantly-api)。

质量说明

  • 对广告运营成熟的品牌,筛选拥有 10 条以上视频广告的品牌;对于较小的垂直品类,可降低门槛(5 条以上)。
  • Meta 上的广告主名称在信息丰富前需要清理(去掉“LLC”、表情符号和店铺后缀)。
  • 广告很多但找不到对应域名的品牌,通常是 marketplace 卖家,应降低优先级。

评论

支持 Markdown