广告库抓取器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install ad-library-scraper
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 ad-library-scraper。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

广告库抓取器连接到 ToolRouter 的 MCP server，使 AI agent 能够通过一个工作流搜索 Meta、Google、LinkedIn、TikTok 和 Reddit 的公开广告库。它会返回广告文案、创意 URL、开始日期、平台，以及在来源广告库提供这些数据时的触达量和花费等信息。
该技能专为实用的竞争研究而构建，可帮助营销人员和开发者识别广告主、检查活跃广告系列、查看可用的视频文字稿，并比较钩子、格式、优惠和行动号召。作为 Openclaw Skills 的一部分，它提供了一种结构化方式，将公开广告数据转化为研究摘要，而无需猜测不可用的指标。

应用场景

竞争对手广告拆解：
在选定国家/地区比较多个竞争对手的活跃广告，重点关注钩子、优惠、格式和开始日期。
创意研究：
查看长期运行的广告并获取视频文字稿，以识别反复出现的信息、证明要点和行动号召。
渠道组合分析：
在 Meta、Google、LinkedIn 和 TikTok 上搜索某个品牌，了解哪些平台存在与其相关的广告。
基于关键词的广告发现：
查找包含特定短语的广告，同时区分广泛的关键词匹配和属于特定广告主的广告。
落地页后续分析：
将广告的落地 URL 发送给
web-scraper/scrape_page
技能，以检查创意背后的优惠。
付费与自然内容比较：
将结果与
social-media-scraper
技能结合，比较广告与品牌的自然帖子。

工作原理

将 agent 连接到 ToolRouter 的远程 MCP server：https://api.toolrouter.com/mcp。
在请求公司专属结果前解析广告主：使用 search_facebook_ad_companies 查找 Meta page_id，或使用 search_google_advertisers 查找 Google advertiser_id。
使用平台对应的操作获取相关广告，并指定适用的国家/地区和状态。对于 Meta，get_facebook_company_ads 支持 status 和 trim 等选项。
在需要更多详细信息时打开单个创意。例如，get_facebook_ad 可以请求视频文字稿，而 get_google_ad 可以获取单个 Google 创意。
明确说明研究时间窗口并总结结果。比较开始日期、运行时长、平台、格式、钩子和行动号召。
仅在广告库返回触达量或花费时报告这些数据；不要推断或估算缺失的指标。

配置指南

安装技能：
pnpm dlx skills add Humanleap/agent-skills --skill ad-library-scraper
将客户端连接到 ToolRouter 的远程 MCP server：https://api.toolrouter.com/mcp。在 Claude 中，使用 Customize → Connectors → Add custom connector。对于 Claude Code，运行：
claude mcp add toolrouter -- npx -y toolrouter-mcp
遵循 ToolRouter 的快速入门指南完成客户端配置：https://toolrouter.com/docs/markdown/quickstart。
通过 use_tool 调用操作，使用 tool: "ad-library-search"、准确的 skill 操作名称及其文档规定的 input。使用 discover 检查实时价格和可用操作。
server 会在首次使用时配置一个匿名账户。如果付费调用返回 claim link，请将其分享给用户，以便用户登录并添加额度。大多数广告库调用的费用为 $0.005；带有 get_ad_details: true 的 get_google_company_ads 每条广告费用更高，因此除非需要完整详细信息，否则应关闭该选项。

数据架构

该技能通过 ToolRouter 的 MCP 操作查询公开广告库。它不规定本地数据库或生成文件格式；结果由所选操作返回。
数据或元数据 使用方式
广告主标识符 使用 page_id 解析 Meta 页面，或使用 advertiser_id 解析 Google 广告主；Google 搜索也可以使用域名。
搜索范围 指定国家/地区，并针对平台使用相应的查询、公司或广告主名称字段。
广告状态和分页 Meta 公司广告请求可以使用 status，例如 ACTIVE 或 ALL；使用 trim 减小响应大小，并使用 cursor 翻页浏览结果。
创意详情 根据操作和广告库的不同，结果可能包括广告文案、创意 URL、格式、落地 URL，以及视频文字稿或 OCR 文本。
时间和平台 开始日期和平台信息有助于比较广告系列时长和渠道存在情况。
触达量和花费 仅在来源广告库返回这些数据时纳入；可用性会有所不同。
研究摘要 有用的比较应按开始日期、运行天数、平台、格式、开场钩子和行动号召组织结果。

高级特性

跨平台研究：
通过一个 MCP 连接，使用各平台文档规定的操作搜索 Meta、Google、LinkedIn、TikTok 和 Reddit。
广告主解析：
在获取公司专属广告前确定正确的公司页面或广告主，减少无关的关键词匹配。
视频文字稿获取：
get_facebook_ad
并设置
get_transcript: true
，请求单个 Meta 视频广告的文字稿。
Google 创意检查：
get_google_ad
获取单个 Google 广告；公司级请求可以选择以更高费用包含更完整的广告详情。
高效结果处理：
使用 Meta 的
trim
选项缩小响应，并使用
cursor
分页；需要历史广告时使用
status: "ALL"
。
可组合的研究工作流：
将广告结果与
web-scraper/scrape_page
结合进行落地页分析，或与
social-media-scraper
结合进行付费与自然内容比较。
成本感知操作：
discover
检查实时价格，在需要之前避免可选的 Google 详细信息获取，并使用返回的 claim link 启用付费调用。

name: ad-library-scraper description: Search public ad libraries through ToolRouter's MCP server - Meta (Facebook and Instagram) Ad Library, Google Ads Transparency Center, LinkedIn, TikTok and Reddit ads. Use when the user wants to see a competitor's running ads, ad copy and creative, how long ads have run, which platforms they run on, or video ad transcripts.