SuperAPI AI 工具集

google-ads-transparency-center

营销与增长

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于检索 Google Ads Transparency Center 的广告素材结果,通过 Frevana 接口完成查询。

主要能力:支持按 advertiser_id、text(域名或自由文本)或 next_page_token 发起搜索;可选 platform 与 region 筛选;返回校验后的 JSON,并在每次成功运行时把同一份 JSON 保存到本地文件。

使用方式:需提供 advertiser_id、text 或 next_page_token 中至少一项,并设置环境变量 FREVANA_TOKEN(或本次运行用 --token 覆盖)。依赖 curl、bash、python3。脚本优先读取 FREVANA_TOKEN;交互式 shell 下缺失可能提示输入,非交互或智能体流程中缺失则快速失败。示例:bash <skill-path>/scripts/search_google_ads_transparency_center.sh --text "apple.com";--q、--query 为 --text 别名,--advertiser_id 为 --advertiser-id 别名,--next_page_token 为 --next-page-token 别名。可用 --platform YOUTUBE --region 2840 加筛选,用 --output 指定保存路径。

输出:成功时校验响应体为 JSON,写入文件(默认 ./out/google-ads-transparency-center-<UTC 时间戳>-<pid>.json),把路径打印到 stderr,JSON 打印到 stdout;失败时打印响应体或解析错误并以非零退出。响应常见字段有 search_metadata、search_parameters、search_information.total_results、ad_creatives、pagination.next_page_token;ad_creatives[] 项可能含 advertiser_id、advertiser、ad_creative_id、format、target_domain、image、link、width、height、first_shown、last_shown、details_link。

限制:platform 有效值为 PLAY、MAPS、SEARCH、SHOPPING、YOUTUBE;不要传入 engine、api_key、output、no_cache、async、zero_trace、political_ads、start_date、end_date、creative_format、num 等不支持的字段;不要猜测 advertiser ID、地区码、平台或分页令牌;不要回显 Bearer token。缺少 curl 或 python3 时应停止并提示安装。后续解析或摘要建议使用已保存的 JSON 文件,避免重复调用接口。