用途：从 Meta 广告库抓取竞品广告，覆盖 Facebook、Instagram、Messenger、Threads、WhatsApp。可按公司名、关键词或 Facebook 主页 URL 搜索，用于竞品广告研究、行业广告格局分析和多竞品对比。
主要能力：脚本接收公司名、关键词或主页 URL，构造 Meta 广告库搜索链接，通过 REST API 调用 Apify 的 apify/facebook-ads-scraper actor，轮询运行完成后获取数据集，解析并输出 JSON 或人类可读摘要。支持国家过滤、广告状态（active/all）、结果数量上限、超时设置。输出字段包括 ad_id、page_name、page_id、ad_text、创意链接标题/描述/URL、图片与视频 URL、投放起止时间、货币、花费区间、展示量区间、平台列表和状态。
使用方式：需设置 APIFY_API_TOKEN 环境变量（或 --token），并安装依赖 pip install requests。示例：python3 skills/meta-ad-scraper/scripts/search_meta_ads.py --company "Nike"；加国家过滤 --country US；按关键词搜索 --company "project management software"；限制数量 --max-ads 20；按主页 URL 搜索 --page-url "https://www.facebook.com/nike"；包含非活跃广告 --ad-status all；输出摘要 --output summary。--company 与 --page-url 至少提供一个。
适用场景：竞品广告创意与文案研究、行业广告投放概览、多竞品投放策略与花费区间对比。
限制：依赖 Apify 付费 actor，资料称免费计划约每 1000 条广告 5 美元，付费计划更便宜（3.40–5 美元/1K）。EU/UK 广告归档最完整，美国广告覆盖可能仅限政治/议题类。默认仅返回活跃广告。大规模抓取需增大 --timeout。详细 API 配置见 references/apify-config.md。