@bintangtimurlangit/shopee-mcp 0.1.0

package/build/browser/session.js.map

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

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerSearchTools } from './tools/search.js';
+import { registerProductTools } from './tools/product.js';
+import { closeContext } from './browser/session.js';
+async function main() {
+    const server = new McpServer({
+        name: 'shopee-mcp',
+        version: '0.1.0',
+    });
+    // Register tool groups. Every tool runs through the shared, logged-in browser
+    // session (see src/browser/session.ts) — sign in once with `npm run login`.
+    registerSearchTools(server);
+    registerProductTools(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    if (process.env.DEBUG === 'true') {
+        process.stderr.write('[shopee-mcp] Server started via stdio (browser-backed discovery)\n');
+    }
+}
+// Tidy up the browser on shutdown.
+for (const sig of ['SIGINT', 'SIGTERM']) {
+    process.on(sig, () => {
+        void closeContext().finally(() => process.exit(0));
+    });
+}
+main().catch((err) => {
+    process.stderr.write(`[shopee-mcp] Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,8EAA8E;IAC9E,4EAA4E;IAC5E,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;QACnB,KAAK,YAAY,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/login.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * One-time Shopee login.
+ *
+ * Opens a visible Chromium window bound to the persistent profile, lets you sign
+ * in by hand (password, OTP, whatever Shopee asks), then saves the session so the
+ * MCP server can reuse it. Run once; re-run only if the session expires.
+ *
+ *   npm run login        (dev)   or   shopee-mcp-login   (installed)
+ */
+import 'dotenv/config';
+//# sourceMappingURL=login.d.ts.map

package/build/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,eAAe,CAAC"}

package/build/login.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * One-time Shopee login.
+ *
+ * Opens a visible Chromium window bound to the persistent profile, lets you sign
+ * in by hand (password, OTP, whatever Shopee asks), then saves the session so the
+ * MCP server can reuse it. Run once; re-run only if the session expires.
+ *
+ *   npm run login        (dev)   or   shopee-mcp-login   (installed)
+ */
+import 'dotenv/config';
+import readline from 'node:readline';
+import { getContext, isLoggedIn, closeContext, BASE_URL, PROFILE_DIR } from './browser/session.js';
+function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => rl.question(question, () => {
+        rl.close();
+        resolve();
+    }));
+}
+async function main() {
+    console.log('\n🛒 Shopee MCP — login\n');
+    console.log(`Profile directory: ${PROFILE_DIR}`);
+    console.log('Opening a Chromium window…\n');
+    // Force a visible window regardless of SHOPEE_HEADLESS.
+    const ctx = await getContext(false);
+    const page = ctx.pages().find((p) => !p.isClosed()) ?? (await ctx.newPage());
+    await page.goto(`${BASE_URL}/buyer/login`, { waitUntil: 'domcontentloaded', timeout: 60000 });
+    if (await isLoggedIn()) {
+        console.log('✅ This profile is already logged in. Nothing to do.\n');
+        await closeContext();
+        return;
+    }
+    console.log('👉 In the Chromium window: log into your Shopee account.');
+    console.log('   Complete any OTP / captcha Shopee shows.');
+    await prompt('\nWhen you see your account is logged in, press Enter here to save… ');
+    const ok = await isLoggedIn();
+    if (ok) {
+        console.log('\n✅ Login detected and saved. You can close this and start the MCP server.\n');
+    }
+    else {
+        console.log('\n⚠️  Could not detect a logged-in session (no SPC_U/SPC_EC cookie).\n' +
+            '   If you did log in, the session is still saved to the profile — try the server anyway.\n' +
+            '   Otherwise re-run `npm run login`.\n');
+    }
+    await closeContext();
+}
+main().catch(async (err) => {
+    console.error('Login failed:', err);
+    await closeContext().catch(() => { });
+    process.exit(1);
+});
+//# sourceMappingURL=login.js.map

package/build/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,eAAe,CAAC;AACvB,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnG,SAAS,MAAM,CAAC,QAAgB;IAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7B,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAE5C,wDAAwD;IACxD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAE7E,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,cAAc,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9F,IAAI,MAAM,UAAU,EAAE,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,MAAM,YAAY,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC3D,MAAM,MAAM,CAAC,sEAAsE,CAAC,CAAC;IAErF,MAAM,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC;IAC9B,IAAI,EAAE,EAAE,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,8EAA8E,CAAC,CAAC;IAC9F,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,wEAAwE;YACtE,4FAA4F;YAC5F,wCAAwC,CAC3C,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACzB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/tools/product.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProductTools(server: McpServer): void;
+//# sourceMappingURL=product.d.ts.map

package/build/tools/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/tools/product.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgCpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoH5D"}

package/build/tools/product.js

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+import { shopeeCapture, shopeeUrl } from '../api/client.js';
+import { BASE_URL } from '../browser/session.js';
+import { cache } from '../utils/cache.js';
+import { withErrorHandling, truncate } from '../utils/errors.js';
+// Shopee stores prices as the real amount × 100000.
+function fmt(raw, currency = 'IDR') {
+    const amount = raw / 100000;
+    if (currency === 'IDR')
+        return `Rp${Math.round(amount).toLocaleString('id-ID')}`;
+    return `${currency} ${amount.toLocaleString('id-ID')}`;
+}
+function priceText(p, currency) {
+    if (p.range_min >= 0 && p.range_max >= 0 && p.range_min !== p.range_max) {
+        return `${fmt(p.range_min, currency)} – ${fmt(p.range_max, currency)}`;
+    }
+    return fmt(p.single_value, currency);
+}
+/** Parse "shopId/itemId" out of a Shopee product URL, if present. */
+function parseProductUrl(url) {
+    // /product/<shopid>/<itemid>  OR  ...-i.<shopid>.<itemid>
+    const m1 = url.match(/\/product\/(\d+)\/(\d+)/);
+    if (m1)
+        return { shopId: m1[1], itemId: m1[2] };
+    const m2 = url.match(/-i\.(\d+)\.(\d+)/);
+    if (m2)
+        return { shopId: m2[1], itemId: m2[2] };
+    return null;
+}
+export function registerProductTools(server) {
+    server.tool('get_product_detail', 'Get details for a Shopee product: title, price (and discount), brand, condition, category, rating, stock, seller location, and description. ' +
+        'Provide the numeric shopId + itemId (from search_products), or a full product URL.', {
+        shopId: z
+            .string()
+            .optional()
+            .describe('Numeric shop ID (from search_products URL / results)'),
+        itemId: z.string().optional().describe('Numeric item/product ID (the 🆔 in search_products)'),
+        url: z
+            .string()
+            .url()
+            .optional()
+            .describe('Full product URL, e.g. https://shopee.co.id/product/78730497/47060432055'),
+    }, async ({ shopId, itemId, url }) => {
+        return withErrorHandling(async () => {
+            let sid = shopId;
+            let iid = itemId;
+            if ((!sid || !iid) && url) {
+                const parsed = parseProductUrl(url);
+                if (parsed) {
+                    sid = parsed.shopId;
+                    iid = parsed.itemId;
+                }
+            }
+            if (!sid || !iid) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: '❌ Please provide both `shopId` and `itemId`, or a full product `url`.',
+                        },
+                    ],
+                };
+            }
+            const cacheKey = cache.key('product', sid, iid);
+            const cached = cache.get(cacheKey);
+            if (cached)
+                return { content: [{ type: 'text', text: cached }] };
+            const pageUrl = shopeeUrl(`/product/${sid}/${iid}`);
+            const data = await shopeeCapture(pageUrl, 'pdp/get_pc');
+            const item = data.data?.item;
+            const pp = data.data?.product_price;
+            if (!item || !pp) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: '❌ Could not read product data. Check the shopId/itemId or URL.',
+                        },
+                    ],
+                };
+            }
+            const currency = item.currency || 'IDR';
+            const price = priceText(pp.price, currency);
+            const before = pp.price_before_discount && pp.price_before_discount.single_value > pp.price.single_value
+                ? pp.price_before_discount
+                : undefined;
+            const discountPct = before
+                ? Math.round((1 - pp.price.single_value / before.single_value) * 100)
+                : 0;
+            const review = data.data?.product_review;
+            const conditionLabel = item.condition === 1 ? 'New' : item.condition ? 'Used' : 'Unknown';
+            const rating = item.item_rating?.rating_star;
+            const ratingCount = review?.total_rating_count ?? review?.cmt_count ?? 0;
+            const soldText = review?.sold_count_display ??
+                review?.historical_sold_display ??
+                review?.global_sold_display;
+            const breadcrumb = (item.categories ?? []).map((c) => c.display_name).join(' › ');
+            const stock = item.stock ?? item.normal_stock ?? undefined;
+            const lines = [
+                `📦 **${item.title}**`,
+                '',
+                `💰 **Price:** ${price}${before ? ` ~~${priceText(before, currency)}~~ (-${discountPct}%)` : ''}`,
+                '',
+                `📊 **Stats:**`,
+                `  ⭐ Rating: ${rating ? rating.toFixed(2) : 'N/A'}${ratingCount ? ` (${ratingCount.toLocaleString('id-ID')} reviews)` : ''}`,
+                soldText ? `  ✅ Sold: ${soldText}` : '',
+                '',
+                `📋 **Details:**`,
+                item.brand ? `  🏷 Brand: ${item.brand}` : '',
+                `  🆕 Condition: ${conditionLabel}`,
+                breadcrumb ? `  🗂 Category: ${breadcrumb}` : '',
+                stock !== undefined && stock !== null
+                    ? `  📦 Stock: ${stock.toLocaleString('id-ID')}`
+                    : '',
+                item.is_free_shipping ? `  🚚 Free shipping` : '',
+                `  📍 Location: ${item.shop_location || 'N/A'}`,
+                `  🆔 Item ID: \`${item.item_id}\` | Shop ID: \`${item.shop_id}\``,
+            ].filter((l) => l !== '');
+            if (item.description) {
+                lines.push('', '📝 **Description:**', truncate(item.description.replace(/\n+/g, ' ').trim(), 400));
+            }
+            lines.push('', `🔗 ${BASE_URL}/product/${item.shop_id}/${item.item_id}`);
+            const text = lines.join('\n');
+            cache.set(cacheKey, text);
+            return { content: [{ type: 'text', text }] };
+        });
+    });
+}
+//# sourceMappingURL=product.js.map

package/build/tools/product.js.map

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

package/build/tools/search.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchTools(server: McpServer): void;
+//# sourceMappingURL=search.d.ts.map

package/build/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmF3D"}

package/build/tools/search.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { shopeeCapture, shopeeUrl } from '../api/client.js';
+import { BASE_URL } from '../browser/session.js';
+import { cache } from '../utils/cache.js';
+import { withErrorHandling } from '../utils/errors.js';
+// Shopee stores prices as the real amount × 100000.
+function formatPrice(raw, currency = 'IDR') {
+    const amount = raw / 100000;
+    if (currency === 'IDR')
+        return `Rp${Math.round(amount).toLocaleString('id-ID')}`;
+    return `${currency} ${amount.toLocaleString('id-ID')}`;
+}
+function priceText(b) {
+    if (b.price_min && b.price_max && b.price_min !== b.price_max) {
+        return `${formatPrice(b.price_min, b.currency)} – ${formatPrice(b.price_max, b.currency)}`;
+    }
+    return formatPrice(b.price, b.currency);
+}
+// Sort option → Shopee search-URL params.
+const SORT_MAP = {
+    relevance: { sortBy: 'relevancy' },
+    newest: { sortBy: 'ctime' },
+    top_sales: { sortBy: 'sales' },
+    price_low: { sortBy: 'price', order: 'asc' },
+    price_high: { sortBy: 'price', order: 'desc' },
+};
+export function registerSearchTools(server) {
+    server.tool('search_products', 'Search for products on Shopee by keyword, with sorting and pagination. ' +
+        'Returns product names, prices, sold counts, ratings, seller location, product IDs, and direct URLs. ' +
+        'Requires a one-time login (run `npm run login`) because Shopee blocks anonymous requests.', {
+        query: z.string().min(1).describe('The search query, e.g. "laptop gaming", "sepatu nike"'),
+        page: z.number().int().min(1).default(1).describe('Page number (default: 1)'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(60)
+            .default(20)
+            .describe('Max results to show from the page, 1-60 (default: 20)'),
+        sort: z
+            .enum(['relevance', 'newest', 'top_sales', 'price_low', 'price_high'])
+            .default('relevance')
+            .describe('Sort order (default: relevance)'),
+    }, async ({ query, page, limit, sort }) => {
+        return withErrorHandling(async () => {
+            const cacheKey = cache.key('search', query, page, limit, sort);
+            const cached = cache.get(cacheKey);
+            if (cached)
+                return { content: [{ type: 'text', text: cached }] };
+            const { sortBy, order } = SORT_MAP[sort] ?? SORT_MAP.relevance;
+            const qs = new URLSearchParams({ keyword: query, page: String(page - 1), sortBy });
+            if (order)
+                qs.set('order', order);
+            const searchUrl = shopeeUrl(`/search?${qs.toString()}`);
+            const data = await shopeeCapture(searchUrl, 'search/search_items');
+            const items = data.items ?? [];
+            if (items.length === 0) {
+                return {
+                    content: [
+                        { type: 'text', text: `No products found for "${query}". Try a different keyword.` },
+                    ],
+                };
+            }
+            const shown = items.slice(0, limit);
+            const totalCount = data.total_count ?? 0;
+            const totalPages = totalCount > 0 ? Math.ceil(totalCount / items.length) : page;
+            const lines = [
+                `🛒 Search Results for "${query}"`,
+                `📊 ${totalCount.toLocaleString('id-ID')} total products | Page ${page}${totalPages > 1 ? `/${totalPages}` : ''}`,
+                ``,
+            ];
+            shown.forEach((it, i) => {
+                const b = it.item_basic;
+                const rank = (page - 1) * limit + i + 1;
+                const rating = b.item_rating?.rating_star
+                    ? `⭐ ${b.item_rating.rating_star.toFixed(1)}`
+                    : '⭐ N/A';
+                const sold = b.historical_sold || b.sold || 0;
+                const soldText = sold > 0 ? ` | 📦 ${sold.toLocaleString('id-ID')} sold` : '';
+                const official = b.is_official_shop ? ' [Shopee Mall]' : '';
+                const url = `${BASE_URL}/product/${b.shopid}/${b.itemid}`;
+                lines.push(`${rank}. **${b.name}**`);
+                lines.push(`   💰 ${priceText(b)}`);
+                lines.push(`   ${rating}${soldText} | 🏪 ${b.shop_location || 'N/A'}${official} | 🆔 ${b.itemid}`);
+                lines.push(`   🔗 ${url}`);
+                if (i < shown.length - 1)
+                    lines.push('');
+            });
+            if (!data.nomore) {
+                lines.push(``, `📄 Use page=${page + 1} to see more results.`);
+            }
+            const text = lines.join('\n');
+            cache.set(cacheKey, text);
+            return { content: [{ type: 'text', text }] };
+        });
+    });
+}
+//# sourceMappingURL=search.js.map

package/build/tools/search.js.map

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

package/build/utils/cache.d.ts

@@ -0,0 +1,13 @@
+declare class Cache {
+    private store;
+    private ttl;
+    constructor(ttlMs?: number);
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, data: T): void;
+    key(...parts: (string | number | boolean | undefined)[]): string;
+    clear(): void;
+    size(): number;
+}
+export declare const cache: Cache;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/build/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAQA,cAAM,KAAK;IACT,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,GAAG,CAAS;gBAER,KAAK,CAAC,EAAE,MAAM;IAI1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAIlC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM;IAIhE,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGf;AAED,eAAO,MAAM,KAAK,OAAc,CAAC"}

package/build/utils/cache.js

@@ -0,0 +1,33 @@
+// Lightweight in-memory TTL cache.
+// Prevents re-issuing identical Shopee queries in a short window.
+class Cache {
+    store = new Map();
+    ttl;
+    constructor(ttlMs) {
+        this.ttl = ttlMs ?? parseInt(process.env.CACHE_TTL_MS ?? '30000', 10);
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.data;
+    }
+    set(key, data) {
+        this.store.set(key, { data, expiresAt: Date.now() + this.ttl });
+    }
+    key(...parts) {
+        return parts.map(String).join(':');
+    }
+    clear() {
+        this.store.clear();
+    }
+    size() {
+        return this.store.size;
+    }
+}
+export const cache = new Cache();
+//# sourceMappingURL=cache.js.map

package/build/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,kEAAkE;AAOlE,MAAM,KAAK;IACD,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,GAAG,CAAS;IAEpB,YAAY,KAAc;QACxB,IAAI,CAAC,GAAG,GAAG,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAA8B,CAAC;QAC/D,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,IAAO;QACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,GAAG,CAAC,GAAG,KAAgD;QACrD,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC"}

package/build/utils/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Wraps a tool handler to return a clean MCP error content block
+ * instead of throwing and crashing the server.
+ */
+export declare function withErrorHandling(fn: () => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/** Truncate text to max chars. */
+export declare function truncate(text: string, maxLen?: number): string;
+//# sourceMappingURL=errors.d.ts.map

package/build/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,GACpE,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA4B7D;AAED,kCAAkC;AAClC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAG3D"}

package/build/utils/errors.js

@@ -0,0 +1,44 @@
+import { ShopeeAPIError, ShopeeAuthRequiredError } from '../api/client.js';
+/**
+ * Wraps a tool handler to return a clean MCP error content block
+ * instead of throwing and crashing the server.
+ */
+export async function withErrorHandling(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        let message;
+        if (err instanceof ShopeeAuthRequiredError) {
+            message =
+                '🔒 Not signed in to Shopee.\n\n' +
+                    'Shopee blocks anonymous product requests. Run this once in the project folder:\n' +
+                    '`npm run login`\n\n' +
+                    'A Chromium window opens — log into your Shopee account, then come back and press Enter. ' +
+                    'The session is saved and reused; retry your request afterwards.';
+        }
+        else if (err instanceof ShopeeAPIError) {
+            message = `❌ Shopee API Error: ${err.message}`;
+            if (err.statusCode === 429) {
+                message += '\n\n💡 Tip: Rate limited by Shopee. Please wait a moment before retrying.';
+            }
+            else if (err.statusCode && err.statusCode >= 500) {
+                message += '\n\n💡 Tip: Shopee is having a temporary issue. Please retry shortly.';
+            }
+        }
+        else if (err instanceof Error) {
+            message = `❌ Error: ${err.message}`;
+        }
+        else {
+            message = `❌ Unknown error occurred`;
+        }
+        return { content: [{ type: 'text', text: message }] };
+    }
+}
+/** Truncate text to max chars. */
+export function truncate(text, maxLen = 200) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen).trimEnd() + '…';
+}
+//# sourceMappingURL=errors.js.map

package/build/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAqE;IAErE,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAe,CAAC;QAEpB,IAAI,GAAG,YAAY,uBAAuB,EAAE,CAAC;YAC3C,OAAO;gBACL,iCAAiC;oBACjC,kFAAkF;oBAClF,qBAAqB;oBACrB,0FAA0F;oBAC1F,iEAAiE,CAAC;QACtE,CAAC;aAAM,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YACzC,OAAO,GAAG,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC3B,OAAO,IAAI,2EAA2E,CAAC;YACzF,CAAC;iBAAM,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;gBACnD,OAAO,IAAI,uEAAuE,CAAC;YACrF,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAChC,OAAO,GAAG,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,0BAA0B,CAAC;QACvC,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;AACH,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAM,GAAG,GAAG;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC;AAC/C,CAAC"}

package/docs/CONFIGURATION.md

@@ -0,0 +1,73 @@
+# Configuration
+
+For installing the package or cloning the repo, see **[Installation](../README.md#installation)** in the README.
+
+> **Login required.** Shopee blocks anonymous requests, so this server reads public data through a saved browser session. Run `npm run login` once before use. There are no API keys — authentication is the browser session under `~/.shopee-mcp/chrome-profile`.
+
+---
+
+## Environment variables
+
+All optional. Set them in your MCP client's **`env`** block, or copy `.env.example` to `.env` when developing from a checkout.
+
+| Variable             | Default                        | Description                          |
+| -------------------- | ------------------------------ | ------------------------------------ |
+| `SHOPEE_DOMAIN`      | `shopee.co.id`                 | Regional Shopee domain.              |
+| `SHOPEE_PROFILE_DIR` | `~/.shopee-mcp/chrome-profile` | Where the saved login lives.         |
+| `SHOPEE_HEADLESS`    | `false`                        | Keep `false` — headless is detected. |
+| `CACHE_TTL_MS`       | `30000`                        | In-memory cache lifetime.            |
+| `DEBUG`              | `false`                        | Log startup/debug info to stderr.    |
+
+---
+
+## MCP configuration (all clients)
+
+This server uses **stdio** and launches a **headed** browser, so it needs a display. On a headless machine, wrap the command in `xvfb-run`.
+
+### With a virtual display (servers)
+
+```json
+{
+  "mcpServers": {
+    "shopee": {
+      "command": "xvfb-run",
+      "args": ["-a", "node", "/absolute/path/to/shopee-mcp/build/index.js"]
+    }
+  }
+}
+```
+
+### With a real display (desktop / WSLg)
+
+```json
+{
+  "mcpServers": {
+    "shopee": {
+      "command": "node",
+      "args": ["/absolute/path/to/shopee-mcp/build/index.js"]
+    }
+  }
+}
+```
+
+Use an **absolute** path to `build/index.js`.
+
+---
+
+## Claude Code
+
+- **CLI:** `claude mcp add shopee -- xvfb-run -a node /absolute/path/to/shopee-mcp/build/index.js` (drop `xvfb-run -a` on a machine with a display).
+- **Project scope:** `.mcp.json` in the repo root. **User scope:** `~/.claude.json`.
+- **Restart** or reload so the new server is registered.
+
+## Claude Desktop
+
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Linux:** `~/.config/Claude/claude_desktop_config.json`
+
+Use the same **`mcpServers`** JSON as above.
+
+## Other editors
+
+Cursor, Zed, Windsurf, and any other **stdio MCP host** use the same pattern: a server whose command is `node` (or `xvfb-run … node`) plus the path to `build/index.js`.