用途:该技能用于在 Meta Ads Library(Facebook 广告库)中按关键词或广告主文本查找广告,底层调用 Chrome 扩展支持的 Frevana MCP 工具 frevana_meta_ads_search。
主要能力与输入:keyword(必填,关键词/广告主/品牌文本);country(可选,ALL 或 ISO 3166-1 alpha-2 国家代码如 US、CN、GB,默认 ALL);active_status(可选,active、inactive 或 all,默认 active);date_from、date_to(可选,YYYY-MM-DD 含首尾);maxResults(可选,默认 20,最大 500);timeout(可选,毫秒)。输出为包含结构化 Meta 广告记录的 Frevana JSON 文本,除非用户要求原始输出,否则应汇总结果。
使用方式:需用户提供 keyword;依赖捆绑的 scripts/setup.sh 包装脚本(下载并运行最新官方 Frevana 安装脚本)、安装后运行的 Frevana 本地守护进程(默认端口 12306)、通过 Frevana Chrome 扩展连接的 Chrome、可访问 Meta Ads Library 的 Chrome 会话,以及 curl、bash、python3。执行顺序:确认关键词,优先使用脚本而非临时 frevana 命令,默认 country=ALL、active_status=active、maxResults=20,不臆造日期或超时值;每次调用前先运行 setup.sh;若提示 Chrome 未连接则停止并让用户打开 Chrome、连接扩展后重试;仅在 setup 成功后执行搜索;若结果像登录/鉴权内容或广告库不可用,提示用户需可用 Chrome 会话并重试;可保存输出到文件。
命令示例:bash <skill-path>/scripts/search_meta_ads.sh --keyword "nike";可加 --country US --active-status active;可加 --date-from 2026-01-01 --date-to 2026-06-22 --max-results 50;可加 --output ./out/meta-ads-search-result.json。--query、--q、--text 为 --keyword 别名,--active_status、--date_from、--date_to、--maxResults 为对应别名。脚本调用固定形式为 frevana call frevana_meta_ads_search '<json_args>',JSON 参数始终包含默认 country、active_status 与 maxResults,未提供的可选字段省略;不要传入不支持的字段。
限制:需本地守护进程与 Chrome 扩展会话,Meta Ads Library 需在会话中可访问;--max-results 须为 1 至 500 的整数,--timeout 须为正整数;日期须为 YYYY-MM-DD。其他收费、平台细节暂未提供。