← 返回 Skills 市场

Facebook Adspy & Facebook Ad Library

Name: Facebook Adspy & Facebook Ad Library
Author: fanyanggod

作者 fanyanggod · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

167

总下载

当前安装

版本数

在 OpenClaw 中安装

/install facebook-adspy-facebook-ad-library

功能描述

Research Facebook ad creatives and Meta Ad Library results using PipiAds adspy and ad library tools.

使用说明 (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 Facebook
get_ad_detail — Inspect a specific ad
search_products — Find products heavily advertised on Facebook
get_product_detail — Product detail
search_advertisers — Find advertisers
get_advertiser_detail — Advertiser detail

Facebook / Meta Ad Library

search_lib_ads — Search Meta Ad Library ads
get_lib_ad_detail — Get ad library ad detail
search_adlibrary_products — Search Meta Ad Library products
get_adlibrary_product_detail — Get product detail from ad library
get_store_ad_trend — Store ad trend analysis from Meta Ad Library
get_store_delivery_analysis — Delivery analysis
get_store_longest_run_ads — Longest-running ads
get_store_most_used_ads — Most-used ads
get_store_fb_pages — Facebook advertiser pages

Recommended Workflow

Start with search_ads or search_lib_ads depending 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.

安全使用建议

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install facebook-adspy-facebook-ad-library
安装完成后，直接呼叫该 Skill 的名称或使用 /facebook-adspy-facebook-ad-library 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug facebook-adspy-facebook-ad-library

版本 1.0.2

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 3

常见问题