pipiads-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# PipiAds MCP Server
+
+MCP Server for [PipiAds](https://www.pipiads.com) advertising intelligence API. Enables AI assistants like Claude to search and analyze ads, products, and stores across TikTok and Facebook.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_ads` | Search ad videos across TikTok & Facebook by keyword, region, metrics |
+| `get_ad_detail` | Get detailed info for a specific ad by video ID |
+| `search_products` | Search e-commerce products with ad data |
+| `get_product_detail` | Get detailed product info including Shopify data |
+| `search_tiktok_products` | Search TikTok Shop products by sales, GMV, trends |
+| `get_tiktok_product_detail` | Get TikTok Shop product details |
+| `get_advertiser_detail` | Get advertiser/domain analytics |
+| `get_store_detail` | Get e-commerce store analytics |
+
+## Setup
+
+### Get API Key
+
+1. Sign up at [pipiads.com](https://www.pipiads.com)
+2. Purchase credits
+3. Get your API key from the dashboard
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pipiads": {
+      "command": "npx",
+      "args": ["-y", "pipiads-mcp-server"],
+      "env": {
+        "PIPIADS_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add pipiads -- npx -y pipiads-mcp-server
+```
+
+Then set the environment variable:
+```bash
+export PIPIADS_API_KEY="your-api-key-here"
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `PIPIADS_API_KEY` | Yes | Your PipiAds API key |
+| `PIPIADS_BASE_URL` | No | API base URL (default: `https://www.pipispy.com`) |
+
+## Usage Examples
+
+Once configured, just talk to Claude naturally:
+
+- "Search for trending TikTok ads about phone cases in the US"
+- "Find Shopify products with over 100k ad views in the last 30 days"
+- "Get details for ad video ID 1795208137186337"
+- "Show me TikTok Shop products with rising sales trends in beauty category"
+- "Look up the store detail for store ID c2d5b2547218a"
+
+## Credits
+
+Each API call consumes credits from your PipiAds account:
+- **List/Search**: 1 credit per result returned
+- **Detail**: 1 credit per request (free if the same ID was queried within 3 days)
+
+## Development
+
+```bash
+git clone <repo-url>
+cd pipiads-mcp-server
+npm install
+npm run build
+```
+
+Test with MCP Inspector:
+```bash
+PIPIADS_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+export interface ApiResponse {
+    code: number;
+    message: string;
+    data: unknown;
+    version?: string;
+    success: boolean;
+    fail: boolean;
+}
+export declare function callPipiAdsApi(uri: string, params: Record<string, unknown>): Promise<ApiResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,WAAW,CAAC,CAoCtB"}

package/dist/client.js

@@ -0,0 +1,30 @@
+const API_BASE_URL = process.env.PIPIADS_BASE_URL || "https://www.pipispy.com";
+const API_KEY = process.env.PIPIADS_API_KEY || "";
+export async function callPipiAdsApi(uri, params) {
+    if (!API_KEY) {
+        throw new Error("PIPIADS_API_KEY environment variable is required. " +
+            "Get your API key from https://www.pipiads.com");
+    }
+    const url = `${API_BASE_URL}/open-api/v1/data`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        },
+        body: JSON.stringify({
+            key: API_KEY,
+            uri,
+            params,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const result = (await response.json());
+    if (result.code !== 200) {
+        throw new Error(`API Error ${result.code}: ${result.message || "Unknown error"}`);
+    }
+    return result;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;AAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;AAWlD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,MAA+B;IAE/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oDAAoD;YAClD,+CAA+C,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,YAAY,mBAAmB,CAAC;IAE/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,GAAG,EAAE,OAAO;YACZ,GAAG;YACH,MAAM;SACP,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;IAEtD,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,aAAa,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,IAAI,eAAe,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { searchAdsSchema, searchAds, getAdDetailSchema, getAdDetail, } from "./tools/ads.js";
+import { searchProductsSchema, searchProducts, getProductDetailSchema, getProductDetail, } from "./tools/products.js";
+import { searchTiktokProductsSchema, searchTiktokProducts, getTiktokProductDetailSchema, getTiktokProductDetail, } from "./tools/tiktok.js";
+import { getAdvertiserDetailSchema, getAdvertiserDetail, getStoreDetailSchema, getStoreDetail, } from "./tools/stores.js";
+const server = new McpServer({
+    name: "pipiads",
+    version: "1.0.0",
+});
+// --- Ad Spy ---
+server.tool("search_ads", "Search advertising videos across TikTok and Facebook. Find ads by keyword, region, platform, engagement metrics, delivery days, ad spend, and more. Each result costs 1 credit.", searchAdsSchema.shape, async (params) => {
+    try {
+        const text = await searchAds(searchAdsSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool("get_ad_detail", "Get detailed information for a specific ad by its video ID. Returns ad copy, metrics, advertiser info, landing page, and more. Free if the ID was queried within the past 3 days, otherwise costs 1 credit.", getAdDetailSchema.shape, async (params) => {
+    try {
+        const text = await getAdDetail(getAdDetailSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+// --- Ad Products ---
+server.tool("search_products", "Search e-commerce products advertised on TikTok and Facebook. Filter by keyword, price, category, region, ad metrics, delivery days. Each result costs 1 credit.", searchProductsSchema.shape, async (params) => {
+    try {
+        const text = await searchProducts(searchProductsSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool("get_product_detail", "Get detailed information for a specific advertised product. Returns images, price, landing page, ad stats, category, Shopify data, and more. Free if queried within 3 days, otherwise 1 credit.", getProductDetailSchema.shape, async (params) => {
+    try {
+        const text = await getProductDetail(getProductDetailSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+// --- TikTok Shop ---
+server.tool("search_tiktok_products", "Search TikTok Shop products. Filter by keyword, category, region, sales volume, GMV, price, influencer count, ad metrics, and sales trend. Requires sort, sort_type, and time parameters. Each result costs 1 credit.", searchTiktokProductsSchema.shape, async (params) => {
+    try {
+        const text = await searchTiktokProducts(searchTiktokProductsSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool("get_tiktok_product_detail", "Get detailed info for a TikTok Shop product by ID. Returns title, images, price, sales, shop info, influencers, ad videos, and more. Free if queried within 3 days, otherwise 1 credit.", getTiktokProductDetailSchema.shape, async (params) => {
+    try {
+        const text = await getTiktokProductDetail(getTiktokProductDetailSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+// --- Stores & Advertisers ---
+server.tool("get_advertiser_detail", "Get detailed info for an advertiser (root path) by ID. Returns domain, ad count, product count, region distribution, platform data, and historical trends.", getAdvertiserDetailSchema.shape, async (params) => {
+    try {
+        const text = await getAdvertiserDetail(getAdvertiserDetailSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+server.tool("get_store_detail", "Get detailed info for an e-commerce store by its 13-character store ID. Returns store name, platform, product count, ad metrics, region analysis, and more.", getStoreDetailSchema.shape, async (params) => {
+    try {
+        const text = await getStoreDetail(getStoreDetailSchema.parse(params));
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+    }
+});
+// --- Start Server ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/ads.d.ts

@@ -0,0 +1,129 @@
+import { z } from "zod";
+export declare const searchAdsSchema: z.ZodObject<{
+    current_page: z.ZodDefault<z.ZodNumber>;
+    page_size: z.ZodDefault<z.ZodNumber>;
+    plat_type: z.ZodOptional<z.ZodNumber>;
+    extend_keywords: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodNumber;
+        keyword: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: number;
+        keyword: string;
+    }, {
+        type: number;
+        keyword: string;
+    }>, "many">>;
+    search_type: z.ZodOptional<z.ZodNumber>;
+    region: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sort: z.ZodOptional<z.ZodNumber>;
+    sort_type: z.ZodOptional<z.ZodString>;
+    play_count_min: z.ZodOptional<z.ZodNumber>;
+    play_count_max: z.ZodOptional<z.ZodNumber>;
+    digg_count_min: z.ZodOptional<z.ZodNumber>;
+    digg_count_max: z.ZodOptional<z.ZodNumber>;
+    put_day_min: z.ZodOptional<z.ZodNumber>;
+    put_day_max: z.ZodOptional<z.ZodNumber>;
+    create_time_start: z.ZodOptional<z.ZodNumber>;
+    create_time_end: z.ZodOptional<z.ZodNumber>;
+    first_time_start: z.ZodOptional<z.ZodNumber>;
+    first_time_end: z.ZodOptional<z.ZodNumber>;
+    last_time_start: z.ZodOptional<z.ZodNumber>;
+    last_time_end: z.ZodOptional<z.ZodNumber>;
+    data_type: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    is_product: z.ZodOptional<z.ZodBoolean>;
+    is_app: z.ZodOptional<z.ZodBoolean>;
+    is_url: z.ZodOptional<z.ZodNumber>;
+    shop_type: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ad_cost_min: z.ZodOptional<z.ZodNumber>;
+    ad_cost_max: z.ZodOptional<z.ZodNumber>;
+    comment_count_min: z.ZodOptional<z.ZodNumber>;
+    comment_count_max: z.ZodOptional<z.ZodNumber>;
+    share_count_min: z.ZodOptional<z.ZodNumber>;
+    share_count_max: z.ZodOptional<z.ZodNumber>;
+    ad_language: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    formate_type: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    current_page: number;
+    page_size: number;
+    plat_type?: number | undefined;
+    sort?: number | undefined;
+    extend_keywords?: {
+        type: number;
+        keyword: string;
+    }[] | undefined;
+    search_type?: number | undefined;
+    region?: string[] | undefined;
+    sort_type?: string | undefined;
+    play_count_min?: number | undefined;
+    play_count_max?: number | undefined;
+    digg_count_min?: number | undefined;
+    digg_count_max?: number | undefined;
+    put_day_min?: number | undefined;
+    put_day_max?: number | undefined;
+    create_time_start?: number | undefined;
+    create_time_end?: number | undefined;
+    first_time_start?: number | undefined;
+    first_time_end?: number | undefined;
+    last_time_start?: number | undefined;
+    last_time_end?: number | undefined;
+    data_type?: number[] | undefined;
+    is_product?: boolean | undefined;
+    is_app?: boolean | undefined;
+    is_url?: number | undefined;
+    shop_type?: string[] | undefined;
+    ad_cost_min?: number | undefined;
+    ad_cost_max?: number | undefined;
+    comment_count_min?: number | undefined;
+    comment_count_max?: number | undefined;
+    share_count_min?: number | undefined;
+    share_count_max?: number | undefined;
+    ad_language?: string[] | undefined;
+    formate_type?: number[] | undefined;
+}, {
+    current_page?: number | undefined;
+    page_size?: number | undefined;
+    plat_type?: number | undefined;
+    sort?: number | undefined;
+    extend_keywords?: {
+        type: number;
+        keyword: string;
+    }[] | undefined;
+    search_type?: number | undefined;
+    region?: string[] | undefined;
+    sort_type?: string | undefined;
+    play_count_min?: number | undefined;
+    play_count_max?: number | undefined;
+    digg_count_min?: number | undefined;
+    digg_count_max?: number | undefined;
+    put_day_min?: number | undefined;
+    put_day_max?: number | undefined;
+    create_time_start?: number | undefined;
+    create_time_end?: number | undefined;
+    first_time_start?: number | undefined;
+    first_time_end?: number | undefined;
+    last_time_start?: number | undefined;
+    last_time_end?: number | undefined;
+    data_type?: number[] | undefined;
+    is_product?: boolean | undefined;
+    is_app?: boolean | undefined;
+    is_url?: number | undefined;
+    shop_type?: string[] | undefined;
+    ad_cost_min?: number | undefined;
+    ad_cost_max?: number | undefined;
+    comment_count_min?: number | undefined;
+    comment_count_max?: number | undefined;
+    share_count_min?: number | undefined;
+    share_count_max?: number | undefined;
+    ad_language?: string[] | undefined;
+    formate_type?: number[] | undefined;
+}>;
+export declare function searchAds(params: z.infer<typeof searchAdsSchema>): Promise<string>;
+export declare const getAdDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare function getAdDetail(params: z.infer<typeof getAdDetailSchema>): Promise<string>;
+//# sourceMappingURL=ads.d.ts.map

package/dist/tools/ads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/tools/ads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiH1B,CAAC;AAEH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/tools/ads.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { callPipiAdsApi } from "../client.js";
+export const searchAdsSchema = z.object({
+    current_page: z
+        .number()
+        .int()
+        .min(1)
+        .default(1)
+        .describe("Page number, starting from 1"),
+    page_size: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe("Results per page, max 50"),
+    plat_type: z
+        .number()
+        .optional()
+        .describe("Platform: 1=TikTok, 2=Facebook. Omit for all platforms"),
+    extend_keywords: z
+        .array(z.object({
+        type: z
+            .number()
+            .describe("Search type: 1=Ad keyword, 2=Ad copy, 3=Advertiser, 4=Landing page URL, 5=E-commerce product, 6=TikTok Shop store, 7=APP name, 8=APP developer, 9=Social media account, 10=Creative material, 11=E-commerce store/URL, 12=TikTok Shop product"),
+        keyword: z.string().describe("Search keyword"),
+    }))
+        .optional()
+        .describe("Keyword search list. Each item has a type and keyword"),
+    search_type: z
+        .number()
+        .optional()
+        .describe("Search type for simple keyword: 1=Ad keyword(default), 2=Ad copy, 3=Advertiser, 4=Landing page URL, 5=E-commerce product, 6=TikTok Shop store, 7=APP name"),
+    region: z
+        .array(z.string())
+        .optional()
+        .describe('Country/region codes, e.g. ["US","GB","DE"]'),
+    sort: z
+        .number()
+        .optional()
+        .describe("Sort by: 1=Last found time, 2=Create time(default), 3=First found time, 4=Ad plays, 5=Delivery days, 6=Engagement, 7=Like rate, 9=Like count, 21=Ad spend"),
+    sort_type: z
+        .string()
+        .optional()
+        .describe('Sort order: "desc"(default) or "asc"'),
+    play_count_min: z.number().optional().describe("Minimum play/view count"),
+    play_count_max: z.number().optional().describe("Maximum play/view count"),
+    digg_count_min: z.number().optional().describe("Minimum like count"),
+    digg_count_max: z.number().optional().describe("Maximum like count"),
+    put_day_min: z.number().optional().describe("Minimum delivery days"),
+    put_day_max: z.number().optional().describe("Maximum delivery days"),
+    create_time_start: z
+        .number()
+        .optional()
+        .describe("Creation time range start (unix timestamp in seconds)"),
+    create_time_end: z
+        .number()
+        .optional()
+        .describe("Creation time range end (unix timestamp in seconds)"),
+    first_time_start: z
+        .number()
+        .optional()
+        .describe("First found time start (unix timestamp)"),
+    first_time_end: z
+        .number()
+        .optional()
+        .describe("First found time end (unix timestamp)"),
+    last_time_start: z
+        .number()
+        .optional()
+        .describe("Last found time start (unix timestamp)"),
+    last_time_end: z
+        .number()
+        .optional()
+        .describe("Last found time end (unix timestamp)"),
+    data_type: z
+        .array(z.number())
+        .optional()
+        .describe("Data type filter: 1=Hot Product, 2=Mini Shop Ad, 3=E-commerce, 4=Spark Ads, 5=Game, 6=App, 7=AI, 8=Short Drama"),
+    is_product: z.boolean().optional().describe("Filter: has ad product"),
+    is_app: z.boolean().optional().describe("Filter: has APP product"),
+    is_url: z
+        .number()
+        .optional()
+        .describe("URL status: 0=No landing page, 1=Has landing page"),
+    shop_type: z
+        .array(z.string())
+        .optional()
+        .describe('E-commerce platform filter, e.g. ["shopify","woocommerce","magento","wix","shoplazza","shopline","squarespace","shopyy"]'),
+    ad_cost_min: z.number().optional().describe("Minimum ad spend (USD)"),
+    ad_cost_max: z.number().optional().describe("Maximum ad spend (USD)"),
+    comment_count_min: z.number().optional().describe("Minimum comment count"),
+    comment_count_max: z.number().optional().describe("Maximum comment count"),
+    share_count_min: z.number().optional().describe("Minimum share count"),
+    share_count_max: z.number().optional().describe("Maximum share count"),
+    ad_language: z
+        .array(z.string())
+        .optional()
+        .describe('Ad language filter, e.g. ["en","zh"]'),
+    formate_type: z
+        .array(z.number())
+        .optional()
+        .describe("Ad format: 1=Video, 2=Image, 3=Carousel"),
+});
+export async function searchAds(params) {
+    const result = await callPipiAdsApi("/v3/api/open/adspy/list", params);
+    return JSON.stringify(result.data, null, 2);
+}
+export const getAdDetailSchema = z.object({
+    id: z.string().describe("Ad video ID (video_id from search results)"),
+});
+export async function getAdDetail(params) {
+    const result = await callPipiAdsApi("/v3/api/open/adspy/detail", params);
+    return JSON.stringify(result.data, null, 2);
+}
+//# sourceMappingURL=ads.js.map

package/dist/tools/ads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ads.js","sourceRoot":"","sources":["../../src/tools/ads.ts"],"names":[],"mappings":"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"}

package/dist/tools/products.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export declare const searchProductsSchema: z.ZodObject<{
+    current_page: z.ZodDefault<z.ZodNumber>;
+    page_size: z.ZodDefault<z.ZodNumber>;
+    plat_type: z.ZodOptional<z.ZodNumber>;
+    keyword: z.ZodOptional<z.ZodString>;
+    search_type: z.ZodOptional<z.ZodNumber>;
+    category: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    play_count_min: z.ZodOptional<z.ZodNumber>;
+    play_count_max: z.ZodOptional<z.ZodNumber>;
+    digg_count_min: z.ZodOptional<z.ZodNumber>;
+    digg_count_max: z.ZodOptional<z.ZodNumber>;
+    video_count_min: z.ZodOptional<z.ZodNumber>;
+    video_count_max: z.ZodOptional<z.ZodNumber>;
+    put_day_min: z.ZodOptional<z.ZodNumber>;
+    put_day_max: z.ZodOptional<z.ZodNumber>;
+    price_min: z.ZodOptional<z.ZodNumber>;
+    price_max: z.ZodOptional<z.ZodNumber>;
+    create_time_start: z.ZodOptional<z.ZodNumber>;
+    create_time_end: z.ZodOptional<z.ZodNumber>;
+    tiktok_time_start: z.ZodOptional<z.ZodNumber>;
+    tiktok_time_end: z.ZodOptional<z.ZodNumber>;
+    latest_found_time_start: z.ZodOptional<z.ZodNumber>;
+    latest_found_time_end: z.ZodOptional<z.ZodNumber>;
+    platform: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    sort_type: z.ZodOptional<z.ZodString>;
+    store_id: z.ZodOptional<z.ZodString>;
+    time: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    current_page: number;
+    page_size: number;
+    plat_type?: number | undefined;
+    sort?: string | undefined;
+    keyword?: string | undefined;
+    search_type?: number | undefined;
+    region?: string | undefined;
+    sort_type?: string | undefined;
+    play_count_min?: number | undefined;
+    play_count_max?: number | undefined;
+    digg_count_min?: number | undefined;
+    digg_count_max?: number | undefined;
+    put_day_min?: number | undefined;
+    put_day_max?: number | undefined;
+    create_time_start?: number | undefined;
+    create_time_end?: number | undefined;
+    category?: string | undefined;
+    video_count_min?: number | undefined;
+    video_count_max?: number | undefined;
+    price_min?: number | undefined;
+    price_max?: number | undefined;
+    tiktok_time_start?: number | undefined;
+    tiktok_time_end?: number | undefined;
+    latest_found_time_start?: number | undefined;
+    latest_found_time_end?: number | undefined;
+    platform?: string | undefined;
+    currency?: string | undefined;
+    store_id?: string | undefined;
+    time?: number | undefined;
+}, {
+    current_page?: number | undefined;
+    page_size?: number | undefined;
+    plat_type?: number | undefined;
+    sort?: string | undefined;
+    keyword?: string | undefined;
+    search_type?: number | undefined;
+    region?: string | undefined;
+    sort_type?: string | undefined;
+    play_count_min?: number | undefined;
+    play_count_max?: number | undefined;
+    digg_count_min?: number | undefined;
+    digg_count_max?: number | undefined;
+    put_day_min?: number | undefined;
+    put_day_max?: number | undefined;
+    create_time_start?: number | undefined;
+    create_time_end?: number | undefined;
+    category?: string | undefined;
+    video_count_min?: number | undefined;
+    video_count_max?: number | undefined;
+    price_min?: number | undefined;
+    price_max?: number | undefined;
+    tiktok_time_start?: number | undefined;
+    tiktok_time_end?: number | undefined;
+    latest_found_time_start?: number | undefined;
+    latest_found_time_end?: number | undefined;
+    platform?: string | undefined;
+    currency?: string | undefined;
+    store_id?: string | undefined;
+    time?: number | undefined;
+}>;
+export declare function searchProducts(params: z.infer<typeof searchProductsSchema>): Promise<string>;
+export declare const getProductDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare function getProductDetail(params: z.infer<typeof getProductDetailSchema>): Promise<string>;
+//# sourceMappingURL=products.d.ts.map

package/dist/tools/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8F/B,CAAC;AAEH,wBAAsB,cAAc,CAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC7C,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/tools/products.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { callPipiAdsApi } from "../client.js";
+export const searchProductsSchema = z.object({
+    current_page: z
+        .number()
+        .int()
+        .min(1)
+        .default(1)
+        .describe("Page number, starting from 1"),
+    page_size: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe("Results per page, max 50"),
+    plat_type: z
+        .number()
+        .optional()
+        .describe("Platform: 0=All, 1=TikTok, 2=Facebook"),
+    keyword: z.string().optional().describe("Search keyword for product title"),
+    search_type: z
+        .number()
+        .optional()
+        .describe("Search type: 1=Product title, 2=Product description, 3=Advertiser URL, 4=Advertiser name, 5=Product keyword"),
+    category: z
+        .string()
+        .optional()
+        .describe("Product category, multiple separated by commas"),
+    region: z
+        .string()
+        .optional()
+        .describe('Country/region, multiple separated by commas, e.g. "US,GB"'),
+    play_count_min: z.number().optional().describe("Minimum ad play count"),
+    play_count_max: z.number().optional().describe("Maximum ad play count"),
+    digg_count_min: z.number().optional().describe("Minimum like count"),
+    digg_count_max: z.number().optional().describe("Maximum like count"),
+    video_count_min: z.number().optional().describe("Minimum ad count"),
+    video_count_max: z.number().optional().describe("Maximum ad count"),
+    put_day_min: z.number().optional().describe("Minimum delivery days"),
+    put_day_max: z.number().optional().describe("Maximum delivery days"),
+    price_min: z.number().optional().describe("Minimum product price (USD)"),
+    price_max: z.number().optional().describe("Maximum product price (USD)"),
+    create_time_start: z
+        .number()
+        .optional()
+        .describe("Product creation time start (unix timestamp)"),
+    create_time_end: z
+        .number()
+        .optional()
+        .describe("Product creation time end (unix timestamp)"),
+    tiktok_time_start: z
+        .number()
+        .optional()
+        .describe("Ad start date / first found time start (unix timestamp)"),
+    tiktok_time_end: z
+        .number()
+        .optional()
+        .describe("Ad start date / first found time end (unix timestamp)"),
+    latest_found_time_start: z
+        .number()
+        .optional()
+        .describe("Ad end date / last found time start (unix timestamp)"),
+    latest_found_time_end: z
+        .number()
+        .optional()
+        .describe("Ad end date / last found time end (unix timestamp)"),
+    platform: z
+        .string()
+        .optional()
+        .describe('E-commerce platform, comma-separated: "shopify,woocommerce,shoplazza,magento,wix,shopline,squarespace,shopyy"'),
+    currency: z
+        .string()
+        .optional()
+        .describe('Currency filter, comma-separated, e.g. "USD,EUR"'),
+    sort: z
+        .string()
+        .optional()
+        .describe("Sort field: 0=Start Date, 1=End Date, 2=Product Creation Date, 3=Price(USD), 4=Number of ads, 5=Impressions, 6=Likes, 7=Durations"),
+    sort_type: z.string().optional().describe('Sort order: "desc" or "asc"'),
+    store_id: z
+        .string()
+        .optional()
+        .describe("Store ID (13-char string) to filter products from a store"),
+    time: z
+        .number()
+        .optional()
+        .describe("Time range shortcut: 1=yesterday, 7=last 7 days, 30=last 30 days, 90=last 90 days"),
+});
+export async function searchProducts(params) {
+    const result = await callPipiAdsApi("/v3/api/open/ad-product/list", params);
+    return JSON.stringify(result.data, null, 2);
+}
+export const getProductDetailSchema = z.object({
+    id: z.string().describe("Product ID from search results"),
+});
+export async function getProductDetail(params) {
+    const result = await callPipiAdsApi("/v3/api/open/ad-product/detail", params);
+    return JSON.stringify(result.data, null, 2);
+}
+//# sourceMappingURL=products.js.map

package/dist/tools/products.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,0BAA0B,CAAC;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC3E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6GAA6G,CAC9G;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACvE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACvE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACpE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACpE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACnE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACxE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACxE,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;IACpE,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,qBAAqB,EAAE,CAAC;SACrB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+GAA+G,CAChH;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mIAAmI,CACpI;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACxE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IACxE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4C;IAE5C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8C;IAE9C,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,gCAAgC,EAChC,MAAM,CACP,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/tools/stores.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export declare const getAdvertiserDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare function getAdvertiserDetail(params: z.infer<typeof getAdvertiserDetailSchema>): Promise<string>;
+export declare const getStoreDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare function getStoreDetail(params: z.infer<typeof getStoreDetailSchema>): Promise<string>;
+//# sourceMappingURL=stores.d.ts.map

package/dist/tools/stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../src/tools/stores.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAChD,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAC;AAEH,wBAAsB,cAAc,CAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/tools/stores.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { callPipiAdsApi } from "../client.js";
+export const getAdvertiserDetailSchema = z.object({
+    id: z.string().describe("Advertiser unique identifier ID"),
+});
+export async function getAdvertiserDetail(params) {
+    const result = await callPipiAdsApi("/v3/api/open/advertiser/detail", params);
+    return JSON.stringify(result.data, null, 2);
+}
+export const getStoreDetailSchema = z.object({
+    id: z
+        .string()
+        .describe("Store ID - a 13-character string (e.g. c2d5b2547218a), from store_id field in store ranking results"),
+});
+export async function getStoreDetail(params) {
+    const result = await callPipiAdsApi("/v3/api/open/store/detail", params);
+    return JSON.stringify(result.data, null, 2);
+}
+//# sourceMappingURL=stores.js.map

package/dist/tools/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/tools/stores.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiD;IAEjD,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,gCAAgC,EAChC,MAAM,CACP,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,QAAQ,CACP,qGAAqG,CACtG;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4C;IAE5C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/tools/tiktok.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+export declare const searchTiktokProductsSchema: z.ZodObject<{
+    current_page: z.ZodDefault<z.ZodNumber>;
+    page_size: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodNumber;
+    sort_type: z.ZodString;
+    time: z.ZodNumber;
+    keyword: z.ZodOptional<z.ZodString>;
+    search_type: z.ZodOptional<z.ZodString>;
+    categorize: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    delivery: z.ZodOptional<z.ZodString>;
+    is_managed: z.ZodOptional<z.ZodBoolean>;
+    is_in_marketplace: z.ZodOptional<z.ZodBoolean>;
+    sales_volume_min: z.ZodOptional<z.ZodNumber>;
+    sales_volume_max: z.ZodOptional<z.ZodNumber>;
+    gmv_min: z.ZodOptional<z.ZodNumber>;
+    gmv_max: z.ZodOptional<z.ZodNumber>;
+    price_usd_min: z.ZodOptional<z.ZodNumber>;
+    price_usd_max: z.ZodOptional<z.ZodNumber>;
+    play_count_min: z.ZodOptional<z.ZodNumber>;
+    play_count_max: z.ZodOptional<z.ZodNumber>;
+    commission_rate_min: z.ZodOptional<z.ZodNumber>;
+    commission_rate_max: z.ZodOptional<z.ZodNumber>;
+    person_count_min: z.ZodOptional<z.ZodNumber>;
+    person_count_max: z.ZodOptional<z.ZodNumber>;
+    video_count_min: z.ZodOptional<z.ZodNumber>;
+    video_count_max: z.ZodOptional<z.ZodNumber>;
+    sales_trend: z.ZodOptional<z.ZodNumber>;
+    shop_id: z.ZodOptional<z.ZodString>;
+    found_time_start: z.ZodOptional<z.ZodNumber>;
+    found_time_end: z.ZodOptional<z.ZodNumber>;
+    last_found_time_start: z.ZodOptional<z.ZodNumber>;
+    last_found_time_end: z.ZodOptional<z.ZodNumber>;
+    cpm_min: z.ZodOptional<z.ZodNumber>;
+    cpm_max: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    current_page: number;
+    page_size: number;
+    sort: number;
+    sort_type: string;
+    time: number;
+    keyword?: string | undefined;
+    search_type?: string | undefined;
+    region?: string | undefined;
+    play_count_min?: number | undefined;
+    play_count_max?: number | undefined;
+    video_count_min?: number | undefined;
+    video_count_max?: number | undefined;
+    categorize?: string | undefined;
+    delivery?: string | undefined;
+    is_managed?: boolean | undefined;
+    is_in_marketplace?: boolean | undefined;
+    sales_volume_min?: number | undefined;
+    sales_volume_max?: number | undefined;
+    gmv_min?: number | undefined;
+    gmv_max?: number | undefined;
+    price_usd_min?: number | undefined;
+    price_usd_max?: number | undefined;
+    commission_rate_min?: number | undefined;
+    commission_rate_max?: number | undefined;
+    person_count_min?: number | undefined;
+    person_count_max?: number | undefined;
+    sales_trend?: number | undefined;
+    shop_id?: string | undefined;
+    found_time_start?: number | undefined;
+    found_time_end?: number | undefined;
+    last_found_time_start?: number | undefined;
+    last_found_time_end?: number | undefined;
+    cpm_min?: number | undefined;
+    cpm_max?: number | undefined;
+}, {
+    sort: number;
+    sort_type: string;
+    time: number;
+    current_page?: number | undefined;
+    page_size?: number | undefined;
+    keyword?: string | undefined;
+    search_type?: string | undefined;
+    region?: string | undefined;
+    play_count_min?: number | undefined;
+    play_count_max?: number | undefined;
+    video_count_min?: number | undefined;
+    video_count_max?: number | undefined;
+    categorize?: string | undefined;
+    delivery?: string | undefined;
+    is_managed?: boolean | undefined;
+    is_in_marketplace?: boolean | undefined;
+    sales_volume_min?: number | undefined;
+    sales_volume_max?: number | undefined;
+    gmv_min?: number | undefined;
+    gmv_max?: number | undefined;
+    price_usd_min?: number | undefined;
+    price_usd_max?: number | undefined;
+    commission_rate_min?: number | undefined;
+    commission_rate_max?: number | undefined;
+    person_count_min?: number | undefined;
+    person_count_max?: number | undefined;
+    sales_trend?: number | undefined;
+    shop_id?: string | undefined;
+    found_time_start?: number | undefined;
+    found_time_end?: number | undefined;
+    last_found_time_start?: number | undefined;
+    last_found_time_end?: number | undefined;
+    cpm_min?: number | undefined;
+    cpm_max?: number | undefined;
+}>;
+export declare function searchTiktokProducts(params: z.infer<typeof searchTiktokProductsSchema>): Promise<string>;
+export declare const getTiktokProductDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare function getTiktokProductDetail(params: z.infer<typeof getTiktokProductDetailSchema>): Promise<string>;
+//# sourceMappingURL=tiktok.d.ts.map

package/dist/tools/tiktok.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok.d.ts","sourceRoot":"","sources":["../../src/tools/tiktok.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0GrC,CAAC;AAEH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GACjD,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,eAAO,MAAM,4BAA4B;;;;;;EAEvC,CAAC;AAEH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/tools/tiktok.js

@@ -0,0 +1,115 @@
+import { z } from "zod";
+import { callPipiAdsApi } from "../client.js";
+export const searchTiktokProductsSchema = z.object({
+    current_page: z
+        .number()
+        .int()
+        .min(1)
+        .default(1)
+        .describe("Page number, starting from 1"),
+    page_size: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe("Results per page, max 50"),
+    sort: z
+        .number()
+        .describe("Sort field (required): 1=Last time, 2=First time, 3=Sold, 4=GMV, 5=Impressions, 6=Ad Spend, 7=Ads, 8=Influencers"),
+    sort_type: z
+        .string()
+        .describe('Sort order (required): "asc" or "desc"'),
+    time: z
+        .number()
+        .describe("Time range (required): 0=All, 1=Yesterday, 30=Last 30 days, 90=Last 90 days"),
+    keyword: z.string().optional().describe("Search keyword for product title"),
+    search_type: z
+        .string()
+        .optional()
+        .describe("Search type: 1=Product name/description(default), 2=Store name, 3=Influencer name"),
+    categorize: z
+        .string()
+        .optional()
+        .describe("Category filter, multiple separated by commas"),
+    region: z
+        .string()
+        .optional()
+        .describe('Country/region, comma-separated, e.g. "US,GB"'),
+    delivery: z
+        .string()
+        .optional()
+        .describe('Delivery method: "overseas"=Cross-border, "local"=Local'),
+    is_managed: z
+        .boolean()
+        .optional()
+        .describe("Filter fully managed products"),
+    is_in_marketplace: z
+        .boolean()
+        .optional()
+        .describe("Filter marketplace products"),
+    sales_volume_min: z.number().optional().describe("Minimum sales volume"),
+    sales_volume_max: z.number().optional().describe("Maximum sales volume"),
+    gmv_min: z.number().optional().describe("Minimum GMV"),
+    gmv_max: z.number().optional().describe("Maximum GMV"),
+    price_usd_min: z.number().optional().describe("Minimum price in USD"),
+    price_usd_max: z.number().optional().describe("Maximum price in USD"),
+    play_count_min: z.number().optional().describe("Minimum ad impressions"),
+    play_count_max: z.number().optional().describe("Maximum ad impressions"),
+    commission_rate_min: z
+        .number()
+        .optional()
+        .describe("Minimum commission rate"),
+    commission_rate_max: z
+        .number()
+        .optional()
+        .describe("Maximum commission rate"),
+    person_count_min: z
+        .number()
+        .optional()
+        .describe("Minimum influencer count"),
+    person_count_max: z
+        .number()
+        .optional()
+        .describe("Maximum influencer count"),
+    video_count_min: z.number().optional().describe("Minimum ad count"),
+    video_count_max: z.number().optional().describe("Maximum ad count"),
+    sales_trend: z
+        .number()
+        .optional()
+        .describe("Sales trend: 1=Increase, 0=Stable, -1=Decrease"),
+    shop_id: z
+        .string()
+        .optional()
+        .describe("Filter products from a specific shop"),
+    found_time_start: z
+        .number()
+        .optional()
+        .describe("First ad date start (unix timestamp)"),
+    found_time_end: z
+        .number()
+        .optional()
+        .describe("First ad date end (unix timestamp)"),
+    last_found_time_start: z
+        .number()
+        .optional()
+        .describe("Last ad date start (unix timestamp)"),
+    last_found_time_end: z
+        .number()
+        .optional()
+        .describe("Last ad date end (unix timestamp)"),
+    cpm_min: z.number().optional().describe("Minimum ad spend (CPM)"),
+    cpm_max: z.number().optional().describe("Maximum ad spend (CPM)"),
+});
+export async function searchTiktokProducts(params) {
+    const result = await callPipiAdsApi("/v3/api/open/tiktok-shop/product/list", params);
+    return JSON.stringify(result.data, null, 2);
+}
+export const getTiktokProductDetailSchema = z.object({
+    id: z.string().describe("TikTok shop product ID"),
+});
+export async function getTiktokProductDetail(params) {
+    const result = await callPipiAdsApi("/v3/api/open/tiktok-shop/product/detail", params);
+    return JSON.stringify(result.data, null, 2);
+}
+//# sourceMappingURL=tiktok.js.map

package/dist/tools/tiktok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok.js","sourceRoot":"","sources":["../../src/tools/tiktok.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "pipiads-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for PipiAds advertising intelligence API",
+  "type": "module",
+  "bin": {
+    "pipiads-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "pipiads",
+    "advertising",
+    "tiktok",
+    "facebook",
+    "adspy"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}