用途：从 Meta 广告库抓取竞品广告，覆盖 Facebook、Instagram、Messenger、Threads 和 WhatsApp，用于竞品广告研究、行业广告格局分析和多竞品对比。
主要能力：按公司名或关键词搜索，也可用 --page-url 传入 Facebook 主页 URL 做精确匹配，或传入域名；支持国家代码（如 US、GB、DE 或 ALL）、广告状态（active 或 all）、最大返回数量（默认 50）、输出格式（json 或 summary）。输出字段包括 ad_id、page_name、page_id、ad_text、创意链接标题/描述/URL、image_url、video_url、投放起止时间、currency、spend_lower/upper、impressions_lower/upper、platforms、status。
使用方式：需设置 APIFY_API_TOKEN 环境变量（或用 --token），并安装依赖 pip install requests。示例：python3 skills/meta-ad-scraper/scripts/search_meta_ads.py --company "Nike"；加国家筛选 --country US；限制数量 --max-ads 20；按主页 URL 搜索 --page-url "https://www.facebook.com/nike"；包含非活跃广告 --ad-status all；人类可读摘要 --output summary。脚本会构造 Meta 广告库搜索 URL，通过 REST API 调用 Apify actor，轮询完成后获取数据集并解析输出。
适用场景：竞品广告创意与文案研究、行业关键词广告扫描、多竞品投放与花费区间对比。
限制：EU/UK 广告归档最完整，美国广告覆盖可能仅限政治/议题类；默认只返回活跃广告；费用约每 1000 条广告 5 美元（Apify 免费计划），付费计划更便宜（3.40–5 美元/1K）；大规模抓取需增大 --timeout，速率限制由 Apify 内部处理。更多 API 配置见 references/apify-config.md。