← Back to Skills Marketplace
Meta Ad Spy
by
Abhishekj9621
· GitHub ↗
· v1.0.0
· MIT-0
108
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install meta-ad-spy
Description
Competitive intelligence skill for spying on competitor ads using Meta's Ad Library. Use this skill whenever the user wants to: research competitor Facebook/...
Usage Guidance
This skill appears to do what it says — automate Playwright scraping of Meta's Ad Library and optionally query the Graph API — but it asks you to install system-level Python packages and a headless Chromium binary and uses browser-stealth techniques. Before installing or running it: (1) avoid running pip with --break-system-packages on machines you care about — use a virtualenv or container; (2) run the scraper in a sandbox or isolated environment because it will download browser binaries and interact with external websites; (3) be aware Phase 2 needs a Meta access token if you want spend/impression data — supply that only if you trust the code and environment; (4) consider legal/ToS implications of scraping Meta; and (5) if you don't want to install binaries locally, prefer using vetted APIs (the references mention paid alternatives) or a hosted scraper service.
Capability Analysis
Type: OpenClaw Skill
Name: meta-ad-spy
Version: 1.0.0
The meta-ad-spy skill is a legitimate competitive intelligence tool designed to extract Facebook and Instagram ad data using a two-phase approach: Playwright-based scraping (meta_ad_scraper.py) and the official Meta Graph API (meta_ad_api.py). The skill provides clear setup instructions, uses environment variables for sensitive API tokens, and focuses on public data retrieval for marketing analysis. No evidence of malicious intent, data exfiltration to unauthorized third parties, or intentional vulnerabilities was found in the code or the accompanying documentation.
Capability Assessment
Purpose & Capability
Name/description align with the implementation: Playwright scraping (phase 1) and optional Graph API calls (phase 2) are reasonable for extracting Meta Ad Library data and ad metadata. References to paid alternatives are consistent with the stated goal.
Instruction Scope
SKILL.md focuses on scraping Meta Ad Library and lookup helpers and does not request unrelated system files or secrets. However it instructs creation of a /tmp scraper, uses browser-stealth techniques (overriding navigator.webdriver, disabling AutomationControlled), and includes navigation/clicking logic — which gives the agent broad discretion to interact with third-party websites and could be used to evade detection. The instructions also assume the environment can run headless browsers and install packages.
Install Mechanism
There is no registry install spec, but the runtime instructions tell users to run pip install commands with the --break-system-packages flag and to run 'playwright install chromium'. These commands can modify system Python packages and will download/extract browser binaries, which is higher risk for an instruction-only skill. The install step is disproportionate for a passive analysis skill and could surprise users or require elevated permissions.
Credentials
The registry declares no required environment variables, which is consistent for Phase 1 (no token needed). Phase 2 (Graph API) clearly requires an access token, but the skill does not declare a primaryEnv or required env vars — this is acceptable if optional, but the absence should be made explicit to users (the skill will prompt for tokens if needed). References to third-party paid APIs indicate additional credentials may be needed if the user chooses them.
Persistence & Privilege
Skill is not always-enabled, requests no config paths, and has no install-time hooks declared in the registry. It does instruct writing a temporary scraper file to /tmp at runtime, which is normal for ephemeral scraping but should be run in a sandbox.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install meta-ad-spy - After installation, invoke the skill by name or use
/meta-ad-spy - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Meta Ad Spy skill v1.0.0 — Initial Release
- Launches a competitive intelligence skill for researching competitor ads on Meta platforms (Facebook, Instagram).
- Automatically scrapes Meta Ad Library for ad creatives, copy, status, platforms, and durations using Playwright (no API key needed).
- Optionally connects to the Meta Graph API to extract spend ranges, impressions, and demographic insights (with token).
- Triggers on common ad intelligence and competitor research requests.
- Designed to support ad monitoring, strategy analysis, and building intelligence reports for any brand running Meta ads.
Metadata
Frequently Asked Questions
What is Meta Ad Spy?
Competitive intelligence skill for spying on competitor ads using Meta's Ad Library. Use this skill whenever the user wants to: research competitor Facebook/... It is an AI Agent Skill for Claude Code / OpenClaw, with 108 downloads so far.
How do I install Meta Ad Spy?
Run "/install meta-ad-spy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Meta Ad Spy free?
Yes, Meta Ad Spy is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Meta Ad Spy support?
Meta Ad Spy is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Meta Ad Spy?
It is built and maintained by Abhishekj9621 (@abhishekj9621); the current version is v1.0.0.
More Skills