← 返回 Skills 市场

Facebook Ad Library & Meta Ad Library

Name: Facebook Ad Library & Meta Ad Library
Author: fanyanggod

作者 fanyanggod · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

131

总下载

当前安装

版本数

在 OpenClaw 中安装

/install facebook-ad-library

功能描述

Search Facebook Ad Library and Meta Ad Library data with PPSPY. Analyze ads, advertiser stores, landing pages, and ad products from one focused skill.

使用说明 (SKILL.md)

Facebook Ad Library

Search Facebook Ad Library and Meta Ad Library data across ads, ad-linked stores, and ad products.

Keywords: Facebook Ad Library, Meta Ad Library, FB library, FB library product, FB library store.

Setup

Visit the official website at ppspy.com to view real-time dashboard data and product UI.
Visit the direct API site at api.ppspy.com to get your API key and manage billing/recharge.
Set the environment variable: PPSPY_API_KEY

Available Tools (13 total)

Ad Library - Ads (2 tools)

ppspy_advertisement_list — Search Facebook ads with advanced filters: keyword, audience reach, spend, status
ppspy_advertisement_details — Get detailed information for a specific advertisement

Ad Library - Stores (8 tools)

ppspy_ad_store_list — Search ad library stores with advanced filters
ppspy_ad_store_details — Get detailed information for a specific ad store
ppspy_ad_store_landing_page_stats — Get landing page statistics
ppspy_ad_store_advertising_trends — Get advertising trends over time
ppspy_ad_store_placement_analysis — Get ad placement analysis (day/time breakdown)
ppspy_ad_store_content_most_used — Get most used ad copy content
ppspy_ad_store_content_longest_run — Get longest running ad content
ppspy_ad_store_advertiser_list — Get advertisers associated with a store

Ad Library - Products (2 tools)

ppspy_ad_product_list — Search ad library products with advanced filters
ppspy_ad_product_details — Get detailed information for a specific ad product

Supplement (1 tool)

ppspy_ad_filter_options — Get ad filter options (button types/texts)

Usage Examples

"Search Facebook Ad Library for pet ads running over 30 days"
"Show me Meta Ad Library stores in beauty"
"Find FB library products with high audience reach"
"Get landing page stats for this ad store"
"List the advertisers associated with this store"

Credits

Each API call consumes credits from your PPSPY account:

Ad Library Search (Ads/Stores/Products): 2 credits per record
Detail/Analysis/Supplement APIs: Free

安全使用建议

This skill appears to do what it claims: it calls PPSPY to search Meta/Facebook ad data and asks only for a PPSPY API key. Before installing: (1) verify you trust the ppspy NPM package and the publisher (check the package page, maintainers, and recent versions on the npm registry and ppspy.com), because global npm installs run code during install; (2) prefer installing in an isolated environment (container or VM) if you want to limit risk; (3) ensure the PPSPY_API_KEY has minimal privileges and monitor its usage/credits; (4) note the registry metadata omitted an install spec even though SKILL.md includes one—confirm the intended install step with the skill author or publisher if you need higher assurance.

功能分析

Type: OpenClaw Skill Name: facebook-ad-library Version: 1.0.1 The skill is a legitimate integration for the PPSPY service, allowing users to search the Facebook Ad Library. It installs the 'ppspy-mcp-server' via npm and requires a standard API key (PPSPY_API_KEY). No malicious code, data exfiltration, or prompt injection attempts were detected in SKILL.md or _meta.json.

能力评估

✓ Purpose & Capability

Name/description match the declared requirement (PPSPY API). The SKILL.md asks for PPSPY_API_KEY and to install/run a ppspy MCP server binary (ppspy-mcp-server) via npm, which is coherent with a PPSPY-backed ad-library skill.

✓ Instruction Scope

Runtime instructions are limited to obtaining a PPSPY API key, installing/using the ppspy-mcp-server, and calling PPSPY APIs. There are no instructions to read unrelated files, access other credentials, or exfiltrate data beyond the PPSPY service.

ℹ Install Mechanism

The SKILL.md includes an npm global install: npm install -g [email protected]. Installing an npm package globally is a standard mechanism but runs package install scripts and writes to disk (moderate risk). Also note a minor inconsistency: registry metadata said 'No install spec' while SKILL.md contains an install command.

✓ Credentials

Only PPSPY_API_KEY is required and marked as primaryEnv; this matches the service being accessed. No unrelated environment variables or config paths are requested.

✓ Persistence & Privilege

Skill is not always-enabled and does not request elevated platform privileges. It will install and run a local MCP server process (its own binary) but does not attempt to modify other skills or system-wide agent settings.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install facebook-ad-library
安装完成后，直接呼叫该 Skill 的名称或使用 /facebook-ad-library 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Updated setup instructions to clarify where to view dashboard data and obtain an API key. - Added links to the official product UI and direct API site for clearer onboarding. - No changes to code or functionality.

v1.0.0

Initial release of the Facebook Ad Library skill. - Search and analyze Facebook/Meta Ad Library data via PPSPY integration. - Tools provided for detailed queries on ads, ad-linked stores, landing pages, and products (13 tools total). - Includes advanced filters, analytic reports, and advertiser/store/product insights. - Simple setup with one required API key environment variable. - Credits system: Searches use PPSPY credits; detailed queries are free.

元数据

Slug facebook-ad-library

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题