@rbillon59/vinted-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,232 @@
+# vinted-mcp-server
+
+[![CI](https://github.com/Rbillon59/vinted-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/Rbillon59/vinted-mcp-server/actions/workflows/ci.yml)
+
+A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for interacting with the Vinted marketplace. Enables AI assistants to search, browse, and discover second-hand items on Vinted.
+
+## Features
+
+- **Search items** — Full-text search with filters (price, brand, size, color, condition, sort)
+- **Item details** — Full item info including description, photos, seller profile, and condition
+- **User profiles** — Seller ratings, reviews, item counts, and activity
+- **User items** — Browse all items listed by a specific user
+- **Brand search** — Find brand IDs for use in search filters
+- **Categories** — Browse the Vinted category tree
+- **Rate limiting** — Token bucket rate limiter to avoid API bans
+- **Caching** — In-memory LRU cache with TTL for fast repeated queries
+- **Retry logic** — Exponential backoff for transient errors
+- **Session management** — Puppeteer-based with Cloudflare bypass
+- **Token-efficient** — Concise markdown responses optimized for LLM consumption
+
+## Quick Start
+
+### Prerequisites
+- Node.js 20+
+
+### Using npx (zero-install)
+
+This server communicates via **stdio** (JSON-RPC) and is designed to be launched by an MCP client, not run directly in a terminal. Configure it in your MCP client as shown below.
+
+### Install from source
+
+```bash
+git clone https://github.com/Rbillon59/vinted-mcp-server.git
+cd vinted-mcp-server
+npm install
+npm run build
+```
+
+### Usage with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "vinted": {
+      "command": "npx",
+      "args": ["vinted-mcp-server"],
+      "env": {
+        "VINTED_DOMAIN": "www.vinted.fr"
+      }
+    }
+  }
+}
+```
+
+<details>
+<summary>Alternative: using a local build</summary>
+
+```json
+{
+  "mcpServers": {
+    "vinted": {
+      "command": "node",
+      "args": ["/absolute/path/to/vinted-mcp-server/dist/index.js"],
+      "env": {
+        "VINTED_DOMAIN": "www.vinted.fr"
+      }
+    }
+  }
+}
+```
+</details>
+
+### Usage with Claude Code CLI
+
+Add to your Claude Code settings (`~/.claude/settings.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "vinted": {
+      "command": "npx",
+      "args": ["vinted-mcp-server"],
+      "env": {
+        "VINTED_DOMAIN": "www.vinted.fr"
+      }
+    }
+  }
+}
+```
+
+### Usage with Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "vinted": {
+      "command": "npx",
+      "args": ["vinted-mcp-server"]
+    }
+  }
+}
+```
+
+### Usage with Docker
+
+```bash
+docker build -t vinted-mcp-server .
+docker run -i --rm -e VINTED_DOMAIN=www.vinted.fr vinted-mcp-server
+```
+
+## Available Tools
+
+### `search_items`
+Search the Vinted catalog with filters.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `query` | string | *(required)* | Search text (e.g., "nike air max", "robe vintage") |
+| `page` | number | 1 | Page number |
+| `per_page` | number | 20 | Results per page (max: 96) |
+| `order` | string | "relevance" | Sort: `relevance`, `price_low_to_high`, `price_high_to_low`, `newest_first` |
+| `price_from` | number | — | Minimum price filter |
+| `price_to` | number | — | Maximum price filter |
+| `brand_ids` | string | — | Brand IDs (comma-separated) |
+| `size_ids` | string | — | Size IDs (comma-separated) |
+| `color_ids` | string | — | Color IDs (comma-separated) |
+| `catalog_ids` | string | — | Category IDs (comma-separated) |
+| `status_ids` | string | — | Condition: `6`=New with tags, `1`=New, `2`=Very good, `3`=Good, `4`=Satisfactory |
+
+### `get_item_details`
+Get detailed information about a specific item.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `item_id` | number | The Vinted item ID (from search results) |
+
+Returns: title, price, description, brand, size, condition, colors, seller info (rating, location), photos, stats (views, favorites).
+
+### `get_user_profile`
+Get a seller's profile information.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `user_id` | number | The Vinted user ID (from search results or item details) |
+
+Returns: username, rating, review breakdown, items listed/sold, location, member since, last active.
+
+### `get_user_items`
+Browse all items listed by a specific user.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `user_id` | number | *(required)* | The Vinted user ID |
+| `page` | number | 1 | Page number |
+| `per_page` | number | 20 | Results per page |
+
+### `search_brands`
+Search for brand names and get their IDs for use in search filters.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `query` | string | Brand name to search (e.g., "Nike", "Zara") |
+
+### `get_categories`
+Browse the Vinted category tree.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `parent_id` | number | *(optional)* Parent category ID to list children of |
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `VINTED_DOMAIN` | `www.vinted.fr` | Vinted domain (e.g., `www.vinted.de`, `www.vinted.es`, `www.vinted.it`) |
+| `PUPPETEER_EXECUTABLE_PATH` | — | Custom Chrome/Chromium path for Puppeteer |
+| `BROWSER_TIMEOUT_MS` | `30000` | Timeout for Cloudflare challenge resolution (ms) |
+
+### Supported Domains
+| Domain | Country |
+|--------|---------|
+| `www.vinted.fr` | France |
+| `www.vinted.de` | Germany |
+| `www.vinted.es` | Spain |
+| `www.vinted.it` | Italy |
+| `www.vinted.nl` | Netherlands |
+| `www.vinted.be` | Belgium |
+| `www.vinted.pl` | Poland |
+| `www.vinted.pt` | Portugal |
+| `www.vinted.lt` | Lithuania |
+| `www.vinted.cz` | Czech Republic |
+| `www.vinted.co.uk` | United Kingdom |
+
+## Architecture
+
+```
+src/
+  index.ts              # Entry point, stdio transport
+  server.ts             # MCP server config & tool registration
+  tools/
+    search.ts           # search_items tool
+    item.ts             # get_item_details tool
+    user.ts             # get_user_profile tool
+    user-items.ts       # get_user_items tool
+    brands.ts           # search_brands tool
+    categories.ts       # get_categories tool
+  api/
+    client.ts           # HTTP client (session, cache, rate limit, retry)
+    session-provider.ts # Browser-based session (Cloudflare bypass)
+    browser-utils.ts    # Shared Puppeteer/stealth utilities
+    types.ts            # Vinted API response types
+  utils/
+    cache.ts            # TTL cache with LRU eviction
+    rate-limiter.ts     # Token bucket rate limiter
+    mcp-error.ts        # Shared MCP error response builder
+```
+
+### Reliability Features
+- **Rate limiting**: Token bucket (10 req/10s) prevents API bans
+- **Caching**: LRU cache (3min TTL, 200 entries max) reduces redundant requests
+- **Retry**: Exponential backoff (1s, 2s) on 429/5xx errors
+- **Session recovery**: Automatic cookie refresh on 401/403 with request coalescing
+- **Request deduplication**: Concurrent identical requests share a single API call
+- **Cloudflare bypass**: Puppeteer with stealth plugin for session acquisition
+
+## License
+
+MIT

package/dist/api/browser-utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared browser constants and utilities for session providers.
+ */
+import type { Browser } from "puppeteer";
+export declare const BROWSER_ARGS: readonly ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage", "--disable-gpu", "--disable-extensions", "--disable-background-networking", "--disable-sync", "--no-first-run"];
+/** Cookie names that indicate a successful Vinted session. */
+export declare const SESSION_COOKIE_REGEX: RegExp;
+export declare const ACCESS_TOKEN_COOKIE = "access_token_web";
+/** Additional cookies to include in API requests. */
+export declare const EXTRA_COOKIE_NAMES: readonly ["anon_id", "anonymous-locale", "v_udt", "__cf_bm"];
+export declare function buildCookieString(cookies: ReadonlyArray<{
+    name: string;
+    value: string;
+}>): string;
+export declare function hasSessionCookie(cookies: ReadonlyArray<{
+    name: string;
+    value: string;
+}>): boolean;
+export declare function launchStealthBrowser(executablePath: string): Promise<Browser>;
+export declare function parseTimeoutEnv(fallback: number): number;
+//# sourceMappingURL=browser-utils.d.ts.map

package/dist/api/browser-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-utils.d.ts","sourceRoot":"","sources":["../../src/api/browser-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,eAAO,MAAM,YAAY,kMASf,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,QAA0B,CAAC;AAC5D,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,8DAKrB,CAAC;AAEX,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,MAAM,CAoBR;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,OAAO,CAIT;AAED,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/dist/api/browser-utils.js

@@ -0,0 +1,64 @@
+/**
+ * Shared browser constants and utilities for session providers.
+ */
+export const BROWSER_ARGS = [
+    "--no-sandbox",
+    "--disable-setuid-sandbox",
+    "--disable-dev-shm-usage",
+    "--disable-gpu",
+    "--disable-extensions",
+    "--disable-background-networking",
+    "--disable-sync",
+    "--no-first-run",
+];
+/** Cookie names that indicate a successful Vinted session. */
+export const SESSION_COOKIE_REGEX = /^_vinted_\w+_session$/;
+export const ACCESS_TOKEN_COOKIE = "access_token_web";
+/** Additional cookies to include in API requests. */
+export const EXTRA_COOKIE_NAMES = [
+    "anon_id",
+    "anonymous-locale",
+    "v_udt",
+    "__cf_bm",
+];
+export function buildCookieString(cookies) {
+    const extraSet = new Set(EXTRA_COOKIE_NAMES);
+    const parts = [];
+    for (const cookie of cookies) {
+        const isSession = cookie.name === ACCESS_TOKEN_COOKIE
+            || SESSION_COOKIE_REGEX.test(cookie.name);
+        const isExtra = extraSet.has(cookie.name);
+        if (isSession || isExtra) {
+            parts.push(`${cookie.name}=${cookie.value}`);
+        }
+    }
+    if (parts.length === 0) {
+        throw new Error("No usable cookies found after session resolution");
+    }
+    return parts.join("; ");
+}
+export function hasSessionCookie(cookies) {
+    return cookies.some((c) => c.name === ACCESS_TOKEN_COOKIE || SESSION_COOKIE_REGEX.test(c.name));
+}
+export async function launchStealthBrowser(executablePath) {
+    const puppeteerExtraMod = (await import("puppeteer-extra"));
+    const stealthMod = (await import("puppeteer-extra-plugin-stealth"));
+    const puppeteer = puppeteerExtraMod.default;
+    puppeteer.use(stealthMod.default());
+    const launchOptions = {
+        headless: true,
+        args: [...BROWSER_ARGS],
+    };
+    if (executablePath) {
+        launchOptions["executablePath"] = executablePath;
+    }
+    return puppeteer.launch(launchOptions);
+}
+export function parseTimeoutEnv(fallback) {
+    const envTimeout = process.env["BROWSER_TIMEOUT_MS"];
+    if (!envTimeout)
+        return fallback;
+    const parsed = parseInt(envTimeout, 10);
+    return Number.isFinite(parsed) ? parsed : fallback;
+}
+//# sourceMappingURL=browser-utils.js.map

package/dist/api/browser-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-utils.js","sourceRoot":"","sources":["../../src/api/browser-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,cAAc;IACd,0BAA0B;IAC1B,yBAAyB;IACzB,eAAe;IACf,sBAAsB;IACtB,iCAAiC;IACjC,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAEtD,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS;IACT,kBAAkB;IAClB,OAAO;IACP,SAAS;CACD,CAAC;AAEX,MAAM,UAAU,iBAAiB,CAC/B,OAAuD;IAEvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GACb,MAAM,CAAC,IAAI,KAAK,mBAAmB;eAChC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAuD;IAEvD,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,cAAsB;IAEtB,MAAM,iBAAiB,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAKzD,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAEjE,CAAC;IAEF,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC;IAC5C,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpC,MAAM,aAAa,GAA4B;QAC7C,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC;KACxB,CAAC;IACF,IAAI,cAAc,EAAE,CAAC;QACnB,aAAa,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC;IACnD,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC"}

package/dist/api/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Vinted API HTTP client with session management, rate limiting, and caching.
+ */
+import { type SessionProvider } from "./session-provider.js";
+export declare const USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+export declare class VintedClient {
+    private readonly domain;
+    private session;
+    private refreshPromise;
+    private readonly cache;
+    private readonly rateLimiter;
+    private readonly inflight;
+    private readonly sessionProvider;
+    constructor(domain?: string, sessionProvider?: SessionProvider);
+    get baseUrl(): string;
+    private doRefreshSession;
+    /**
+     * Coalesce concurrent session refreshes into a single request.
+     */
+    private refreshSession;
+    private isSessionValid;
+    private ensureSession;
+    /**
+     * Fetch with retry logic for transient errors.
+     */
+    private fetchWithRetry;
+    /**
+     * Make an authenticated, cached, rate-limited GET request to the Vinted API.
+     * Deduplicates concurrent requests for the same URL.
+     */
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    private fetchAndCache;
+    /**
+     * Fetch an HTML page with session, rate limiting, and retry.
+     * Used for scraping item detail pages where the JSON API is unavailable.
+     */
+    getHtml(url: string): Promise<string>;
+    /**
+     * Release browser resources held by session providers.
+     */
+    destroy(): Promise<void>;
+}
+export declare function getClient(): VintedClient;
+export declare function destroyClient(): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,KAAK,eAAe,EAAyB,MAAM,uBAAuB,CAAC;AAcpF,eAAO,MAAM,UAAU,oHAC4F,CAAC;AASpH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8D;IAC1F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,MAAM,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,eAAe;IAK9D,IAAI,OAAO,IAAI,MAAM,CAEpB;YAEa,gBAAgB;IAI9B;;OAEG;YACW,cAAc;IAS5B,OAAO,CAAC,cAAc;YAKR,aAAa;IAU3B;;OAEG;YACW,cAAc;IAsE5B;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAkCzD,aAAa;IAyB3B;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B3C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAKD,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAKnD"}

package/dist/api/client.js

@@ -0,0 +1,220 @@
+/**
+ * Vinted API HTTP client with session management, rate limiting, and caching.
+ */
+import { TtlCache } from "../utils/cache.js";
+import { RateLimiter } from "../utils/rate-limiter.js";
+import { createSessionProvider } from "./session-provider.js";
+const DEFAULT_DOMAIN = "www.vinted.fr";
+const SESSION_TTL_MS = 10 * 60 * 1000; // 10 minutes
+const REQUEST_TIMEOUT_MS = 15_000;
+const CACHE_TTL_MS = 3 * 60 * 1000; // 3 minutes
+const MAX_RETRIES = 2;
+const RETRY_BASE_DELAY_MS = 1000;
+// Rate limit: 10 requests per 10 seconds (conservative to avoid bans)
+const RATE_LIMIT_REQUESTS = 10;
+const RATE_LIMIT_WINDOW_MS = 10_000;
+export const USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+export class VintedClient {
+    domain;
+    session = null;
+    refreshPromise = null;
+    cache = new TtlCache(CACHE_TTL_MS);
+    rateLimiter = new RateLimiter(RATE_LIMIT_REQUESTS, RATE_LIMIT_WINDOW_MS);
+    inflight = new Map();
+    sessionProvider;
+    constructor(domain, sessionProvider) {
+        this.domain = domain ?? process.env["VINTED_DOMAIN"] ?? DEFAULT_DOMAIN;
+        this.sessionProvider = sessionProvider ?? createSessionProvider();
+    }
+    get baseUrl() {
+        return `https://${this.domain}`;
+    }
+    async doRefreshSession() {
+        this.session = await this.sessionProvider.refreshSession(this.domain);
+    }
+    /**
+     * Coalesce concurrent session refreshes into a single request.
+     */
+    async refreshSession() {
+        if (!this.refreshPromise) {
+            this.refreshPromise = this.doRefreshSession().finally(() => {
+                this.refreshPromise = null;
+            });
+        }
+        return this.refreshPromise;
+    }
+    isSessionValid() {
+        if (!this.session)
+            return false;
+        return Date.now() - this.session.fetchedAt < SESSION_TTL_MS;
+    }
+    async ensureSession() {
+        if (!this.isSessionValid()) {
+            await this.refreshSession();
+        }
+        if (!this.session) {
+            throw new Error("Failed to establish Vinted session");
+        }
+        return this.session.cookie;
+    }
+    /**
+     * Fetch with retry logic for transient errors.
+     */
+    async fetchWithRetry(url, cookie, method = "GET", body) {
+        let lastError = null;
+        let retryDelay = RETRY_BASE_DELAY_MS;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                await new Promise((resolve) => setTimeout(resolve, retryDelay));
+            }
+            try {
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+                try {
+                    const headers = {
+                        "User-Agent": USER_AGENT,
+                        Accept: "application/json, text/plain, */*",
+                        Cookie: cookie,
+                        Referer: `https://${this.domain}/`,
+                        Origin: `https://${this.domain}`,
+                    };
+                    if (body !== undefined) {
+                        headers["Content-Type"] = "application/json";
+                    }
+                    const response = await fetch(url, {
+                        method,
+                        headers,
+                        body: body !== undefined ? JSON.stringify(body) : undefined,
+                        signal: controller.signal,
+                    });
+                    // Return 2xx/3xx immediately
+                    if (response.ok) {
+                        return response;
+                    }
+                    // Don't retry client errors (except 429; auth handled by caller)
+                    if (response.status >= 400 && response.status < 500 && response.status !== 429) {
+                        return response;
+                    }
+                    // Retry on 429 (rate limited) or 5xx - consume body to free connection
+                    const retryAfter = response.headers.get("retry-after");
+                    retryDelay = retryAfter
+                        ? Math.min(parseInt(retryAfter, 10) * 1000, 30_000)
+                        : RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+                    await response.body?.cancel();
+                    lastError = new Error(`Vinted API error: ${response.status} ${response.statusText}`);
+                    continue;
+                }
+                finally {
+                    clearTimeout(timeout);
+                }
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (error instanceof DOMException && error.name === "AbortError") {
+                    lastError = new Error("Request timed out");
+                }
+            }
+        }
+        throw lastError ?? new Error("Request failed after retries");
+    }
+    /**
+     * Make an authenticated, cached, rate-limited GET request to the Vinted API.
+     * Deduplicates concurrent requests for the same URL.
+     */
+    async get(path, params) {
+        const url = new URL(`/api/v2${path}`, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const cacheKey = url.toString();
+        // Check cache first
+        const cached = this.cache.get(cacheKey);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Deduplicate concurrent requests for the same URL
+        const existing = this.inflight.get(cacheKey);
+        if (existing) {
+            return existing;
+        }
+        const promise = this.fetchAndCache(cacheKey);
+        this.inflight.set(cacheKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.inflight.delete(cacheKey);
+        }
+    }
+    async fetchAndCache(cacheKey) {
+        // Ensure session before consuming a rate limit token
+        const cookie = await this.ensureSession();
+        await this.rateLimiter.acquire();
+        let response = await this.fetchWithRetry(cacheKey, cookie);
+        // Handle expired session
+        if (response.status === 401 || response.status === 403) {
+            await response.body?.cancel();
+            this.session = null;
+            const newCookie = await this.ensureSession();
+            response = await this.fetchWithRetry(cacheKey, newCookie);
+        }
+        if (!response.ok) {
+            throw new Error(`Vinted API error: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        this.cache.set(cacheKey, data);
+        return data;
+    }
+    /**
+     * Fetch an HTML page with session, rate limiting, and retry.
+     * Used for scraping item detail pages where the JSON API is unavailable.
+     */
+    async getHtml(url) {
+        const cacheKey = `html:${url}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const cookie = await this.ensureSession();
+        await this.rateLimiter.acquire();
+        let response = await this.fetchWithRetry(url, cookie);
+        if (response.status === 401 || response.status === 403) {
+            await response.body?.cancel();
+            this.session = null;
+            const newCookie = await this.ensureSession();
+            response = await this.fetchWithRetry(url, newCookie);
+        }
+        if (!response.ok) {
+            throw new Error(`Vinted page error: ${response.status} ${response.statusText}`);
+        }
+        const html = await response.text();
+        this.cache.set(cacheKey, html);
+        return html;
+    }
+    /**
+     * Release browser resources held by session providers.
+     */
+    async destroy() {
+        this.cache.destroy();
+        await this.sessionProvider.destroy();
+    }
+}
+/** Singleton client instance */
+let clientInstance = null;
+export function getClient() {
+    if (!clientInstance) {
+        clientInstance = new VintedClient();
+    }
+    return clientInstance;
+}
+export async function destroyClient() {
+    if (clientInstance) {
+        await clientInstance.destroy();
+        clientInstance = null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/session-provider.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+export interface SessionCookies {
+    readonly cookie: string;
+    readonly fetchedAt: number;
+}
+export interface SessionProviderConfig {
+    readonly timeoutMs?: number;
+    readonly executablePath?: string;
+}
+export interface SessionProvider {
+    refreshSession(domain: string): Promise<SessionCookies>;
+    destroy(): Promise<void>;
+}
+export declare class BrowserSessionProvider implements SessionProvider {
+    private readonly config;
+    private browser;
+    constructor(config?: SessionProviderConfig);
+    refreshSession(domain: string): Promise<SessionCookies>;
+    destroy(): Promise<void>;
+    private solveChallenge;
+    private closeBrowser;
+}
+export declare function createSessionProvider(config?: SessionProviderConfig): SessionProvider;
+//# sourceMappingURL=session-provider.d.ts.map

package/dist/api/session-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-provider.d.ts","sourceRoot":"","sources":["../../src/api/session-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAWD,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,OAAO,CAAwB;gBAE3B,MAAM,CAAC,EAAE,qBAAqB;IAIpC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAavD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,cAAc;YAsBd,YAAY;CAW3B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAErF"}