PipiAds - TikTok & Facebook Adspy Intelligence

PipiAds - TikTok & Facebook Adspy Intelligence

AI-powered TikTok & Facebook Adspy and Ad Library research for ads, products, stores, landing pages, advertisers, and competitors.

When to Use

Use this skill when the user wants to:

When NOT to Use

Do not use this skill when:

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

Installation Note

This skill installs and runs the published npm package pipiads-mcp-server@1.0.3 as a local MCP server.

Default install:

npm install -g pipiads-mcp-server@1.0.3

If you prefer stricter isolation, use this skill in a dedicated development environment, container, or non-critical workstation.

Trust & Execution Model

This skill installs pipiads-mcp-server@1.0.3 from the npm registry and runs it locally as an MCP server.

This means:

If you require stricter controls, review the npm package contents and run it in an isolated environment before using it on a primary workstation.

Verification

This skill depends on:

Review the package source, publisher, and release history if you need stronger supply-chain assurance before installation.

Data Handling

This skill sends search queries and optional image inputs to the external PipiAds service through the PipiAds API.

Do not send:

Use image search only when the provided image is safe to transmit to a third-party service.

Cost Awareness

Each API call consumes credits from your PipiAds account:

Prefer narrow queries before broad searches. If the user request is underspecified, clarify platform, region, time range, category, or target object before searching.

Core Workflow

1. Identify the target object: ad, product, TikTok Shop product, store, advertiser, app, or monitor task 2. Clarify the platform and scope when missing: TikTok, Facebook, Meta Ad Library, region, time range, category, price band, or performance threshold 3. Start with the relevant search/list tool to narrow the candidate set 4. Use detail or analysis tools to inspect the most relevant candidates 5. If the user wants ongoing tracking, use the monitor tools 6. If the user provides an image, use the AI image search workflow

Quick Reference

| User intent | Recommended tools | | --- | --- | | Find trending ads | search_ads, get_ad_detail | | Find products being heavily advertised | search_products, get_product_detail | | Explore Meta Ad Library products | search_adlibrary_products, get_adlibrary_product_detail | | Research TikTok Shop products or stores | search_tiktok_products, get_tiktok_product_detail, search_tiktok_shops, get_tiktok_shop_detail | | Research advertisers, stores, or landing-page patterns | search_advertisers, get_advertiser_detail, search_stores, get_store_detail | | Analyze store competition, creative hooks, or campaign patterns | Store Analysis tools | | Search Meta Ad Library ads | search_lib_ads, get_lib_ad_detail | | Check rankings for products, apps, or developers | Ranking tools | | Search apps or app developers | search_apps, get_app_detail, search_app_developers, get_app_developer_detail | | Search natural TikTok traffic videos | search_natural_videos | | Create or manage monitoring | Ad Monitor tools + Monitor Groups & Notifications tools | | Search by image similarity | AI Image Search tools |

Best Practices

Available Tools (73 total)

Ad Spy

Ad Products

TikTok Shop

Advertisers & Stores

Store Analysis (13 tools)

Meta Ad Library

Rankings

Apps

Natural Traffic

Ad Monitor (20 tools)

Monitor Groups & Notifications

AI Image Search (8 tools)

Recommended Workflows

1. Ad Research Workflow

Use when the user wants to find winning creatives, trending campaigns, or competitor ads.

1. Start with search_ads 2. Narrow by keyword, region, platform, delivery days, spend, or engagement filters 3. Inspect the strongest candidates with get_ad_detail 4. Summarize patterns such as hooks, offer angles, duration, or cross-region distribution

2. Product Discovery Workflow

Use when the user wants advertised products or product validation.

1. Start with search_products or search_adlibrary_products 2. Filter by platform, views, timing, niche, or storefront characteristics 3. Use get_product_detail or get_adlibrary_product_detail for deeper analysis 4. Highlight pricing, landing page patterns, Shopify signals, and creative overlap

3. TikTok Shop Workflow

Use when the user asks for rising TikTok Shop products or stores.

1. Use search_tiktok_products or search_tiktok_shops 2. Narrow by sales, GMV, price, category, or growth trend 3. Use get_tiktok_product_detail or get_tiktok_shop_detail 4. Summarize momentum, pricing, and store/product positioning

4. Store / Competitor Analysis Workflow

Use when the user wants to understand a store’s advertising behavior.

1. Identify the store with search_stores or use a known store ID 2. Fetch baseline info with get_store_detail 3. Choose the right analysis tool based on the question: - competition → get_store_competition - product mix → get_store_product_analysis - region mix → get_store_region_analysis - copy patterns → get_store_ad_copy_analysis - campaign timing → get_store_ad_schedule - trend / longest-run / reuse → corresponding store analysis tools

5. Meta Ad Library Workflow

Use when the user explicitly wants Meta/Facebook Ad Library results.

1. Start with search_lib_ads or search_adlibrary_products 2. Filter as tightly as possible 3. Use get_lib_ad_detail or get_adlibrary_product_detail for specific items

6. Monitoring Workflow

Use when the user wants ongoing tracking instead of one-time research.

1. Identify the Facebook advertiser with search_fb_advertisers 2. Create a task using create_monitor_task 3. Organize tasks with groups if needed 4. Review ongoing results via monitor overview, ad list, product list, landing page list, or deep analysis tools 5. Cancel tasks with cancel_monitor_task when the user no longer needs tracking

7. AI Image Search Workflow

Use when the user provides an image and wants visually similar ads, products, stores, or TikTok Shop items.

1. Submit the image with ai_search_submit_image 2. Check processing state with ai_search_image_status 3. Read the overview with ai_search_image_summary 4. Fetch the matching result type: - ads → ai_search_image_ads - products → ai_search_image_products - stores → ai_search_image_stores - TikTok products → ai_search_image_tiktok_products - TikTok shops → ai_search_image_tiktok_shops

Monitor Task Notes

The following tools modify remote state and should be used intentionally:

Before creating, updating, grouping, or deleting monitoring resources, make sure the advertiser, group, or notification target is clear.

Usage Examples

Scope

This skill ONLY:

This skill NEVER:

Credits

Each API call consumes credits from your PipiAds account:

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