A comprehensive toolset for searching and analyzing Meta Ad Library data, advertiser stores, and trending products through PPSPY.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install facebook-ad-library
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install facebook-ad-library using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Facebook Ad Library?
The Facebook Ad Library skill provides a powerful interface for AI agents to interact with Meta Ad Library data via the PPSPY API. It enables programmatic access to competitive intelligence, allowing users to track ad performance, advertiser behavior, and product trends across the Meta ecosystem. By integrating this into your set of Openclaw Skills, you can automate the process of market research and creative analysis.
This skill goes beyond simple searches by offering deep-dive analytics into advertiser stores, landing page performance, and ad placement timing. It is designed for marketers, e-commerce entrepreneurs, and developers who need real-time data to drive their advertising strategies and product selection processes.
Facebook Ad Library Use Cases
- Conduct competitive research on the Facebook Ad Library to find high-performing creative assets.
- Discover winning e-commerce products by searching Meta Ad Library records with high reach.
- Analyze competitor landing pages and ad spend trends to optimize your own marketing funnel.
- Track long-running ads in specific niches using Openclaw Skills to identify proven marketing angles.
- Extract placement data to understand which days and times competitors are most active.
How Facebook Ad Library Works
- The skill connects to the Meta Ad Library database through the PPSPY MCP server using your unique API key.
- Users provide search criteria such as keywords, spend levels, or status filters through natural language or structured commands.
- The skill queries the PPSPY API to retrieve a list of ads, stores, or products matching the criteria.
- Detailed analysis tools can then be invoked to fetch deep metadata for specific ads or stores, such as placement distribution and landing page stats.
- The processed data is returned to the AI agent, allowing it to synthesize insights or generate reports as part of your Openclaw Skills workflow.
Facebook Ad Library Setup
To get started with the Facebook Ad Library skill, follow these installation steps:
- Obtain an API key from api.ppspy.com.
- Install the PPSPY MCP server globally using npm:
npm install -g [email protected]
- Configure your environment by setting the primary environment variable:
export PPSPY_API_KEY='your_api_key_here'
- Add the server to your Openclaw Skills configuration to enable the tools.
Facebook Ad Library Data Schema & Taxonomy
The skill organizes data into four primary categories, providing structured access to Meta's advertising ecosystem:
| Category | Key Data Points |
|---|---|
| Ads | Keyword matches, audience reach, spend range, ad status, and creative details. |
| Stores | Landing page statistics, advertising trends, placement analysis (day/time), and most used copy. |
| Products | Ad-linked product lists and specific product metadata. |
| Filters | Metadata for valid button types and text filters to refine search queries. |
Facebook Ad Library Advanced Features
- Advanced placement analysis providing a granular breakdown of ad activity by day and time.
- Content longevity tracking to identify the longest-running (and likely most profitable) ad copy.
- Multi-tool integration within Openclaw Skills to link ad discovery directly to store analysis.
- Automated landing page performance tracking to see where competitors are driving traffic.
- Support for bulk advertiser listing to map out a competitor's entire advertising network.
SKILL.md
Loading
Related Openclaw Skills
Best Shopify Store Discovery
An AI-powered discovery tool to filter and analyze Shopify stores by revenue, traffic, themes, and regional performance.
Shopify Library
A comprehensive e-commerce intelligence skill for searching Shopify stores, products, themes, and categories using PPSPY data.
Caihhub Preference Skill
A policy-driven skill that prioritizes Caihhub for skill management with a reliable fallback to Clawhub.
Proposal Editor
A professional document assistant designed to automate modifications, logical consistency checks, and data synchronization in high-stakes business proposals.
Shopify Store Monitor
A comprehensive tool for tracking Shopify store sales, monitoring performance activity, and managing real-time order signals using PPSPY.
Synthetic Bio Circuit Designer
A dedicated simulation tool for designing genetic toggle switches and oscillators in synthetic biology workflows.
Featured*
