ppspy-mcp-server 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+interface ApiResponse {
+    code: number;
+    message: string;
+    data: any;
+}
+export declare function apiGet(path: string, params?: Record<string, any>): Promise<ApiResponse>;
+export declare function apiPost(path: string, body?: Record<string, any>): Promise<ApiResponse>;
+export declare function apiPut(path: string, body?: Record<string, any>): Promise<ApiResponse>;
+export declare function apiDelete(path: string, body?: Record<string, any>): Promise<ApiResponse>;
+export {};

package/dist/client.js

@@ -0,0 +1,67 @@
+const BASE_URL = "https://api.ppspy.com";
+function getApiKey() {
+    const key = process.env.PPSPY_API_KEY;
+    if (!key) {
+        throw new Error("PPSPY_API_KEY environment variable is required");
+    }
+    return key;
+}
+function buildHeaders() {
+    return {
+        Authorization: getApiKey(),
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+}
+export async function apiGet(path, params) {
+    const url = new URL(path, BASE_URL);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null && value !== "") {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    const res = await fetch(url.toString(), { headers: buildHeaders() });
+    const json = (await res.json());
+    if (json.code !== 200) {
+        throw new Error(`PPSPY API error ${json.code}: ${json.message}`);
+    }
+    return json;
+}
+export async function apiPost(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "POST",
+        headers: buildHeaders(),
+        body: JSON.stringify(body ?? {}),
+    });
+    const json = (await res.json());
+    if (json.code !== 200) {
+        throw new Error(`PPSPY API error ${json.code}: ${json.message}`);
+    }
+    return json;
+}
+export async function apiPut(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "PUT",
+        headers: buildHeaders(),
+        body: JSON.stringify(body ?? {}),
+    });
+    const json = (await res.json());
+    if (json.code !== 200) {
+        throw new Error(`PPSPY API error ${json.code}: ${json.message}`);
+    }
+    return json;
+}
+export async function apiDelete(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "DELETE",
+        headers: buildHeaders(),
+        ...(body ? { body: JSON.stringify(body) } : {}),
+    });
+    const json = (await res.json());
+    if (json.code !== 200) {
+        throw new Error(`PPSPY API error ${json.code}: ${json.message}`);
+    }
+    return json;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { registerSupplementTools } from "./tools/supplement.js";
+import { registerShopifyStoreTools } from "./tools/shopify-store.js";
+import { registerShopifyProductTools } from "./tools/shopify-product.js";
+import { registerAdsLibraryTools } from "./tools/ads-library.js";
+import { registerAdStoreTools } from "./tools/ad-store.js";
+import { registerAdProductTools } from "./tools/ad-product.js";
+import { registerAdMonitorTools } from "./tools/ad-monitor.js";
+import { registerSalesMonitorTools } from "./tools/sales-monitor.js";
+function createServer() {
+    const server = new McpServer({
+        name: "ppspy",
+        version: "1.0.0",
+    });
+    registerSupplementTools(server);
+    registerShopifyStoreTools(server);
+    registerShopifyProductTools(server);
+    registerAdsLibraryTools(server);
+    registerAdStoreTools(server);
+    registerAdProductTools(server);
+    registerAdMonitorTools(server);
+    registerSalesMonitorTools(server);
+    return server;
+}
+const transportMode = process.argv.includes("--http") ? "http" : "stdio";
+if (transportMode === "stdio") {
+    // stdio mode — for Claude Desktop / Claude Code
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+else {
+    // Streamable HTTP mode — for web clients
+    const app = express();
+    app.use(express.json());
+    const transports = new Map();
+    app.post("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && transports.has(sessionId)) {
+            const transport = transports.get(sessionId);
+            await transport.handleRequest(req, res, req.body);
+            return;
+        }
+        if (sessionId && !transports.has(sessionId)) {
+            res.status(400).json({ error: "Invalid session ID" });
+            return;
+        }
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (id) => {
+                transports.set(id, transport);
+            },
+        });
+        transport.onclose = () => {
+            const id = [...transports.entries()].find(([, t]) => t === transport)?.[0];
+            if (id)
+                transports.delete(id);
+        };
+        const server = createServer();
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+    app.get("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!sessionId || !transports.has(sessionId)) {
+            res.status(400).json({ error: "Invalid or missing session ID" });
+            return;
+        }
+        const transport = transports.get(sessionId);
+        await transport.handleRequest(req, res);
+    });
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!sessionId || !transports.has(sessionId)) {
+            res.status(400).json({ error: "Invalid or missing session ID" });
+            return;
+        }
+        const transport = transports.get(sessionId);
+        await transport.handleRequest(req, res);
+    });
+    const PORT = parseInt(process.env.PORT || "3000", 10);
+    app.listen(PORT, () => {
+        console.log(`PPSPY MCP Server running on http://localhost:${PORT}/mcp`);
+    });
+}

package/dist/tools/ad-monitor.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdMonitorTools(server: McpServer): void;

package/dist/tools/ad-monitor.js

@@ -0,0 +1,234 @@
+import { z } from "zod";
+import { apiPost, apiGet, apiPut, apiDelete } from "../client.js";
+export function registerAdMonitorTools(server) {
+    // ===== Group CRUD =====
+    server.tool("ppspy_ad_monitor_create_group", "Create an ad monitoring group. Free.", {
+        name: z.string().describe("Group name (required)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-groups", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_group_list", "List all ad monitoring groups. Free.", {}, async () => {
+        const res = await apiGet("/open-api/v1/ad-monitor-groups");
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_edit_group", "Edit an ad monitoring group name. Free.", {
+        id: z.string().describe("Group ID (required)"),
+        name: z.string().describe("New group name (required)"),
+    }, async ({ id, name }) => {
+        const res = await apiPut(`/open-api/v1/ad-monitor-groups/${id}`, { name });
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_delete_group", "Delete an ad monitoring group. WARNING: All tasks under this group will be stopped. Free.", {
+        id: z.string().describe("Group ID (required)"),
+    }, async ({ id }) => {
+        const res = await apiDelete(`/open-api/v1/ad-monitor-groups/${id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Advertiser Search =====
+    server.tool("ppspy_ad_monitor_advertiser_search", "Search Facebook advertisers by name. Free.", {
+        name: z.string().describe("Advertiser name to search (required)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/search-fb-ads-advertiser", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Task CRUD =====
+    server.tool("ppspy_ad_monitor_create_task", "Create ad monitoring task(s). Cost: 1 monitoring quota per task. Provide one of: facebook_page_id_list, facebook_page_url_list, facebook_public_page_number_list, or facebook_shop_url_list. Priority: page_id > page_url > page_number > shop_url.", {
+        facebook_page_id_list: z.array(z.string()).optional().describe("Facebook Advertiser ID list"),
+        facebook_page_url_list: z.array(z.string()).optional().describe("Facebook Advertiser URL list"),
+        facebook_public_page_number_list: z.array(z.string()).optional().describe("Facebook Public Page Number list"),
+        facebook_shop_url_list: z.array(z.string()).optional().describe("Store/Website URL list"),
+        group_id: z.string().optional().describe("Ad Group ID"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/create-monitor-task", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_list", "List ad monitoring tasks with filters. Free.", {
+        keyword: z.string().optional().describe("Search keyword"),
+        monitor_task_type: z.number().optional().describe("Task type filter"),
+        country: z.string().optional().describe("Country filter"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+        group_id: z.string().optional().describe("Group ID filter"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/list", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_set_group", "Assign a monitoring task to a group. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        group_id: z.string().nullable().describe("Group ID (null to unset)"),
+    }, async ({ task_id, group_id }) => {
+        const res = await apiPost(`/open-api/v1/ad-monitor-task/set-group/${task_id}`, { group_id });
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_cancel", "Cancel a monitoring task. Quotas will NOT be refunded. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+    }, async ({ task_id }) => {
+        const res = await apiPut(`/open-api/v1/ad-monitor-task/cancel/${task_id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Task Details & Overview =====
+    server.tool("ppspy_ad_monitor_task_details", "Get monitoring task details. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+    }, async ({ task_id }) => {
+        const res = await apiPost(`/open-api/v1/ad-monitor-task/monitor-task-details/${task_id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_real_time_overview", "Get real-time overview stats for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+    }, async ({ task_id }) => {
+        const res = await apiPost(`/open-api/v1/ad-monitor-task/real-time-overview/${task_id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_daily_overview", "Get daily overview for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        date: z.number().describe("UTC timestamp in seconds (required)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-daily-overview", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_running_overview", "Get aggregated dashboard stats for running tasks (or specific group). Free.", {
+        group_id: z.string().optional().describe("Group ID (optional, filter by group)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/board", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Landing Pages =====
+    server.tool("ppspy_ad_monitor_task_landing_page_overview", "Get landing page overview for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/landing-pages-overview", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_landing_page_list", "Get landing page list with filters for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        keyword: z.string().optional().describe("Keyword filter"),
+        first_discovered_at_start: z.number().optional().describe("First discovery start (Unix timestamp)"),
+        first_discovered_at_end: z.number().optional().describe("First discovery end (Unix timestamp)"),
+        ad_count_start: z.number().optional().describe("Ad count minimum"),
+        ad_count_end: z.number().optional().describe("Ad count maximum"),
+        active_days_start: z.number().optional().describe("Active days minimum"),
+        active_days_end: z.number().optional().describe("Active days maximum"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/landing-page-list", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Products =====
+    server.tool("ppspy_ad_monitor_task_latest_ad_product", "Get latest advertised products for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        limit: z.number().optional().describe("Limit number of results"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/latest-products", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_ad_product_overview", "Get product overview (by ad count) for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-products-overview", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_ad_product_list", "Get product list with filters for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        keyword: z.string().optional().describe("Keyword filter"),
+        first_discovered_at_start: z.number().optional().describe("First discovery start (Unix timestamp)"),
+        first_discovered_at_end: z.number().optional().describe("First discovery end (Unix timestamp)"),
+        ad_count_start: z.number().optional().describe("Ad count minimum"),
+        ad_count_end: z.number().optional().describe("Ad count maximum"),
+        price_start: z.number().optional().describe("Price minimum"),
+        price_end: z.number().optional().describe("Price maximum"),
+        active_days_start: z.number().optional().describe("Active days minimum"),
+        active_days_end: z.number().optional().describe("Active days maximum"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/product-list", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Ad Analytics =====
+    server.tool("ppspy_ad_monitor_task_ad_count_stats", "Get ad count statistics over time for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        date_start: z.number().optional().describe("Date start (Unix timestamp)"),
+        date_end: z.number().optional().describe("Date end (Unix timestamp)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-count-statistics", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_ad_deep_analysis", "Get ad placement analysis (by day of week or time period). Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        dimension: z.number().optional().describe("1=By day of week, 2=By time period"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-deep-analysis", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_ad_content_most_used", "Get most used ad copy for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-copy-most-used", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_ad_content_longest_run", "Get longest running ad content for a monitoring task. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        advertiser_id: z.string().optional().describe("Filter by advertiser ID"),
+        related_store_id: z.string().optional().describe("Filter by store ID"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-copy-longest-run", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Ad List & Details =====
+    server.tool("ppspy_ad_monitor_task_ad_list", "Get ad list for a monitoring task with extensive filters. Free.", {
+        task_id: z.string().describe("Monitor task ID (required)"),
+        ad_platform_list: z.array(z.string()).describe("Ad platforms (required): FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, THREADS"),
+        ad_content: z.string().optional().describe("Ad content search"),
+        ad_audience_reach_start: z.number().optional().describe("Audience reach minimum"),
+        ad_audience_reach_end: z.number().optional().describe("Audience reach maximum"),
+        ad_cost_start: z.number().optional().describe("Ad spend start (USD)"),
+        ad_cost_end: z.number().optional().describe("Ad spend end (USD)"),
+        adset_count_start: z.number().optional().describe("Ad sets minimum"),
+        adset_count_end: z.number().optional().describe("Ad sets maximum"),
+        ad_forecast: z.array(z.number()).optional().describe("AI score: 1-Testing, 2-Growth, 3-Profitable"),
+        media_format: z.array(z.number()).optional().describe("Media: 1-Video, 2-Image, 3-Carousel"),
+        video_duration_start: z.number().optional().describe("Video duration start (seconds)"),
+        video_duration_end: z.number().optional().describe("Video duration end (seconds)"),
+        ad_started_at_start: z.number().optional().describe("Ad start time start (Unix timestamp)"),
+        ad_started_at_end: z.number().optional().describe("Ad start time end (Unix timestamp)"),
+        active_days_start: z.number().optional().describe("Active days minimum"),
+        active_days_end: z.number().optional().describe("Active days maximum"),
+        button_text: z.array(z.string()).optional().describe("Button text filter"),
+        ad_status: z.array(z.number()).optional().describe("Status: 1-Running, 2-Stopped, 3-Removed"),
+        landing_page_type: z.array(z.number()).optional().describe("Landing page: 1-Product, 2-Collection, 3-Other"),
+        keyword: z.string().optional().describe("Keyword filter"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-monitor-task/ad-library-list", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_monitor_task_ad_details", "Get detailed information for a specific ad in monitoring. Free.", {
+        ad_id: z.string().describe("Ad ID (required)"),
+    }, async ({ ad_id }) => {
+        const res = await apiPost(`/open-api/v1/ad-monitor-task/ad-details/${ad_id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/ad-product.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdProductTools(server: McpServer): void;

package/dist/tools/ad-product.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { apiPost, apiGet } from "../client.js";
+const keywordSchema = z.object({
+    field: z.string().describe("Search field"),
+    value: z.string().describe("Search value"),
+    logic_operator: z.string().describe("Logic operator: and, or"),
+});
+export function registerAdProductTools(server) {
+    server.tool("ppspy_ad_product_list", "Search ad library products with advanced filters. Cost: 2 credits per record.", {
+        extend_keywords: z.array(keywordSchema).optional().describe("Keyword search conditions"),
+        exclude_keywords: z.array(keywordSchema).optional().describe("Exclude keyword conditions"),
+        ad_forecast: z.array(z.number()).optional().describe("AI score: 1-Testing, 2-Growth, 3-Profitable"),
+        e_commerce_platform: z.array(z.string()).optional().describe("E-commerce platforms"),
+        creation_time_start: z.number().optional().describe("Product creation time start (Unix timestamp)"),
+        creation_time_end: z.number().optional().describe("Product creation time end (Unix timestamp)"),
+        category_id: z.array(z.string()).optional().describe("Product category IDs"),
+        store_country: z.array(z.string()).optional().describe("Store country codes"),
+        price_start: z.number().optional().describe("Price start (USD)"),
+        price_end: z.number().optional().describe("Price end (USD)"),
+        currency: z.string().optional().describe("Currency"),
+        language: z.array(z.string()).optional().describe("Language codes"),
+        ad_count_start: z.number().optional().describe("Ad count minimum"),
+        ad_count_end: z.number().optional().describe("Ad count maximum"),
+        adset_count_start: z.number().optional().describe("Ad sets minimum"),
+        adset_count_end: z.number().optional().describe("Ad sets maximum"),
+        ad_audience_reach_start: z.number().optional().describe("Audience reach minimum"),
+        ad_audience_reach_end: z.number().optional().describe("Audience reach maximum"),
+        ad_cost_start: z.number().optional().describe("Ad spend start (USD)"),
+        ad_cost_end: z.number().optional().describe("Ad spend end (USD)"),
+        ad_status: z.array(z.number()).optional().describe("Ad status: 1-Running, 2-Stopped, 3-Removed"),
+        store_id: z.string().optional().describe("Filter by store ID"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-products/search", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_product_details", "Get detailed information for a specific ad product.", {
+        id: z.string().describe("Ad product ID (required)"),
+    }, async ({ id }) => {
+        const res = await apiGet(`/open-api/v1/ad-products/${id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/ad-store.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdStoreTools(server: McpServer): void;

package/dist/tools/ad-store.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { apiPost, apiGet } from "../client.js";
+const keywordSchema = z.object({
+    field: z.string().describe("Search field: all, store_name, store_url"),
+    value: z.string().describe("Search value"),
+    logic_operator: z.string().describe("Logic operator: and, or"),
+});
+export function registerAdStoreTools(server) {
+    server.tool("ppspy_ad_store_list", "Search ad library stores with advanced filters. Cost: 2 credits per record.", {
+        extend_keywords: z.array(keywordSchema).optional().describe("Keyword search conditions"),
+        exclude_keywords: z.array(keywordSchema).optional().describe("Exclude keyword conditions"),
+        e_commerce_platform: z.array(z.string()).optional().describe("E-commerce platforms"),
+        ad_status: z.array(z.number()).optional().describe("Ad status: 1-Running, 2-Stopped, 3-Removed"),
+        category_ids: z.array(z.string()).optional().describe("Category IDs"),
+        ad_country: z.array(z.string()).optional().describe("Ad region codes"),
+        product_count_start: z.number().optional().describe("Product count minimum"),
+        product_count_end: z.number().optional().describe("Product count maximum"),
+        month_visits_start: z.number().optional().describe("Monthly visits minimum"),
+        month_visits_end: z.number().optional().describe("Monthly visits maximum"),
+        advertiser_count_start: z.number().optional().describe("Advertiser count minimum"),
+        advertiser_count_end: z.number().optional().describe("Advertiser count maximum"),
+        adset_count_start: z.number().optional().describe("Ad sets count minimum"),
+        adset_count_end: z.number().optional().describe("Ad sets count maximum"),
+        ad_count_start: z.number().optional().describe("Ad count minimum"),
+        ad_count_end: z.number().optional().describe("Ad count maximum"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/ad-stores/search", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_details", "Get detailed information for a specific ad store.", {
+        id: z.string().describe("Ad store ID (required)"),
+    }, async ({ id }) => {
+        const res = await apiGet(`/open-api/v1/ad-stores/${id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_landing_page_stats", "Get landing page statistics for an ad store.", {
+        store_id: z.string().describe("Store ID (required)"),
+        landing_page: z.string().optional().describe("Landing page URL filter"),
+        keyword: z.string().optional().describe("Keyword filter"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/ad-stores/landing-pages-ad-count", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_advertising_trends", "Get advertising trends for an ad store over time.", {
+        store_id: z.string().describe("Store ID (required)"),
+        date_start: z.string().optional().describe("Date start (Y-m-d)"),
+        date_end: z.string().optional().describe("Date end (Y-m-d)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/ad-stores/analysis", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_placement_analysis", "Get ad placement analysis (day of week and time period breakdown) for a store.", {
+        store_id: z.string().describe("Store ID (required)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/ad-stores/deep-analysis", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_content_most_used", "Get most used ad copy content for a store.", {
+        store_id: z.string().describe("Store ID (required)"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/ad-stores/ad-content", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_content_longest_run", "Get longest running ad content for a store.", {
+        store_id: z.string().describe("Store ID (required)"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/ad-stores/ad-content-longest-run", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_store_advertiser_list", "Get advertisers associated with a store.", {
+        store_id: z.string().describe("Store ID (required)"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/ad-stores/advertisers", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/ads-library.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdsLibraryTools(server: McpServer): void;

package/dist/tools/ads-library.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { apiPost, apiGet } from "../client.js";
+const keywordSchema = z.object({
+    field: z.string().describe("Search field: all, ad_content, landing_pages, advertiser_name, product_name"),
+    value: z.string().describe("Search value"),
+    logic_operator: z.string().describe("Logic operator: and, or"),
+});
+export function registerAdsLibraryTools(server) {
+    server.tool("ppspy_advertisement_list", "Search advertisements with advanced filters. Cost: 2 credits per record.", {
+        extend_keywords: z.array(keywordSchema).optional().describe("Keyword search conditions"),
+        exclude_keywords: z.array(keywordSchema).optional().describe("Exclude keyword conditions"),
+        source_ad_id: z.array(z.string()).optional().describe("Ad Creative IDs"),
+        source_advertiser_id: z.string().optional().describe("Advertiser Page ID"),
+        advertiser_id: z.string().optional().describe("Advertiser ID"),
+        first_discovered_at_start: z.number().optional().describe("First discovery time start (Unix timestamp seconds)"),
+        first_discovered_at_end: z.number().optional().describe("First discovery time end (Unix timestamp seconds)"),
+        last_discovered_at_start: z.number().optional().describe("Last updated time start (Unix timestamp seconds)"),
+        last_discovered_at_end: z.number().optional().describe("Last updated time end (Unix timestamp seconds)"),
+        country: z.array(z.string()).optional().describe("Region codes"),
+        language: z.array(z.string()).optional().describe("Language codes"),
+        ad_audience_reach_start: z.number().optional().describe("Audience reach minimum"),
+        ad_audience_reach_end: z.number().optional().describe("Audience reach maximum"),
+        ad_cost_start: z.number().optional().describe("Ad spend start (USD)"),
+        ad_cost_end: z.number().optional().describe("Ad spend end (USD)"),
+        adset_count_start: z.number().optional().describe("Ad sets count minimum"),
+        adset_count_end: z.number().optional().describe("Ad sets count maximum"),
+        ad_forecast: z.array(z.number()).optional().describe("AI score: 1-Testing, 2-Growth, 3-Profitable"),
+        media_format: z.array(z.number()).optional().describe("Media format: 1-Video, 2-Image, 3-Carousel"),
+        video_duration_start: z.number().optional().describe("Video duration start (seconds)"),
+        video_duration_end: z.number().optional().describe("Video duration end (seconds)"),
+        e_commerce_platform: z.array(z.string()).optional().describe("E-commerce platforms"),
+        ad_started_at_start: z.number().optional().describe("Ad start time start (Unix timestamp)"),
+        ad_started_at_end: z.number().optional().describe("Ad start time end (Unix timestamp)"),
+        latest_actived_at_start: z.number().optional().describe("Last active time start (Unix timestamp)"),
+        latest_actived_at_end: z.number().optional().describe("Last active time end (Unix timestamp)"),
+        active_days_start: z.number().optional().describe("Active days minimum"),
+        active_days_end: z.number().optional().describe("Active days maximum"),
+        button_type: z.string().optional().describe("Button type"),
+        button_text: z.array(z.string()).optional().describe("Button text"),
+        ad_status: z.array(z.number()).optional().describe("Ad status: 1-Running, 2-Stopped, 3-Removed"),
+        ad_platform: z.array(z.string()).optional().describe("Ad platforms"),
+        landing_page_type: z.array(z.number()).optional().describe("Landing page type: 1-Product, 2-Collection, 3-Other"),
+        related_product_ids: z.array(z.string()).optional().describe("Product IDs"),
+        product_category_id: z.array(z.string()).optional().describe("Product category IDs"),
+        product_price_usd_start: z.number().optional().describe("Product price start (USD)"),
+        product_price_usd_end: z.number().optional().describe("Product price end (USD)"),
+        product_creation_time_start: z.number().optional().describe("Product creation time start (Unix timestamp)"),
+        product_creation_time_end: z.number().optional().describe("Product creation time end (Unix timestamp)"),
+        product_ad_count_start: z.number().optional().describe("Product ad count minimum"),
+        product_ad_count_end: z.number().optional().describe("Product ad count maximum"),
+        related_store_ids: z.array(z.string()).optional().describe("Store IDs"),
+        store_ad_count_start: z.number().optional().describe("Store ad count minimum"),
+        store_ad_count_end: z.number().optional().describe("Store ad count maximum"),
+        advertiser_ad_count_start: z.number().optional().describe("Advertiser ad count minimum"),
+        advertiser_ad_count_end: z.number().optional().describe("Advertiser ad count maximum"),
+        order_by: z.string().optional().describe("Sort: ad_started_at, adset_count, ad_audience_reach, last_discovered_at, ad_cost, advertiser_ad_count, product_price_usd, product_ad_count, product_creation_time, active_days"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number (min: 1)"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+        with_ad_status_group: z.string().optional().describe("Include ad status stats (pass empty string to enable)"),
+        search_after: z.string().optional().describe("Deep pagination cursor (pass empty string for first page)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/advertisements/search", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_advertisement_details", "Get detailed information for a specific advertisement. Requires ad ID from advertisement list.", {
+        id: z.string().describe("Advertisement ID (required)"),
+    }, async ({ id }) => {
+        const res = await apiGet(`/open-api/v1/advertisements/${id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/sales-monitor.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSalesMonitorTools(server: McpServer): void;

package/dist/tools/sales-monitor.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { apiPost, apiGet, apiPut, apiDelete } from "../client.js";
+export function registerSalesMonitorTools(server) {
+    // ===== Group CRUD =====
+    server.tool("ppspy_sales_monitor_create_group", "Create a sales monitoring group. Free.", {
+        name: z.string().describe("Group name (required)"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/sales-monitor-groups", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_group_list", "List all sales monitoring groups. Free.", {}, async () => {
+        const res = await apiGet("/open-api/v1/sales-monitor-groups");
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_edit_group", "Edit a sales monitoring group name. Free.", {
+        id: z.string().describe("Group ID (required)"),
+        name: z.string().describe("New group name (required)"),
+    }, async ({ id, name }) => {
+        const res = await apiPut(`/open-api/v1/sales-monitor-groups/${id}`, { name });
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_delete_group", "Delete a sales monitoring group. WARNING: All tasks under this group will be stopped. Free.", {
+        id: z.string().describe("Group ID (required)"),
+    }, async ({ id }) => {
+        const res = await apiDelete(`/open-api/v1/sales-monitor-groups/${id}`);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    // ===== Task Operations =====
+    server.tool("ppspy_sales_monitor_create_task", "Create sales monitoring task(s). Cost: 1 monitoring quota per task. Supports batch up to 50 URLs.", {
+        urls: z.array(z.string()).describe("Store URLs or domains to monitor (required, max 50)"),
+        with_fake_sales: z.boolean().optional().describe("Monitor stores with fake sales (default: false)"),
+        group_id: z.string().optional().describe("Group ID"),
+    }, async (params) => {
+        const res = await apiPost("/open-api/v1/sales-monitor-task", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_list", "List sales monitoring tasks with filters. Free.", {
+        keyword: z.string().optional().describe("Search keyword"),
+        monitor_task_status: z.number().optional().describe("Status: 0-Stopped, 1-Monitoring"),
+        note: z.string().optional().describe("Note filter"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number (min: 1)"),
+        per_page: z.number().optional().describe("Page size (1-100)"),
+        group_id: z.string().optional().describe("Group ID filter"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/sales-monitor-task", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_details", "Get detailed sales monitoring task info including daily/hourly stats. Free.", {
+        site_domain: z.string().describe("Store domain (required)"),
+        period_id: z.string().optional().describe("Monitor period ID (defaults to latest)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/sales-monitor-task/detail", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_real_time_sales", "Get real-time individual sales records. Free.", {
+        task_id: z.string().describe("Real-time sales task ID (required, from task details)"),
+        latest_id: z.string().optional().describe("Last record ID for pagination (omit for latest 100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/sales-monitor-task/real-time-sales", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_update", "Update sales monitoring task metadata (notes, group). Free.", {
+        site_domain: z.string().describe("Store domain (required)"),
+        note: z.string().nullable().optional().describe("Note"),
+        group_id: z.string().nullable().optional().describe("Group ID"),
+    }, async (params) => {
+        const res = await apiPut("/open-api/v1/sales-monitor-task", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_stop", "Stop a sales monitoring task. WARNING: Consumed quotas are NOT refunded. Free.", {
+        site_domain: z.string().describe("Store domain (required)"),
+    }, async (params) => {
+        const res = await apiPut("/open-api/v1/sales-monitor-task/stop", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_delete", "Delete sales monitoring task(s). Only stopped tasks can be deleted. Free.", {
+        site_domains: z.array(z.string()).describe("Store domains to delete (required)"),
+    }, async (params) => {
+        const res = await apiDelete("/open-api/v1/sales-monitor-task", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_sales_monitor_task_overview", "Get aggregated sales overview (total, today, yesterday, 7-day) in USD. Free.", {
+        group_id: z.string().optional().describe("Group ID (optional, filter by group)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/sales-monitor-task/overview", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/shopify-product.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerShopifyProductTools(server: McpServer): void;

package/dist/tools/shopify-product.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { apiGet } from "../client.js";
+export function registerShopifyProductTools(server) {
+    server.tool("ppspy_shopify_product_list", "Search and filter Shopify products. Cost: 1 credit per record.", {
+        title: z.string().optional().describe("Product title, comma-separated for multiple"),
+        url: z.string().optional().describe("Store URL, comma-separated for multiple"),
+        pixel: z.string().optional().describe("Ad platform(s): snap, tiktok, pinterest"),
+        country: z.string().optional().describe("Store region(s), comma-separated"),
+        created_at_start: z.string().optional().describe("Creation time start (Y-m-d)"),
+        created_at_end: z.string().optional().describe("Creation time end (Y-m-d)"),
+        updated_at_start: z.string().optional().describe("Latest order time start (Y-m-d)"),
+        updated_at_end: z.string().optional().describe("Latest order time end (Y-m-d)"),
+        price_start: z.number().optional().describe("Price range start"),
+        price_end: z.number().optional().describe("Price range end"),
+        currency: z.string().optional().describe("Currency, comma-separated"),
+        language: z.string().optional().describe("Store language(s), comma-separated"),
+        is_bestselling: z.number().optional().describe("Bestseller flag: 1=Yes, 0=No"),
+        shop_id: z.string().optional().describe("Store ID"),
+        category_id: z.number().optional().describe("Product Category ID"),
+        monthly_sale_start: z.number().optional().describe("Monthly sales minimum"),
+        monthly_sale_end: z.number().optional().describe("Monthly sales maximum"),
+        monthly_revenue_start: z.number().optional().describe("Monthly revenue minimum"),
+        monthly_revenue_end: z.number().optional().describe("Monthly revenue maximum"),
+        published_products_count_start: z.number().optional().describe("Store product count min"),
+        published_products_count_end: z.number().optional().describe("Store product count max"),
+        exclude_title: z.string().optional().describe("Exclude product titles, comma-separated"),
+        exclude_url: z.string().optional().describe("Exclude store URLs, comma-separated"),
+        category_tags: z.string().optional().describe("Product types: 1-Dropshipping, 2-POD, 3-COD, 4-Digital"),
+        order_by: z.string().optional().describe("Sort: updated_at, created_at, published_products_count, price, monthly_sale, monthly_revenue"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number (min: 1)"),
+        per_page: z.number().optional().describe("Items per page (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/product", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_shopify_bestselling_product_list", "Get bestselling products for a specific Shopify store. Requires shop_id.", {
+        shop_id: z.string().describe("Store ID (required)"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Items per page (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/bestsellers", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/shopify-store.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerShopifyStoreTools(server: McpServer): void;

package/dist/tools/shopify-store.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { apiGet } from "../client.js";
+export function registerShopifyStoreTools(server) {
+    server.tool("ppspy_shopify_store_list", "Search and filter Shopify stores. Cost: 1 credit per record.", {
+        url: z.string().optional().describe("Store URL(s), comma-separated"),
+        tags: z.string().optional().describe("Tag(s), comma-separated"),
+        pixel: z.string().optional().describe("Ad platform(s), comma-separated. Options: snap, tiktok, pinterest"),
+        last_sold_at_start: z.string().optional().describe("Latest order date start (Y-m-d)"),
+        last_sold_at_end: z.string().optional().describe("Latest order date end (Y-m-d)"),
+        month_visits_start: z.number().optional().describe("Monthly visits minimum"),
+        month_visits_end: z.number().optional().describe("Monthly visits maximum"),
+        published_products_count_start: z.number().optional().describe("Product count minimum"),
+        published_products_count_end: z.number().optional().describe("Product count maximum"),
+        language: z.string().optional().describe("Store language(s), comma-separated"),
+        country: z.string().optional().describe("Store region(s), comma-separated"),
+        last_product_published_at_start: z.string().optional().describe("Latest product publish date start (Y-m-d)"),
+        last_product_published_at_end: z.string().optional().describe("Latest product publish date end (Y-m-d)"),
+        first_product_published_at_start: z.string().optional().describe("First product publish date start (Y-m-d)"),
+        first_product_published_at_end: z.string().optional().describe("First product publish date end (Y-m-d)"),
+        currency: z.string().optional().describe("Currency/currencies, comma-separated"),
+        social_media: z.string().optional().describe("Social media platform(s), comma-separated. Options: facebook, instagram, tiktok, twitter, pinterest, youtube"),
+        themes: z.string().optional().describe("Search by theme name"),
+        app: z.string().optional().describe("Search by installed apps"),
+        pixel_text: z.string().optional().describe("Search by pixel name/ID"),
+        title: z.string().optional().describe("Store name(s), comma-separated"),
+        description: z.string().optional().describe("Store description(s), comma-separated"),
+        exclude_title: z.string().optional().describe("Exclude store name(s), comma-separated"),
+        exclude_url: z.string().optional().describe("Exclude store URL(s), comma-separated"),
+        exclude_description: z.string().optional().describe("Exclude store description(s), comma-separated"),
+        monthly_sale_start: z.number().optional().describe("Monthly sales minimum"),
+        monthly_sale_end: z.number().optional().describe("Monthly sales maximum"),
+        monthly_revenue_start: z.number().optional().describe("Monthly revenue minimum"),
+        monthly_revenue_end: z.number().optional().describe("Monthly revenue maximum"),
+        category_tags: z.string().optional().describe("Product types, comma-separated. Options: 1-Dropshipping, 2-POD, 3-COD, 4-Digital"),
+        shield_shop: z.number().optional().describe("Filter suspicious shops: 1-yes, 2-no"),
+        order_by: z.string().optional().describe("Sort field: last_sold_at, published_products_count, last_product_published_at, first_product_published_at, month_visits, monthly_sale, monthly_revenue"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number (min: 1)"),
+        per_page: z.number().optional().describe("Items per page (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/shop", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_shopify_store_details", "Get detailed information for a specific Shopify store. Requires shop_id from store list.", {
+        shop_id: z.string().describe("Shop ID (required)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/shop/store-details", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_shopify_store_traffic_list", "Search Shopify stores with traffic data. Cost: 1 credit per record.", {
+        url: z.string().optional().describe("Store URL(s), comma-separated"),
+        pixel: z.string().optional().describe("Ad platform(s), comma-separated"),
+        last_sold_at_start: z.string().optional().describe("Latest order date start (Y-m-d)"),
+        last_sold_at_end: z.string().optional().describe("Latest order date end (Y-m-d)"),
+        month_visits_start: z.number().optional().describe("Monthly visits minimum"),
+        month_visits_end: z.number().optional().describe("Monthly visits maximum"),
+        language: z.string().optional().describe("Store language(s), comma-separated"),
+        country: z.string().optional().describe("Store region(s), comma-separated"),
+        currency: z.string().optional().describe("Currency, comma-separated"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Items per page (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/shop/traffic-shop", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_shopify_single_product_store_list", "Search single-product Shopify stores. Cost: 1 credit per record.", {
+        url: z.string().optional().describe("Store URL(s), comma-separated"),
+        tags: z.string().optional().describe("Tag(s), comma-separated"),
+        pixel: z.string().optional().describe("Ad platform(s), comma-separated"),
+        language: z.string().optional().describe("Store language(s), comma-separated"),
+        country: z.string().optional().describe("Store region(s), comma-separated"),
+        currency: z.string().optional().describe("Currency, comma-separated"),
+        themes: z.string().optional().describe("Theme name"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Items per page (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/shop/single-product-shop", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_shopify_theme_store_list", "Search Shopify stores by theme. Cost: 1 credit per record.", {
+        url: z.string().optional().describe("Store URL(s), comma-separated"),
+        tags: z.string().optional().describe("Tag(s), comma-separated"),
+        language: z.string().optional().describe("Store language(s), comma-separated"),
+        country: z.string().optional().describe("Store region(s), comma-separated"),
+        currency: z.string().optional().describe("Currency, comma-separated"),
+        themes_text: z.string().optional().describe("Theme name to search"),
+        order_by: z.string().optional().describe("Sort field"),
+        direction: z.string().optional().describe("Sort direction: desc, asc"),
+        page: z.number().optional().describe("Page number"),
+        per_page: z.number().optional().describe("Items per page (1-100)"),
+    }, async (params) => {
+        const res = await apiGet("/open-api/v1/shop/theme-shop", params);
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/dist/tools/supplement.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSupplementTools(server: McpServer): void;

package/dist/tools/supplement.js

@@ -0,0 +1,15 @@
+import { apiGet } from "../client.js";
+export function registerSupplementTools(server) {
+    server.tool("ppspy_product_category_list", "Get the list of product categories. Free, no credits consumed.", {}, async () => {
+        const res = await apiGet("/open-api/v1/product/categories");
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_ad_filter_options", "Get ad filter options (button types and button texts). Free, no credits consumed.", {}, async () => {
+        const res = await apiGet("/open-api/v1/advertisements/options");
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+    server.tool("ppspy_shopify_theme_list", "Get the list of Shopify themes. Free, no credits consumed.", {}, async () => {
+        const res = await apiGet("/open-api/v1/shopify-themes");
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "ppspy-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for PPSPY Open API - Shopify spy, ad spy, ad monitor, sales monitor",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ppspy-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "ppspy",
+    "shopify",
+    "ecommerce",
+    "ad-spy",
+    "dropshipping",
+    "facebook-ads",
+    "sales-monitor"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicekid1/ppspy-mcp-server"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "express": "^5.1.0",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.2",
+    "@types/node": "^22.15.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  }
+}