← Back to Skills Marketplace
Facebook Adspy & Facebook Ad Library
by
fanyanggod
· GitHub ↗
· v1.0.2
· MIT-0
167
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install facebook-adspy-facebook-ad-library
Description
Research Facebook ad creatives and Meta Ad Library results using PipiAds adspy and ad library tools.
README (SKILL.md)
Facebook Adspy & Facebook Ad Library
Use this skill for Facebook-focused ad research across adspy and Meta Ad Library datasets.
Setup
- Visit the official website at https://pipiads.com/ to view real-time dashboard data and product UI.
- Visit https://www.pipispy.com/ to get your API key and manage billing/recharge.
- Set the environment variable:
PIPIADS_API_KEY
When to Use
- Find Facebook ads by keyword, advertiser pattern, region, or engagement
- Search Meta Ad Library ads and products
- Compare Facebook creatives, offers, landing pages, and advertiser behavior
- Inspect specific ads or ad library records in detail
When NOT to Use
- The user wants monitoring workflows rather than one-off research
- The user wants TikTok-only ads or TikTok Shop analytics
- The user wants natural TikTok content research
Core Tools
Facebook Adspy
search_ads— Search ads and narrow to Facebookget_ad_detail— Inspect a specific adsearch_products— Find products heavily advertised on Facebookget_product_detail— Product detailsearch_advertisers— Find advertisersget_advertiser_detail— Advertiser detail
Facebook / Meta Ad Library
search_lib_ads— Search Meta Ad Library adsget_lib_ad_detail— Get ad library ad detailsearch_adlibrary_products— Search Meta Ad Library productsget_adlibrary_product_detail— Get product detail from ad libraryget_store_ad_trend— Store ad trend analysis from Meta Ad Libraryget_store_delivery_analysis— Delivery analysisget_store_longest_run_ads— Longest-running adsget_store_most_used_ads— Most-used adsget_store_fb_pages— Facebook advertiser pages
Recommended Workflow
- Start with
search_adsorsearch_lib_adsdepending on whether the user wants adspy or ad library data. - Narrow by region, active days, keyword, and advertiser.
- Use detail tools on the best candidates.
- If store-level Facebook patterns matter, use the Meta-oriented store analysis tools.
Cost Awareness
Each API call consumes credits from your PipiAds account:
- List/Search: 1 credit per result returned
- Detail: 1 credit per request (free if queried within 3 days)
Prefer a clearly specified platform and region before broad Facebook searches.
Usage Guidance
This skill appears coherent: it uses an API key (PIPIADS_API_KEY) and an npm CLI (pipiads-mcp-server) to query PipiAds for Facebook ad research. Before installing/using it, consider the following: (1) installing the package globally will place third‑party code on your system — review the package source (npm package repo) or run it inside a sandbox/container; (2) the MCP server will make network calls to PipiAds and will consume credits from your PipiAds account — monitor usage and billing; (3) only provide a PipiAds API key with the least privileges possible, rotate keys if compromised, and avoid reusing that key elsewhere; (4) if you need stronger assurance, request the skill author/publisher info or inspect the pipiads-mcp-server package contents and its network behavior before granting the API key. Overall the skill is internally consistent with its stated purpose, but installing third‑party packages and running local servers carries operational risk you should mitigate.
Capability Assessment
Purpose & Capability
Name/description (Facebook ad research) matches the declared requirement (PIPIADS_API_KEY) and the SKILL.md which invokes the PipiAds MCP server CLI. Requesting npm and a PipiAds API key is proportionate to the stated functionality.
Instruction Scope
SKILL.md instructs the agent to set PIPIADS_API_KEY, install and run the pipiads-mcp-server, and use its adspy/ad library endpoints. The instructions do not ask the agent to read unrelated files or other environment variables, but they do instruct globally installing and running a third‑party server binary (pipiads-mcp-server) that will perform network calls to the PipiAds service.
Install Mechanism
Installation is via npm install -g [email protected] (a public npm package). npm installs and executing that package are expected for this skill but carry the normal risk of running third‑party code and creating a global binary. No direct downloads from unknown URLs are used.
Credentials
Only PIPIADS_API_KEY is required and declared as the primary credential. That single API key is consistent with accessing the PipiAds service; no unrelated secrets or config paths are requested.
Persistence & Privilege
The skill is not force-enabled (always: false) and does not request system-wide config changes. It will install and run a CLI server when used but does not claim to modify other skills or global agent configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install facebook-adspy-facebook-ad-library - After installation, invoke the skill by name or use
/facebook-adspy-facebook-ad-library - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated setup instructions to clarify where to view dashboard data and where to obtain/manage API keys and billing.
- Added links to both official product UI (pipiads.com) and account management (pipispy.com) in the setup section.
- No functional or code changes; documentation only.
v1.0.1
- Added a Setup section with instructions on obtaining and setting the API key.
- No changes to core functionality or tools.
- Documentation now includes an explicit onboarding step for new users.
v1.0.0
Initial release providing Facebook ad research capabilities via PipiAds.
- Research Facebook ad creatives and Meta Ad Library results with PipiAds adspy and library tools.
- Supports searching by keyword, advertiser, region, engagement, and more.
- Includes tools for deep dives into specific ads, products, advertisers, and store-level analysis.
- Requires a PIPIADS_API_KEY and npm for setup.
- Each API call consumes PipiAds credits; see Cost Awareness for details.
Metadata
Frequently Asked Questions
What is Facebook Adspy & Facebook Ad Library?
Research Facebook ad creatives and Meta Ad Library results using PipiAds adspy and ad library tools. It is an AI Agent Skill for Claude Code / OpenClaw, with 167 downloads so far.
How do I install Facebook Adspy & Facebook Ad Library?
Run "/install facebook-adspy-facebook-ad-library" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Facebook Adspy & Facebook Ad Library free?
Yes, Facebook Adspy & Facebook Ad Library is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Facebook Adspy & Facebook Ad Library support?
Facebook Adspy & Facebook Ad Library is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Facebook Adspy & Facebook Ad Library?
It is built and maintained by fanyanggod (@fanyanggod); the current version is v1.0.2.
More Skills