@rbillon59/vinted-mcp-server 0.1.0

package/dist/api/session-provider.js

@@ -0,0 +1,69 @@
+/**
+ * Browser-based session provider for Vinted.
+ *
+ * Uses puppeteer-extra with the stealth plugin to solve Cloudflare challenges,
+ * extract cookies, and return them for use with regular fetch calls.
+ * The browser is launched only during session refresh and closed immediately after.
+ */
+import { buildCookieString, hasSessionCookie, launchStealthBrowser, parseTimeoutEnv, } from "./browser-utils.js";
+const BROWSER_TIMEOUT_MS = 30_000;
+const COOKIE_POLL_INTERVAL_MS = 500;
+function buildConfig(overrides) {
+    return {
+        timeoutMs: overrides?.timeoutMs ?? parseTimeoutEnv(BROWSER_TIMEOUT_MS),
+        executablePath: overrides?.executablePath
+            ?? process.env["PUPPETEER_EXECUTABLE_PATH"]
+            ?? "",
+    };
+}
+export class BrowserSessionProvider {
+    config;
+    browser = null;
+    constructor(config) {
+        this.config = buildConfig(config);
+    }
+    async refreshSession(domain) {
+        const browser = await launchStealthBrowser(this.config.executablePath);
+        this.browser = browser;
+        try {
+            const page = await browser.newPage();
+            const cookie = await this.solveChallenge(page, domain);
+            return { cookie, fetchedAt: Date.now() };
+        }
+        finally {
+            await this.closeBrowser();
+        }
+    }
+    async destroy() {
+        await this.closeBrowser();
+    }
+    async solveChallenge(page, domain) {
+        const url = `https://${domain}`;
+        await page.goto(url, { waitUntil: "domcontentloaded" });
+        const deadline = Date.now() + this.config.timeoutMs;
+        while (Date.now() < deadline) {
+            const cookies = await page.cookies();
+            if (hasSessionCookie(cookies)) {
+                return buildCookieString(cookies);
+            }
+            await new Promise((resolve) => setTimeout(resolve, COOKIE_POLL_INTERVAL_MS));
+        }
+        throw new Error(`Cloudflare challenge not resolved within ${this.config.timeoutMs}ms for ${domain}`);
+    }
+    async closeBrowser() {
+        if (this.browser) {
+            const browser = this.browser;
+            this.browser = null;
+            try {
+                await browser.close();
+            }
+            catch {
+                // Browser may already be closed — ignore
+            }
+        }
+    }
+}
+export function createSessionProvider(config) {
+    return new BrowserSessionProvider(config);
+}
+//# sourceMappingURL=session-provider.js.map

package/dist/api/session-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-provider.js","sourceRoot":"","sources":["../../src/api/session-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAiBpC,SAAS,WAAW,CAAC,SAAiC;IACpD,OAAO;QACL,SAAS,EAAE,SAAS,EAAE,SAAS,IAAI,eAAe,CAAC,kBAAkB,CAAC;QACtE,cAAc,EAAE,SAAS,EAAE,cAAc;eACpC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;eACxC,EAAE;KACR,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAAkC;IACjD,OAAO,GAAmB,IAAI,CAAC;IAEvC,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3C,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAU,EAAE,MAAc;QACrD,MAAM,GAAG,GAAG,WAAW,MAAM,EAAE,CAAC;QAEhC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAEpD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAErC,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9B,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,MAAM,CAAC,SAAS,UAAU,MAAM,EAAE,CACpF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA8B;IAClE,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/api/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Vinted API response types.
+ * Typed from observed API responses - only includes fields we use.
+ */
+export interface VintedPhoto {
+    id: number;
+    url: string;
+    dominant_color: string;
+    is_main: boolean;
+}
+export interface VintedPrice {
+    amount: string;
+    currency_code: string;
+}
+export interface VintedItemSummary {
+    id: number;
+    title: string;
+    price: string | VintedPrice;
+    currency?: string;
+    brand_title?: string;
+    size_title?: string;
+    /** Wardrobe endpoint uses `brand` instead of `brand_title`. */
+    brand?: string;
+    /** Wardrobe endpoint uses `size` instead of `size_title`. */
+    size?: string;
+    url: string;
+    photo: VintedPhoto | null;
+    favourite_count: number;
+    view_count: number;
+    user: {
+        id: number;
+        login: string;
+    };
+}
+/** Extract displayable price string from either format. */
+export declare function formatPrice(price: string | VintedPrice, currency?: string): string;
+export interface VintedSearchResponse {
+    items: VintedItemSummary[];
+    pagination: {
+        current_page: number;
+        total_pages: number;
+        total_entries: number;
+        per_page: number;
+    };
+}
+export interface VintedBrand {
+    id: number;
+    title: string;
+    slug: string;
+    favourite_count: number;
+    item_count: number;
+    is_luxury: boolean;
+}
+export interface VintedBrandSearchResponse {
+    brands: VintedBrand[];
+}
+export interface VintedCatalog {
+    id: number;
+    title: string;
+    code: string;
+    catalogs: VintedCatalog[];
+}
+export interface VintedCatalogResponse {
+    catalogs: VintedCatalog[];
+}
+export interface VintedUserProfile {
+    user: {
+        id: number;
+        login: string;
+        feedback_reputation: number;
+        feedback_count: number;
+        positive_feedback_count: number;
+        negative_feedback_count: number;
+        item_count: number;
+        given_item_count: number;
+        city: string;
+        country_title: string;
+        last_loged_on_ts: string;
+        created_at: string;
+        photo: VintedPhoto | null;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,uBAAuB,EAAE,MAAM,CAAC;QAChC,uBAAuB,EAAE,MAAM,CAAC;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH"}

package/dist/api/types.js

@@ -0,0 +1,12 @@
+/**
+ * Vinted API response types.
+ * Typed from observed API responses - only includes fields we use.
+ */
+/** Extract displayable price string from either format. */
+export function formatPrice(price, currency) {
+    if (typeof price === "string") {
+        return currency ? `${price} ${currency}` : price;
+    }
+    return `${price.amount} ${price.currency_code}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,KAA2B,EAAE,QAAiB;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;AAClD,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,21 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+import { destroyClient } from "./api/client.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    const shutdown = async () => {
+        await destroyClient();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+    await server.connect(transport);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Fatal error: ${message}\n`);
+    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":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,aAAa,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,OAAO,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

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

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,YAAY,IAAI,SAAS,CAexC"}

package/dist/server.js

@@ -0,0 +1,22 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerSearchTool } from "./tools/search.js";
+import { registerItemTool } from "./tools/item.js";
+import { registerUserTool } from "./tools/user.js";
+import { registerUserItemsTool } from "./tools/user-items.js";
+import { registerBrandsTool } from "./tools/brands.js";
+import { registerCategoriesTool } from "./tools/categories.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "vinted-mcp-server",
+        version: "0.1.0",
+    });
+    // Read-only tools (always available)
+    registerSearchTool(server);
+    registerItemTool(server);
+    registerUserTool(server);
+    registerUserItemsTool(server);
+    registerBrandsTool(server);
+    registerCategoriesTool(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,qCAAqC;IACrC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/brands.d.ts

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

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

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

package/dist/tools/brands.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { getClient } from "../api/client.js";
+import { mcpError } from "../utils/mcp-error.js";
+function formatBrands(data, query) {
+    if (data.brands.length === 0) {
+        return `No brands found matching "${query}".`;
+    }
+    const header = `Brands matching "${query}":\n`;
+    const brands = data.brands.map((brand) => {
+        const parts = [`- **${brand.title}** (ID: ${brand.id})`];
+        parts[0] += ` — ${brand.item_count} items`;
+        if (brand.is_luxury)
+            parts[0] += " [Luxury]";
+        return parts.join("");
+    });
+    return header + brands.join("\n");
+}
+export function registerBrandsTool(server) {
+    server.tool("search_brands", "Search for Vinted brand IDs by name. Use the returned IDs with the brand_ids filter in search_items.", {
+        query: z.string().min(1).describe("Brand name to search for (e.g., 'Nike', 'Zara')"),
+    }, async (params) => {
+        try {
+            const data = await getClient().get("/brands", { keyword: params.query });
+            const text = formatBrands(data, params.query);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpError("Failed to search brands", error);
+        }
+    });
+}
+//# sourceMappingURL=brands.js.map

package/dist/tools/brands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brands.js","sourceRoot":"","sources":["../../src/tools/brands.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,YAAY,CAAC,IAA+B,EAAE,KAAa;IAClE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,6BAA6B,KAAK,IAAI,CAAC;IAChD,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,KAAK,MAAM,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACzD,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,UAAU,QAAQ,CAAC;QAC3C,IAAI,KAAK,CAAC,SAAS;YAAE,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;QAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sGAAsG,EACtG;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KACrF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,CAChC,SAAS,EACT,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,CAC1B,CAAC;YACF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAE9C,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,yBAAyB,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/categories.d.ts

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

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

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

package/dist/tools/categories.js

@@ -0,0 +1,28 @@
+import { getClient } from "../api/client.js";
+import { mcpError } from "../utils/mcp-error.js";
+function formatCatalogs(catalogs, depth = 0) {
+    const lines = [];
+    const indent = "  ".repeat(depth);
+    for (const catalog of catalogs) {
+        lines.push(`${indent}- **${catalog.title}** (ID: ${catalog.id})`);
+        if (catalog.catalogs.length > 0) {
+            lines.push(formatCatalogs(catalog.catalogs, depth + 1));
+        }
+    }
+    return lines.join("\n");
+}
+export function registerCategoriesTool(server) {
+    server.tool("get_categories", "Get the Vinted category tree. Use the returned IDs with the catalog_ids filter in search_items.", {}, async () => {
+        try {
+            const data = await getClient().get("/catalogs");
+            const text = "# Vinted Categories\n\n" + formatCatalogs(data.catalogs);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpError("Failed to get categories", error);
+        }
+    });
+}
+//# sourceMappingURL=categories.js.map

package/dist/tools/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,SAAS,cAAc,CAAC,QAAyB,EAAE,QAAgB,CAAC;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,OAAO,CAAC,KAAK,WAAW,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,iGAAiG,EACjG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,CAAwB,WAAW,CAAC,CAAC;YACvE,MAAM,IAAI,GAAG,yBAAyB,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEvE,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,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/item.d.ts

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

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

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

package/dist/tools/item.js

@@ -0,0 +1,155 @@
+import { z } from "zod";
+import { getClient } from "../api/client.js";
+import { mcpError } from "../utils/mcp-error.js";
+function extractJsonLd(html) {
+    const match = html.match(/<script type="application\/ld\+json"[^>]*>([\s\S]*?)<\/script>/);
+    if (!match?.[1])
+        return null;
+    try {
+        const data = JSON.parse(match[1]);
+        if (typeof data === "object" && data !== null && data["@type"] === "Product") {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function extractOgMeta(html, property) {
+    // Handle both attribute orders: property then content, or content then property
+    const patterns = [
+        new RegExp(`<meta\\s+(?:property|name)="${property}"\\s+content="([^"]*)"`, "i"),
+        new RegExp(`<meta\\s+content="([^"]*)"\\s+(?:property|name)="${property}"`, "i"),
+    ];
+    for (const re of patterns) {
+        const match = html.match(re);
+        if (match?.[1])
+            return match[1];
+    }
+    return null;
+}
+/**
+ * Extract RSC plugin data using indexOf-based search instead of backtrack-heavy regex.
+ */
+function extractRscPlugins(html) {
+    const plugins = [];
+    const markers = ['"name":"attributes"', '"name":"description"', '"name":"summary"'];
+    let searchStart = 0;
+    for (;;) {
+        let earliest = -1;
+        for (const marker of markers) {
+            const idx = html.indexOf(marker, searchStart);
+            if (idx !== -1 && (earliest === -1 || idx < earliest)) {
+                earliest = idx;
+            }
+        }
+        if (earliest === -1)
+            break;
+        // Walk backwards to find the opening brace
+        const openBrace = html.lastIndexOf("{", earliest);
+        if (openBrace === -1) {
+            searchStart = earliest + 1;
+            continue;
+        }
+        // Walk forward counting braces to find the matching close
+        let depth = 0;
+        let end = -1;
+        for (let i = openBrace; i < html.length; i++) {
+            if (html[i] === "{")
+                depth++;
+            else if (html[i] === "}")
+                depth--;
+            if (depth === 0) {
+                end = i + 1;
+                break;
+            }
+        }
+        if (end === -1) {
+            searchStart = earliest + 1;
+            continue;
+        }
+        const candidate = html.slice(openBrace, end);
+        try {
+            const plugin = JSON.parse(candidate);
+            if (typeof plugin === "object" && plugin !== null && "name" in plugin && "data" in plugin) {
+                plugins.push(plugin);
+            }
+        }
+        catch {
+            // Malformed JSON — skip
+        }
+        searchStart = end;
+    }
+    return plugins;
+}
+const CONDITION_MAP = {
+    NewCondition: "New",
+    UsedCondition: "Used",
+    RefurbishedCondition: "Refurbished",
+};
+function formatCondition(condition) {
+    if (!condition)
+        return "Unknown";
+    const bare = condition.replace("https://schema.org/", "");
+    return CONDITION_MAP[bare] ?? bare;
+}
+function buildItemDetail(itemId, jsonLd, ogDescription, rscPlugins, itemUrl) {
+    const lines = [];
+    const title = jsonLd?.name ?? `Item ${itemId}`;
+    lines.push(`# ${title}`);
+    if (jsonLd?.offers) {
+        lines.push(`**Price:** ${jsonLd.offers.price} ${jsonLd.offers.priceCurrency ?? "EUR"}`);
+        lines.push(`**Condition:** ${formatCondition(jsonLd.offers.itemCondition)}`);
+    }
+    const attrPlugin = rscPlugins.find((p) => p.name === "attributes");
+    if (attrPlugin?.data.attributes) {
+        for (const attr of attrPlugin.data.attributes) {
+            if (attr.data.title && attr.data.value) {
+                lines.push(`**${attr.data.title}:** ${attr.data.value}`);
+            }
+        }
+    }
+    lines.push("");
+    const descPlugin = rscPlugins.find((p) => p.name === "description");
+    const description = descPlugin?.data.description ?? ogDescription;
+    if (description) {
+        lines.push("## Description");
+        lines.push(description);
+        lines.push("");
+    }
+    if (jsonLd?.image && jsonLd.image.length > 0) {
+        lines.push(`## Photos (${jsonLd.image.length})`);
+        jsonLd.image.forEach((url, i) => {
+            lines.push(`${i + 1}. ${url}`);
+        });
+        lines.push("");
+    }
+    lines.push(`**URL:** ${itemUrl}`);
+    return lines.join("\n");
+}
+export function registerItemTool(server) {
+    server.tool("get_item_details", "Get detailed information about a specific Vinted item including description, photos, seller info, and condition.", {
+        item_id: z.number().int().positive().describe("The Vinted item ID (from search results)"),
+    }, async (params) => {
+        try {
+            const client = getClient();
+            const itemUrl = `${client.baseUrl}/items/${params.item_id}`;
+            const html = await client.getHtml(itemUrl);
+            const jsonLd = extractJsonLd(html);
+            const ogDescription = extractOgMeta(html, "og:description");
+            const rscPlugins = extractRscPlugins(html);
+            if (!jsonLd && rscPlugins.length === 0) {
+                return mcpError("Failed to get item details", new Error("Could not extract item data (page may require authentication or Cloudflare challenge)"));
+            }
+            const text = buildItemDetail(params.item_id, jsonLd, ogDescription, rscPlugins, itemUrl);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpError("Failed to get item details", error);
+        }
+    });
+}
+//# sourceMappingURL=item.js.map

package/dist/tools/item.js.map

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

package/dist/tools/search.d.ts

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

package/dist/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;AA8BpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6C1D"}

package/dist/tools/search.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { getClient } from "../api/client.js";
+import { formatPrice } from "../api/types.js";
+import { mcpError } from "../utils/mcp-error.js";
+function formatSearchResults(data) {
+    if (data.items.length === 0) {
+        return "No items found matching your search criteria.";
+    }
+    const { pagination } = data;
+    const header = `Found ${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 parts = [
+            `- **${item.title}** — ${price}`,
+        ];
+        if (item.brand_title)
+            parts[0] += ` | ${item.brand_title}`;
+        if (item.size_title)
+            parts[0] += ` | Size: ${item.size_title}`;
+        parts.push(`  Seller: ${item.user.login} (ID: ${item.user.id}) | ❤ ${item.favourite_count} | 👁 ${item.view_count}`);
+        parts.push(`  ${item.url}`);
+        parts.push(`  ID: ${item.id}`);
+        return parts.join("\n");
+    });
+    return header + items.join("\n\n");
+}
+export function registerSearchTool(server) {
+    server.tool("search_items", "Search for items on the Vinted marketplace. Returns a list of items matching the query with prices, brands, sizes, and seller info.", {
+        query: z.string().min(1).describe("Search query (e.g., 'nike air max', 'robe vintage')"),
+        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("relevance").describe("Sort order"),
+        price_from: z.number().min(0).optional().describe("Minimum price filter"),
+        price_to: z.number().min(0).optional().describe("Maximum price filter"),
+        catalog_ids: z.string().optional().describe("Catalog/category IDs (comma-separated)"),
+        brand_ids: z.string().optional().describe("Brand IDs (comma-separated)"),
+        size_ids: z.string().optional().describe("Size IDs (comma-separated)"),
+        color_ids: z.string().optional().describe("Color IDs (comma-separated)"),
+        status_ids: z.string().optional().describe("Condition IDs (comma-separated): 6=New with tags, 1=New, 2=Very good, 3=Good, 4=Satisfactory"),
+    }, async (params) => {
+        try {
+            const queryParams = {
+                search_text: params.query,
+                page: String(params.page),
+                per_page: String(params.per_page),
+                order: params.order,
+            };
+            if (params.price_from !== undefined)
+                queryParams["price_from"] = String(params.price_from);
+            if (params.price_to !== undefined)
+                queryParams["price_to"] = String(params.price_to);
+            if (params.catalog_ids)
+                queryParams["catalog_ids"] = params.catalog_ids;
+            if (params.brand_ids)
+                queryParams["brand_ids"] = params.brand_ids;
+            if (params.size_ids)
+                queryParams["size_ids"] = params.size_ids;
+            if (params.color_ids)
+                queryParams["color_ids"] = params.color_ids;
+            if (params.status_ids)
+                queryParams["status_ids"] = params.status_ids;
+            const data = await getClient().get("/catalog/items", queryParams);
+            const text = formatSearchResults(data);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpError("Search failed", error);
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/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/dist/tools/user-items.d.ts

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

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

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