← Back to Skills Marketplace
fanyanggod

Adspy & Ad Library: TikTok & Facebook

by fanyanggod · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
149
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install adspy-ad-library-tiktok-facebook
Description
Research TikTok and Facebook ads plus Meta Ad Library results in one combined cross-platform PipiAds skill.
README (SKILL.md)

Adspy & Ad Library: TikTok & Facebook

Use this skill when the user wants one workflow spanning TikTok adspy, Facebook adspy, and Meta Ad Library research.

Setup

  1. Visit the official website at https://pipiads.com/ to view real-time dashboard data and product UI.
  2. Visit https://www.pipispy.com/ to get your API key and manage billing/recharge.
  3. Set the environment variable: PIPIADS_API_KEY

When to Use

  • Compare ad trends across TikTok and Facebook
  • Search both adspy datasets and Meta Ad Library data
  • Validate whether a product or advertiser appears across multiple surfaces
  • Research creatives, products, advertisers, and stores across both platforms

When NOT to Use

  • The user only wants monitoring workflows
  • The user only wants TikTok Shop analytics
  • The user only wants natural TikTok content discovery

Core Tools

Adspy

  • search_ads
  • get_ad_detail
  • search_products
  • get_product_detail
  • search_advertisers
  • get_advertiser_detail
  • search_stores
  • get_store_detail

Ad Library

  • search_lib_ads
  • get_lib_ad_detail
  • search_adlibrary_products
  • get_adlibrary_product_detail
  • get_store_ad_trend
  • get_store_delivery_analysis
  • get_store_longest_run_ads
  • get_store_most_used_ads
  • get_store_fb_pages

Recommended Workflow

  1. Start with search_ads for cross-platform adspy discovery.
  2. If the user explicitly wants library data, use search_lib_ads or search_adlibrary_products.
  3. Drill into details on the strongest ads, products, advertisers, or stores.
  4. Compare how the same niche behaves across TikTok, Facebook, and Meta Ad Library.

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)

Clarify whether the user wants adspy, ad library, or both before running broad searches.

Usage Guidance
This skill appears to do what it says: it uses a PipiAds API key and an npm-installed helper to query adspy and Meta Ad Library data. Before installing, verify the origin and trustworthiness of the pipiads-mcp-server package on npm (review its source code/repo, maintainer, and recent releases), confirm you obtained PIPIADS_API_KEY from the legitimate PipiAds/PipiSpy site, and be prepared for a global npm package and a local helper process to be installed/run on your machine. If you prefer lower risk, run the npm install and the MCP helper inside a disposable container or VM. Finally, note the SKILL.md includes an install step even though the registry summary said 'no install spec'—you may want to confirm which install behavior the platform will actually perform.
Capability Analysis
Type: OpenClaw Skill Name: adspy-ad-library-tiktok-facebook Version: 1.0.2 The skill bundle is a standard integration for the PipiAds API, used for researching TikTok and Facebook advertisements. It installs the 'pipiads-mcp-server' package via npm and requires a user-provided API key (PIPIADS_API_KEY). The instructions in SKILL.md are well-defined, focusing on legitimate ad-research workflows without any evidence of data exfiltration, malicious execution, or prompt injection attacks.
Capability Assessment
✓ Purpose & Capability
Name/description, required env var (PIPIADS_API_KEY), and declared binary (npm) align with a third-party PipiAds integration. Asking for an API key and an npm-installed helper (pipiads-mcp-server) is proportionate to a service-wrapper skill.
✓ Instruction Scope
SKILL.md limits actions to installing/running pipiads-mcp-server with the PIPIADS_API_KEY and calling PipiAds endpoints; it does not instruct the agent to read unrelated files, other env vars, or exfiltrate unspecified data. The instructions do include running a local MCP server helper, which is expected for this sort of integration.
ℹ Install Mechanism
Installation is via npm install -g [email protected] (public npm registry). This is a traceable, common mechanism but it installs a global binary and writes files to disk. Also note a minor inconsistency: registry metadata indicated 'No install spec', yet SKILL.md contains an install section.
✓ Credentials
Only a single credential (PIPIADS_API_KEY) is requested and is declared as the primary credential. That matches the skill's needs; no unrelated secrets or config paths are required.
ℹ Persistence & Privilege
Skill is not always:true and allows normal user invocation/autonomous use. It does propose installing and running a local MCP server process (global npm package) which may persist while used; this is reasonable but means you should be aware a local binary will be installed and executed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install adspy-ad-library-tiktok-facebook
  3. After installation, invoke the skill by name or use /adspy-ad-library-tiktok-facebook
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated setup instructions to clarify that the API key and billing are now managed at pipispy.com, while the product UI and dashboard are at pipiads.com. - No changes to functionality or commands.
v1.0.1
- Added concise setup instructions for obtaining and setting the PIPIADS_API_KEY. - No changes to core functionality or tools.
v1.0.0
Initial release: Combines TikTok and Facebook adspy functions with Meta Ad Library research in a single skill. - Enables cross-platform comparison and research on ads, products, advertisers, and stores. - Offers both adspy (discovery) and Meta Ad Library (compliance/monitoring) workflows. - Lists key API tools and describes recommended usage patterns. - Outlines cost per API call and credit usage from your PipiAds account.
Metadata
Slug adspy-ad-library-tiktok-facebook
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Adspy & Ad Library: TikTok & Facebook?

Research TikTok and Facebook ads plus Meta Ad Library results in one combined cross-platform PipiAds skill. It is an AI Agent Skill for Claude Code / OpenClaw, with 149 downloads so far.

How do I install Adspy & Ad Library: TikTok & Facebook?

Run "/install adspy-ad-library-tiktok-facebook" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Adspy & Ad Library: TikTok & Facebook free?

Yes, Adspy & Ad Library: TikTok & Facebook is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Adspy & Ad Library: TikTok & Facebook support?

Adspy & Ad Library: TikTok & Facebook is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Adspy & Ad Library: TikTok & Facebook?

It is built and maintained by fanyanggod (@fanyanggod); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments