# Facebook Ad Library Skill — Installed 2026-05-06

**Location:** `/usr/lib/node_modules/openclaw/skills/facebook-ad-library/`
**Version:** v1.0.1
**Author:** @fanyanggod
**License:** MIT-0

## What It Does

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

## Prerequisites

- Set environment variable: `export PPSPY_API_KEY="your-key"`
- Get API key at: https://api.ppspy.com

## Tools Available (13 total)

### Ads (2 tools)
- `ppspy_advertisement_list` — Search ads with filters
- `ppspy_advertisement_details` — Get ad details (FREE)

### Stores (8 tools)
- `ppspy_ad_store_list` — Search stores
- `ppspy_ad_store_details` — Store details (FREE)
- `ppspy_ad_store_landing_page_stats` — Landing page stats (FREE)
- `ppspy_ad_store_advertising_trends` — Ad trends (FREE)
- `ppspy_ad_store_placement_analysis` — Placement analysis (FREE)
- `ppspy_ad_store_content_most_used` — Top ad copy (FREE)
- `ppspy_ad_store_content_longest_run` — Longest running ads (FREE)
- `ppspy_ad_store_advertiser_list` — Advertisers for store (FREE)

### Products (2 tools)
- `ppspy_ad_product_list` — Search products
- `ppspy_ad_product_details` — Product details (FREE)

### Supplement (1 tool)
- `ppspy_ad_filter_options` — Get filter options (FREE)

## Scripts

| Script | Purpose |
|--------|---------|
| `search-ads.sh` | Search ads by keyword, reach, spend, status |
| `search-stores.sh` | Search stores by category, ad count |
| `search-products.sh` | Search products by reach, category |
| `analyze-store.sh` | Full store analysis (all endpoints) |
| `filter-options.sh` | List available filter values |
| `store-details.sh` | Get specific store details |
| `product-details.sh` | Get specific product details |

## Credit Costs

- Search APIs: 2 credits per record
- Detail/Analysis/Supplement: FREE

## Quick Examples

```bash
# Search pet ads running 30+ days
search-ads.sh --keyword "pet" --days-running 30

# Find beauty stores
search-stores.sh --category "beauty" --limit 50

# Analyze a store
analyze-store.sh --store-id store_789
```

---
*Saved to workspace memory for Obsidian/OMI sync when available.*