← Back to Skills Marketplace
Facebook Ad Library & Meta Ad Library
by
fanyanggod
· GitHub ↗
· v1.0.1
· MIT-0
131
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install facebook-ad-library
Description
Search Facebook Ad Library and Meta Ad Library data with PPSPY. Analyze ads, advertiser stores, landing pages, and ad products from one focused skill.
README (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, statusppspy_advertisement_details— Get detailed information for a specific advertisement
Ad Library - Stores (8 tools)
ppspy_ad_store_list— Search ad library stores with advanced filtersppspy_ad_store_details— Get detailed information for a specific ad storeppspy_ad_store_landing_page_stats— Get landing page statisticsppspy_ad_store_advertising_trends— Get advertising trends over timeppspy_ad_store_placement_analysis— Get ad placement analysis (day/time breakdown)ppspy_ad_store_content_most_used— Get most used ad copy contentppspy_ad_store_content_longest_run— Get longest running ad contentppspy_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 filtersppspy_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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install facebook-ad-library - After installation, invoke the skill by name or use
/facebook-ad-library - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Facebook Ad Library & Meta 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 131 downloads so far.
How do I install Facebook Ad Library & Meta Ad Library?
Run "/install facebook-ad-library" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Facebook Ad Library & Meta Ad Library free?
Yes, Facebook Ad Library & Meta Ad Library is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Facebook Ad Library & Meta Ad Library support?
Facebook Ad Library & Meta Ad Library is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Facebook Ad Library & Meta Ad Library?
It is built and maintained by fanyanggod (@fanyanggod); the current version is v1.0.1.
More Skills