关于 meta-ads-scraper
用于搜索 Meta 广告库的营销 Agent 技能,通过 ColdIQ 异步端点按关键词或网址查找正在投放视频广告的品牌。适合 DTC 和电商客户的潜在客户开发,并提供分阶段搜索词策略。
主要功能
- 01提交 Meta 广告搜索任务
- 02轮询异步任务并读取结果
- 03按四阶段搜索词策略查找品牌
- 04汇总并去重发现的品牌
- 05指导后续线索补全与评分
适用场景
- 01为 DTC 客户寻找活跃广告品牌
- 02按行业或地区搜索广告主
- 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):
- 提交一个关键词/搜索词(或 URL)。
→ POST
/v1/meta-ads/search· 固定 ·meta_ads.search.create{ "query": "shop now free shipping", "country": "US" } - 持续轮询,直到任务完成,然后读取广告。
→ 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 中排名靠前的搜索词,目标设为加拿大。
爬取后——后续步骤
- 去重发现的品牌(参见 list-dedup)。
- 解析并丰富信息:域名 → 公司 LinkedIn → 公司资料 (参见 coldiq-search-enrich、contact-enrichment)。
- 评分,对照客户 ICP(参见 tam-scoring)。
- 为符合条件的公司获取联系人,然后将其添加到营销活动(参见 instantly-api)。
质量说明
- 对广告运营成熟的品牌,筛选拥有 10 条以上视频广告的品牌;对于较小的垂直品类,可降低门槛(5 条以上)。
- Meta 上的广告主名称在信息丰富前需要清理(去掉“LLC”、表情符号和店铺后缀)。
- 广告很多但找不到对应域名的品牌,通常是 marketplace 卖家,应降低优先级。
评论
支持 Markdown