ppspy

Search and analyze Shopify stores, Facebook ads, ad monitoring, and sales tracking using PPSPY e-commerce intelligence API. Find winning products, spy on com...

Security Scan

The skill's requirements and runtime instructions mostly match its stated purpose (a wrapper around the PPSPY API), but it relies on installing a third‑party npm package (ppspy-mcp-server) that isn't present as code in the skill bundle—you should review that package before installing.

Purpose & Capability

The skill is described as a PPSPY API integration and only requests an API key (PPSPY_API_KEY) and npm as a binary dependency, which is consistent with calling an external API and installing a helper package. Minor inconsistency: the registry metadata reported 'No install spec' but SKILL.md contains an npm install command and an mcpServers entry.

Instruction Scope

SKILL.md instructs the agent to set PPSPY_API_KEY and install/run the ppspy-mcp-server tool. It does not ask the agent to read unrelated files or other environment variables. The runtime will execute an external npm-installed binary (ppspy-mcp-server), so the agent will run third-party code when invoked.

Install Mechanism

Installation is via 'npm install -g ppspy-mcp-server@1.0.1' (an npm registry package). This is an expected mechanism but is higher-risk than an instruction-only skill because it writes and executes third-party code. No direct downloads from unknown URLs are present, but the npm package itself should be audited (publisher, package contents, recent versions).

Credentials

Only a single API key (PPSPY_API_KEY) is required and declared as the primary credential, which is proportional for a service-integrating skill.

Persistence & Privilege

The skill is not force-included (always: false) and does not request system-wide privileges in the SKILL.md. Installing a global npm package writes files to disk and creates an executable (ppspy-mcp-server) the agent will run, which is expected for this integration but worth noting.

Assessment

This skill appears to be a straightforward PPSPY API wrapper, but it installs and runs a third-party npm package (ppspy-mcp-server) that is not bundled in the skill. Before installing or granting your PPSPY_API_KEY: 1) Inspect the npm package (publisher, repository, recent changes) and, if possible, review its source code; 2) Prefer scoped/limited API keys or rotate keys after use; 3) Consider installing/running the package in an isolated environment (container or VM) rather than globally on your main system; 4) If you need higher assurance, ask the skill author for the package source repository or a signed release. If you cannot review the package, treat the install as a moderate risk.

PPSPY - E-commerce Intelligence

Search and analyze Shopify stores, Facebook ads, ad monitoring, and sales tracking.

Setup

1. Get your API key at ppspy.com
2. Set the environment variable: PPSPY_API_KEY

Available Tools (58 total)

Shopify Stores (5 tools)

• ppspy_shopify_store_list — Search and filter Shopify stores by region, language, revenue, traffic, theme
• ppspy_shopify_store_details — Get detailed information for a specific Shopify store
• ppspy_shopify_store_traffic_list — Search Shopify stores with traffic data
• ppspy_shopify_single_product_store_list — Search single-product Shopify stores
• ppspy_shopify_theme_store_list — Search Shopify stores by theme

Shopify Products (2 tools)

• ppspy_shopify_product_list — Search and filter Shopify products by price, sales, category, revenue
• ppspy_shopify_bestselling_product_list — Get bestselling products for a specific store

Ad Library - Ads (2 tools)

• ppspy_advertisement_list — Search Facebook ads with advanced filters: keyword, audience reach, spend, status
• ppspy_advertisement_details — Get detailed information for a specific advertisement

Ad Library - Stores (8 tools)

• ppspy_ad_store_list — Search ad library stores with advanced filters
• ppspy_ad_store_details — Get detailed information for a specific ad store
• ppspy_ad_store_landing_page_stats — Get landing page statistics
• ppspy_ad_store_advertising_trends — Get advertising trends over time
• ppspy_ad_store_placement_analysis — Get ad placement analysis (day/time breakdown)
• ppspy_ad_store_content_most_used — Get most used ad copy content
• ppspy_ad_store_content_longest_run — Get longest running ad content
• ppspy_ad_store_advertiser_list — Get advertisers associated with a store

Ad Library - Products (2 tools)

• ppspy_ad_product_list — Search ad library products with advanced filters
• ppspy_ad_product_details — Get detailed information for a specific ad product

Ad Monitoring (24 tools)

• ppspy_ad_monitor_create_group — Create monitoring group
• ppspy_ad_monitor_group_list — List all monitoring groups
• ppspy_ad_monitor_edit_group — Edit group name
• ppspy_ad_monitor_delete_group — Delete group
• ppspy_ad_monitor_advertiser_search — Search Facebook advertisers by name
• ppspy_ad_monitor_create_task — Create monitoring task(s)
• ppspy_ad_monitor_task_list — List monitoring tasks
• ppspy_ad_monitor_task_set_group — Assign task to group
• ppspy_ad_monitor_task_cancel — Cancel monitoring task
• ppspy_ad_monitor_task_details — Get task details
• ppspy_ad_monitor_task_real_time_overview — Real-time overview stats
• ppspy_ad_monitor_task_daily_overview — Daily overview
• ppspy_ad_monitor_task_running_overview — Dashboard stats for running tasks
• ppspy_ad_monitor_task_landing_page_overview — Landing page overview
• ppspy_ad_monitor_task_landing_page_list — Landing page list with filters
• ppspy_ad_monitor_task_latest_ad_product — Latest advertised products
• ppspy_ad_monitor_task_ad_product_overview — Product overview by ad count
• ppspy_ad_monitor_task_ad_product_list — Product list with filters
• ppspy_ad_monitor_task_ad_count_stats — Ad count statistics over time
• ppspy_ad_monitor_task_ad_deep_analysis — Ad placement analysis
• ppspy_ad_monitor_task_ad_content_most_used — Most used ad copy
• ppspy_ad_monitor_task_ad_content_longest_run — Longest running ad content
• ppspy_ad_monitor_task_ad_list — Ad list with extensive filters
• ppspy_ad_monitor_task_ad_details — Detailed info for a specific monitored ad

Sales Monitoring (12 tools)

• ppspy_sales_monitor_create_group — Create sales monitoring group
• ppspy_sales_monitor_group_list — List all sales monitoring groups
• ppspy_sales_monitor_edit_group — Edit group name
• ppspy_sales_monitor_delete_group — Delete group
• ppspy_sales_monitor_create_task — Create sales monitoring task(s), batch up to 50 URLs
• ppspy_sales_monitor_task_list — List sales monitoring tasks
• ppspy_sales_monitor_task_details — Detailed task info with daily/hourly stats
• ppspy_sales_monitor_task_real_time_sales — Real-time individual sales records
• ppspy_sales_monitor_task_update — Update task metadata (notes, group)
• ppspy_sales_monitor_task_stop — Stop a monitoring task
• ppspy_sales_monitor_task_delete — Delete stopped task(s)
• ppspy_sales_monitor_task_overview — Aggregated sales overview

Supplement (3 tools)

• ppspy_product_category_list — Get product categories
• ppspy_ad_filter_options — Get ad filter options (button types/texts)
• ppspy_shopify_theme_list — Get Shopify themes

Usage Examples

• "Search for Shopify stores with the highest monthly revenue"
• "Find Facebook ads about pet products running for over 30 days"
• "Show me the bestselling products for this Shopify store"
• "Get ad trends for this store over the last 3 months"
• "Create an ad monitoring task for this Facebook advertiser"
• "What are the real-time sales for this store today?"
• "Search for ad products in the beauty category with high audience reach"
• "Show me the most used ad copy for this store"

Credits

Each API call consumes credits from your PPSPY account:

• Shopify Store/Product Search: 1 credit per record
• Ad Library Search (Ads/Stores/Products): 2 credits per record
• Ad Monitoring / Sales Monitoring: 1 monitoring quota per task
• Detail/Analysis/Supplement APIs: Free