海外广告库查询 okdata

--- name: okdata-ad-library description: 海外广告库查询：用 okdata 接口读Meta 广告库、Google 广告透明中心的公开数据，包括Meta 广告库搜索、Meta 广告详情、Meta 广告主的广告、Google 广告透明中心广告主搜索、Google 广告主的广告等，不用登录、不用 Cookie，按次付费、失败不收费。适用于看竞品在 Facebook、Instagram 上在投什么广告、查一个广告主在 Google 搜索、YouTube 上的广告、按关键词找在投广告，做投放素材调研。 Meta Ad Library and Google Ads Transparency Center public data for AI agents through the okdata API (remote MCP or HTTP), paid per call. license: MIT metadata: openclaw: primaryEnv: OKDATA_API_KEY requires: env: - OKDATA_API_KEY homepage: https://okdata.online/zh/apis/meta/ --- <!-- Generated by scripts/platform-skills.mjs from the okdata catalog. Do not edit by hand. --> # 海外广告库查询（okdata） 用 okdata 的接口读Meta 广告库、Google 广告透明中心的公开数据：Facebook 和 Instagram 上在投的广告，按关键词或广告主查、广告主和他们在搜索、YouTube、展示广告上的广告。 不用登录Meta 广告库、Google 广告透明中心，也不用 Cookie，按次付费，调用失败不收费。 ## 什么时候用 - 看竞品在 Facebook、Instagram 上在投什么广告 - 查一个广告主在 Google 搜索、YouTube 上的广告 - 按关键词找在投广告，做投放素材调研 ## 能拿到的数据 目录版本 2128c2e84655fc1f，价目表 1b273c48fea9634e。价格单位是美元，调用失败不收费。 | 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 | |---|---|---|---|---| | `meta.ads.search` | Meta 广告库搜索：按关键词搜 Meta 广告库（Facebook、Instagram、Messenger）：广告主、文案、标题、图片和视频、落地页、投放位置和开始时间。可限定国家、图片或视频广告，以及在投或已停投。 | `query` | 一页约 30 条 | 每次 $0.004 | | `meta.ads.get` | Meta 广告详情：按广告库 ID 或链接取 Meta 广告库的一条广告：广告主、文案、图片和视频、落地页、投放平台、首次和最近投放日期，以及是否仍在投放。 | `id` 或 `url` | 一条 | 每次 $0.004 | | `meta.advertisers.ads.list` | Meta 广告主的广告：按 Facebook 主页 ID 或品牌名取某个广告主在 Meta 广告库里的广告：文案、素材、落地页、投放平台和日期。看竞品正在投什么，用这个。 | 不用传 | 一页约 30 条 | 每次 $0.004 | | `google.advertisers.search` | Google 广告透明中心广告主搜索：按名称在 Google 广告透明中心找广告主：广告主 ID、Google 验证过的名称、注册国家和广告数量估计。验证名称常是公司主体名，不一定是品牌名。 | `query` | 一页约 10 条 | 每次 $0.004 | | `google.advertisers.ads.list` | Google 广告主的广告：按广告主 ID 或品牌官网域名取 Google 广告透明中心里的广告（搜索、YouTube、展示、购物、地图、Play）：格式、预览图、首次和最近展示时间。每页 40 条。 | 不用传 | 一页约 40 条 | 每次 $0.004 | ## 怎么调用 **用 MCP（已接上 `okdata` MCP 服务时优先用）**：先用 `describe` 看一个接口的参数、返回字段和价格（免费），再用 `call` 调用， `capability` 填接口 id，参数跟在旁边，例如 `{"capability": "meta.ads.search", "query": "portable espresso", "max_price": "0.05", "idempotency_key": "<uuid>"}`。 `find` 能用中文或英文描述找接口，`read_more` 取长结果的剩余部分，这两个也免费。 还没接上的话，远程 MCP 地址是 `https://api.okdata.online/mcp`，认证头是 `Authorization: Bearer <key>`，详见 `okdata-setup` 技能。 **用 HTTP（没有 MCP 时）**：路径是接口 id 把点换成斜杠、放在 `/v1` 下面，参数放在查询串里，key 从环境变量读，不要贴进对话： ```bash curl -sG "https://api.okdata.online/v1/meta/ads/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ --data-urlencode 'query=portable espresso' ``` 每个返回都带 `code`。`"ok"` 时数据在 `data.items`（列表，翻页看 `page.next_cursor`）或 `data.item` 里， `meta.billing.amount` 是这次花了多少钱。其他 `code` 都是出错，会说明 `charged` 和 `retry`：`not_found` 不要重试， `rate_limited` 等 `retry_after_seconds` 再试，`timeout` 用同一个 `Idempotency-Key` 重发，不会重复扣费。 ## 用法建议 1. 先用搜索类接口找到内容或账号，再查详情、评论或作品列表。搜索类接口拿到的结果里带着后续接口要用的 id。 2. 列表接口一次返回一页。要更多就带上 `page.next_cursor` 再调一次，在 MCP 里也可以用 `read_more`。 3. 调用前先算一下要调几次、大概多少钱，告诉用户再动手。给 `call` 设 `max_price`：这次可能花得比它多时，调用会被拒绝，不扣钱。 4. 只读公开数据：不发帖、不点赞、不评论、不私信。 5. 还没有 key：到 https://okdata.online/zh/signup/?src=skill-okdata-ad-library 注册，在控制台创建 key，设成环境变量 `OKDATA_API_KEY`。不要让用户把 key 贴进对话。 ## 相关技能 - `okdata-setup`：接入 MCP、保存 key、查价格和余额、排查报错 - `okdata-comments`：跨平台读评论，做口碑分析 - `okdata-competitors`：竞品账号监控和对比 - `okdata-creators`：按领域找达人、筛博主 - `okdata-trends`：各平台热搜热榜 - `okdata-content-research`：爆款内容调研 接口说明和价格：https://okdata.online/zh/apis/meta/

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本