@rbillon59/vinted-mcp-server 0.1.0

package/dist/tools/user-items.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { getClient } from "../api/client.js";
+import { formatPrice } from "../api/types.js";
+import { mcpError } from "../utils/mcp-error.js";
+function formatUserItems(data, userId) {
+    if (data.items.length === 0) {
+        return `User ${userId} has no items listed.`;
+    }
+    const { pagination } = data;
+    const header = `User ${userId} — ${pagination.total_entries} items (page ${pagination.current_page}/${pagination.total_pages}):\n`;
+    const items = data.items.map((item) => {
+        const price = formatPrice(item.price, item.currency);
+        const brand = item.brand_title ?? item.brand ?? "";
+        const size = item.size_title ?? item.size ?? "";
+        const parts = [
+            `- **${item.title}** — ${price}`,
+        ];
+        if (brand)
+            parts[0] += ` | ${brand}`;
+        if (size)
+            parts[0] += ` | Size: ${size}`;
+        parts.push(`  ID: ${item.id} | ${item.url}`);
+        return parts.join("\n");
+    });
+    return header + items.join("\n");
+}
+export function registerUserItemsTool(server) {
+    server.tool("get_user_items", "List items currently for sale by a specific Vinted user/seller.", {
+        user_id: z.number().int().positive().describe("The Vinted user ID"),
+        page: z.number().int().min(1).max(100).default(1).describe("Page number (default: 1)"),
+        per_page: z.number().int().min(1).max(96).default(20).describe("Results per page (default: 20, max: 96)"),
+        order: z.enum(["relevance", "price_low_to_high", "price_high_to_low", "newest_first"]).default("newest_first").describe("Sort order"),
+    }, async (params) => {
+        try {
+            const data = await getClient().get(`/wardrobe/${params.user_id}/items`, {
+                page: String(params.page),
+                per_page: String(params.per_page),
+                order: params.order,
+            });
+            const text = formatUserItems(data, params.user_id);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpError("Failed to get user items", error);
+        }
+    });
+}
+//# sourceMappingURL=user-items.js.map

package/dist/tools/user-items.js.map

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

package/dist/tools/user.d.ts

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

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

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

package/dist/tools/user.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { getClient } from "../api/client.js";
+import { mcpError } from "../utils/mcp-error.js";
+function formatUserProfile(data) {
+    const { user } = data;
+    const lines = [
+        `# ${user.login}`,
+        "",
+        `## Profile`,
+        `- **Rating:** ${user.feedback_reputation}/5`,
+        `- **Reviews:** ${user.positive_feedback_count} positive, ${user.negative_feedback_count} negative (${user.feedback_count} total)`,
+        `- **Items listed:** ${user.item_count}`,
+        `- **Items sold:** ${user.given_item_count}`,
+    ];
+    if (user.city || user.country_title) {
+        lines.push(`- **Location:** ${[user.city, user.country_title].filter(Boolean).join(", ")}`);
+    }
+    lines.push(`- **Member since:** ${user.created_at}`);
+    lines.push(`- **Last active:** ${user.last_loged_on_ts}`);
+    return lines.join("\n");
+}
+export function registerUserTool(server) {
+    server.tool("get_user_profile", "Get a Vinted user's profile including ratings, reviews, number of items, and activity.", {
+        user_id: z.number().int().positive().describe("The Vinted user ID (from search results or item details)"),
+    }, async (params) => {
+        try {
+            const data = await getClient().get(`/users/${params.user_id}`);
+            const text = formatUserProfile(data);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpError("Failed to get user profile", error);
+        }
+    });
+}
+//# sourceMappingURL=user.js.map

package/dist/tools/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,SAAS,iBAAiB,CAAC,IAAuB;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG;QACZ,KAAK,IAAI,CAAC,KAAK,EAAE;QACjB,EAAE;QACF,YAAY;QACZ,iBAAiB,IAAI,CAAC,mBAAmB,IAAI;QAC7C,kBAAkB,IAAI,CAAC,uBAAuB,cAAc,IAAI,CAAC,uBAAuB,cAAc,IAAI,CAAC,cAAc,SAAS;QAClI,uBAAuB,IAAI,CAAC,UAAU,EAAE;QACxC,qBAAqB,IAAI,CAAC,gBAAgB,EAAE;KAC7C,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,wFAAwF,EACxF;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;KAC1G,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,CAAoB,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAErC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;aAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple TTL cache with automatic cleanup.
+ * Memory-efficient: entries are evicted on access and periodically swept.
+ */
+export declare class TtlCache<T> {
+    private readonly store;
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private sweepTimer;
+    constructor(ttlMs: number, maxEntries?: number);
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    private sweep;
+    get size(): number;
+    destroy(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAA+C;gBAErD,KAAK,EAAE,MAAM,EAAE,UAAU,SAAM;IAY3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAgB/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAehC,OAAO,CAAC,KAAK;IASb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,IAAI;CAOhB"}

package/dist/utils/cache.js

@@ -0,0 +1,65 @@
+/**
+ * Simple TTL cache with automatic cleanup.
+ * Memory-efficient: entries are evicted on access and periodically swept.
+ */
+export class TtlCache {
+    store = new Map();
+    ttlMs;
+    maxEntries;
+    sweepTimer = null;
+    constructor(ttlMs, maxEntries = 200) {
+        this.ttlMs = ttlMs;
+        this.maxEntries = maxEntries;
+        // Sweep expired entries every TTL period
+        this.sweepTimer = setInterval(() => this.sweep(), this.ttlMs);
+        // Allow process to exit even if timer is active
+        if (this.sweepTimer.unref) {
+            this.sweepTimer.unref();
+        }
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        // Move to end for LRU eviction order
+        this.store.delete(key);
+        this.store.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        // Evict oldest entries if at capacity
+        if (this.store.size >= this.maxEntries) {
+            const firstKey = this.store.keys().next().value;
+            if (firstKey !== undefined) {
+                this.store.delete(firstKey);
+            }
+        }
+        this.store.set(key, {
+            value,
+            expiresAt: Date.now() + this.ttlMs,
+        });
+    }
+    sweep() {
+        const now = Date.now();
+        for (const [key, entry] of this.store) {
+            if (now > entry.expiresAt) {
+                this.store.delete(key);
+            }
+        }
+    }
+    get size() {
+        return this.store.size;
+    }
+    destroy() {
+        if (this.sweepTimer) {
+            clearInterval(this.sweepTimer);
+            this.sweepTimer = null;
+        }
+        this.store.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,OAAO,QAAQ;IACF,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,KAAK,CAAS;IACd,UAAU,CAAS;IAC5B,UAAU,GAA0C,IAAI,CAAC;IAEjE,YAAY,KAAa,EAAE,UAAU,GAAG,GAAG;QACzC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,yCAAyC;QACzC,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,gDAAgD;QAChD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,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;QAED,qCAAqC;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,sCAAsC;QACtC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;SACnC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/utils/mcp-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared MCP error response builder for tool handlers.
+ */
+export declare function mcpError(prefix: string, error: unknown): {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+};
+//# sourceMappingURL=mcp-error.d.ts.map

package/dist/utils/mcp-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG;IACxD,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,IAAI,CAAC;CACf,CAMA"}

package/dist/utils/mcp-error.js

@@ -0,0 +1,11 @@
+/**
+ * Shared MCP error response builder for tool handlers.
+ */
+export function mcpError(prefix, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `${prefix}: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=mcp-error.js.map

package/dist/utils/mcp-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error.js","sourceRoot":"","sources":["../../src/utils/mcp-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAc;IAIrD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Token bucket rate limiter.
+ * Prevents overwhelming the Vinted API with too many requests.
+ */
+export declare class RateLimiter {
+    private tokens;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private lastRefill;
+    /**
+     * @param maxRequests Maximum burst size
+     * @param windowMs Time window in milliseconds for the max requests
+     */
+    constructor(maxRequests: number, windowMs: number);
+    private refill;
+    /**
+     * Wait until a token is available, then consume it.
+     * Returns immediately if tokens are available.
+     */
+    acquire(): Promise<void>;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOjD,OAAO,CAAC,MAAM;IAOd;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB/B"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,47 @@
+/**
+ * Token bucket rate limiter.
+ * Prevents overwhelming the Vinted API with too many requests.
+ */
+export class RateLimiter {
+    tokens;
+    maxTokens;
+    refillRate; // tokens per ms
+    lastRefill;
+    /**
+     * @param maxRequests Maximum burst size
+     * @param windowMs Time window in milliseconds for the max requests
+     */
+    constructor(maxRequests, windowMs) {
+        this.maxTokens = maxRequests;
+        this.tokens = maxRequests;
+        this.refillRate = maxRequests / windowMs;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);
+        this.lastRefill = now;
+    }
+    /**
+     * Wait until a token is available, then consume it.
+     * Returns immediately if tokens are available.
+     */
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        // Calculate wait time for next token
+        const waitMs = Math.ceil((1 - this.tokens) / this.refillRate);
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        this.refill();
+        // Guard against timer imprecision
+        if (this.tokens < 1) {
+            return this.acquire();
+        }
+        this.tokens -= 1;
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,WAAW;IACd,MAAM,CAAS;IACN,SAAS,CAAS;IAClB,UAAU,CAAS,CAAC,gBAAgB;IAC7C,UAAU,CAAS;IAE3B;;;OAGG;IACH,YAAY,WAAmB,EAAE,QAAgB;QAC/C,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QAED,qCAAqC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,kCAAkC;QAClC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@rbillon59/vinted-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for interacting with the Vinted marketplace",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "vinted-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "vinted",
+    "model-context-protocol",
+    "ai"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "puppeteer": "^24.39.1",
+    "puppeteer-extra": "^3.3.6",
+    "puppeteer-extra-plugin-stealth": "^2.11.2",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.27.0",
+    "@types/node": "^22.15.3",
+    "eslint": "^9.27.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.32.1"
+  }
+}