fendi-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,13 +1,16 @@
 # fendi-mcp
 
-Fendi resale listings aggregated from Fashionphile and Rebag public catalogs (prices in USD). No API key required. Not affiliated with or endorsed by Fendi; prices are asking prices, not appraisals.
+Fendi resale listings aggregated from Fashionphile and Rebag public catalogs (prices in USD). No API key required. Condition/color/material attributes are parsed from Rebag catalog data (Fashionphile does not publish them); condition filters apply to Rebag data only. Not affiliated with or endorsed by Fendi; prices are asking prices, not appraisals.
 
 ## Tools
 
-- `search_listings` — Search resale listings by keyword across Fashionphile and Rebag.
-- `list_newest` — Newest catalog listings from both resale sources.
-- `get_listing` — Full listing details by handle.
-- `price_overview` — Ask-price distribution (min/p25/median/p75/max). Asks, not appraisals.
+- `search_listings` — Keyword search across Fashionphile and Rebag. Condition filter is Rebag-data only.
+- `list_newest` — Newest catalog listings, sorted by publish date.
+- `get_listing` — Full details: variants, images, parsed condition/color/material, description.
+- `price_overview` — Ask-price stats overall + by condition.
+- `compare_prices` — Group same-model listings across sources with min/max/spread.
+- `find_deals` — Available listings priced below the brand median.
+- `brand_overview` — Catalog sample counts by source, type and condition.
 
 ## Source
 

package/dist/api.d.ts

@@ -2,7 +2,10 @@ export declare class FendiError extends Error {
     constructor(message: string);
 }
 export declare function errorMessage(e: unknown): string;
-export declare function searchListings(query: string, limit?: string): Promise<string>;
-export declare function listNewest(limit?: string, page?: string): Promise<string>;
+export declare function searchListings(query: string, limit?: string, maxPrice?: string, condition?: string): Promise<string>;
+export declare function listNewest(limit?: string, page?: string, productType?: string, maxPrice?: string, condition?: string): Promise<string>;
 export declare function getListing(handle: string, source?: string): Promise<string>;
 export declare function priceOverview(limit?: string): Promise<string>;
+export declare function comparePrices(query: string, limit?: string): Promise<string>;
+export declare function findDeals(limit?: string, sample?: string): Promise<string>;
+export declare function brandOverview(): Promise<string>;

package/dist/api.js

@@ -9,29 +9,67 @@ export function errorMessage(e) {
 }
 const UA = { "User-Agent": "awesome-mcps/1.0" };
 const VENDORS = ["fendi"];
+const CONDITIONS = ["excellent", "great", "very good", "good", "fair"];
 const SOURCES = [
     {
         name: "fashionphile",
         catalog: "https://www.fashionphile.com/products.json",
         suggest: "https://www.fashionphile.com/search/suggest.json",
         product: (handle) => `https://www.fashionphile.com/products/${encodeURIComponent(handle)}.js`,
+        base: "https://www.fashionphile.com/products",
     },
     {
         name: "rebag",
         catalog: "https://shop.rebag.com/products.json",
         suggest: "https://shop.rebag.com/search/suggest.json",
         product: (handle) => `https://shop.rebag.com/products/${encodeURIComponent(handle)}.js`,
+        base: "https://shop.rebag.com/products",
     },
 ];
 function matchesBrand(vendor) {
     const v = String(vendor ?? "").toLowerCase();
     return VENDORS.some((s) => v.includes(s));
 }
-function slim(source, base, p) {
+function parseCondition(title, tags) {
+    const t = String(title ?? "");
+    const m = t.match(/^(Excellent|Great|Very Good|Good|Fair)\b/i);
+    if (m) {
+        const c = m[1].toLowerCase();
+        return c === "great" ? "great" : c;
+    }
+    if (Array.isArray(tags)) {
+        for (const tag of tags) {
+            const tm = String(tag).match(/^bc-filter-(Excellent|Great|Very Good|Good|Fair)$/i);
+            if (tm)
+                return tm[1].toLowerCase();
+        }
+    }
+    return null;
+}
+function parseTag(tags, prefix) {
+    if (!Array.isArray(tags))
+        return null;
+    for (const tag of tags) {
+        const s = String(tag);
+        if (s.toLowerCase().startsWith(prefix))
+            return s.slice(prefix.length).replace(/‚/g, ",");
+    }
+    return null;
+}
+function slim(source, base, p, cents = false) {
     const variants = Array.isArray(p.variants) ? p.variants : [];
-    const prices = variants.map((v) => Number(v.price)).filter((n) => Number.isFinite(n));
-    const comps = variants.map((v) => Number(v.compare_at_price)).filter((n) => Number.isFinite(n));
+    const varPrices = variants.map((v) => Number(v.price)).filter((n) => Number.isFinite(n));
+    // Suggest-shaped items carry no variants: fall back to top-level price fields.
+    const topPrice = Number(p.price ?? p.price_min);
+    const raw = varPrices.length ? varPrices : (Number.isFinite(topPrice) ? [topPrice] : []);
+    // /products/{handle}.js quotes money in cents; catalog + suggest quote dollars.
+    const prices = cents ? raw.map((x) => Math.round(x) / 100) : raw;
     const images = Array.isArray(p.images) ? p.images : [];
+    const tags = Array.isArray(p.tags) ? p.tags : [];
+    const firstTitle = variants.length ? variants[0].title : "";
+    let material = parseTag(tags, "bc-filter-exterior-material-");
+    if (!material && tags.some((t) => String(t).toLowerCase() === "exotic"))
+        material = "exotic";
     return {
         source,
         id: p.id,
@@ -40,12 +78,19 @@ function slim(source, base, p) {
         vendor: p.vendor,
         product_type: p.product_type,
         price_usd: prices.length ? Math.min(...prices) : null,
-        compare_at_usd: comps.length ? Math.min(...comps) : null,
-        available: variants.some((v) => v.available),
+        available: variants.some((v) => v.available) || p.available === true,
         url: `${base}/${p.handle}`,
-        image: images.length ? images[0].src ?? null : null,
+        image: images.length ? (typeof images[0] === "string" ? images[0] : images[0].src ?? null) : null,
+        condition: parseCondition(firstTitle, tags),
+        color: parseTag(tags, "bc-filter-exterior-color-"),
+        material,
+        published_at: p.published_at ?? null,
     };
 }
+function normCondition(c) {
+    const v = c.trim().toLowerCase();
+    return CONDITIONS.includes(v) ? v : null;
+}
 function pretty(data) {
     const t = typeof data === "string" ? data : JSON.stringify(data, null, 2);
     return t.length > 12000 ? t.slice(0, 12000) + "\n…(truncated)" : t;
@@ -67,17 +112,64 @@ async function catalog(source, page) {
     const products = Array.isArray(data.products) ? data.products : [];
     return products.filter((p) => matchesBrand(p.vendor));
 }
-export async function searchListings(query, limit) {
+// Distilled-pages fetch: several catalog pages in parallel, brand-filtered.
+async function catalogPages(source, pages) {
+    const batches = await Promise.all(pages.map((pg) => catalog(source, pg).catch(() => [])));
+    return batches.flat();
+}
+// Round-robin sampling across sources and pages: keeps the brand sample
+// source-balanced (page 1 alone is often 250 Fashionphile items).
+async function sampleCatalog(maxItems, pages) {
+    const out = [];
+    for (const pg of pages) {
+        for (const s of SOURCES) {
+            if (out.length >= maxItems)
+                break;
+            try {
+                for (const p of await catalog(s, pg)) {
+                    out.push({ source: s, p });
+                    if (out.length >= maxItems)
+                        break;
+                }
+            }
+            catch { /* source down — keep the other */ }
+        }
+        if (out.length >= maxItems)
+            break;
+    }
+    return out;
+}
+function passes(s, maxPrice, condition, productType) {
+    if (maxPrice !== undefined && (s.price_usd === null || s.price_usd > maxPrice))
+        return false;
+    if (condition && s.condition !== condition)
+        return false;
+    if (productType && !s.product_type.toLowerCase().includes(productType.toLowerCase()))
+        return false;
+    return true;
+}
+export async function searchListings(query, limit, maxPrice, condition) {
     const n = Math.min(Number(limit ?? 10) || 10, 25);
+    const mp = maxPrice !== undefined ? Number(maxPrice) : undefined;
+    const cond = condition !== undefined ? normCondition(condition) : undefined;
+    if (condition !== undefined && cond === null)
+        throw new FendiError(`Unknown condition '${condition}'. Use: ${CONDITIONS.join(", ")}.`);
     const out = [];
     for (const s of SOURCES) {
         try {
             const data = await getJson(`${s.suggest}?q=${encodeURIComponent(query)}&resources[type]=product&resources[limit]=${n}`);
             const products = data?.resources?.results?.products ?? [];
-            const base = s.catalog.replace("/products.json", "");
             for (const p of products) {
-                if (matchesBrand(p.vendor))
-                    out.push(slim(s.name, base, p));
+                if (!matchesBrand(p.vendor))
+                    continue;
+                // Suggest items carry no variant titles/tags: condition unknown outside Rebag catalog data.
+                // When a condition filter is set, only items with a known matching condition pass
+                // (Fashionphile suggest hits are omitted — documented limitation).
+                const sl = slim(s.name, s.base, p);
+                if (cond && sl.condition !== cond)
+                    continue;
+                if (passes(sl, mp, null))
+                    out.push(sl);
                 if (out.length >= n)
                     break;
             }
@@ -86,20 +178,27 @@ export async function searchListings(query, limit) {
         if (out.length >= n)
             break;
     }
-    return pretty({ brand: "Fendi", query, count: out.length, listings: out.slice(0, n) });
+    return pretty({ brand: "Fendi", query, count: out.length, condition_filter: cond ?? null, listings: out.slice(0, n) });
 }
-export async function listNewest(limit, page) {
+export async function listNewest(limit, page, productType, maxPrice, condition) {
     const n = Math.min(Number(limit ?? 20) || 20, 50);
     const pg = Math.max(Number(page ?? 1) || 1, 1);
+    const mp = maxPrice !== undefined ? Number(maxPrice) : undefined;
+    const cond = condition !== undefined ? normCondition(condition) : undefined;
+    if (condition !== undefined && cond === null)
+        throw new FendiError(`Unknown condition '${condition}'. Use: ${CONDITIONS.join(", ")}.`);
     const out = [];
     for (const s of SOURCES) {
         try {
-            const base = s.catalog.replace("/products.json", "");
-            for (const p of await catalog(s, pg))
-                out.push(slim(s.name, base, p));
+            for (const p of await catalog(s, pg)) {
+                const sl = slim(s.name, s.base, p);
+                if (passes(sl, mp, cond ?? undefined, productType))
+                    out.push(sl);
+            }
         }
         catch { /* source down — keep the other */ }
     }
+    out.sort((a, b) => String(b.published_at ?? "").localeCompare(String(a.published_at ?? "")));
     return pretty({ brand: "Fendi", page: pg, count: out.length, listings: out.slice(0, n) });
 }
 export async function getListing(handle, source) {
@@ -108,7 +207,21 @@ export async function getListing(handle, source) {
         throw new FendiError(`Unknown source '${source}'. Use fashionphile or rebag.`);
     for (const s of sources) {
         try {
-            return pretty({ brand: "Fendi", source: s.name, product: await getJson(s.product(handle)) });
+            const p = await getJson(s.product(handle));
+            const sl = slim(s.name, s.base, p, true);
+            const rawVars = Array.isArray(p.variants) ? p.variants : [];
+            const variants = rawVars.map((v) => ({
+                title: v.title, price_usd: Math.round(Number(v.price)) / 100, available: v.available,
+                condition: parseCondition(v.title, p.tags),
+            }));
+            const images = (Array.isArray(p.images) ? p.images : []).map((i) => typeof i === "string" ? i : i.src).filter(Boolean);
+            const html = typeof p.body_html === "string" ? p.body_html : (typeof p.description === "string" ? p.description : "");
+            const dollar = variants.length && Number.isFinite(variants[0].price_usd) ? variants[0].price_usd : sl.price_usd;
+            return pretty({
+                brand: "Fendi", ...sl, price_usd: dollar, variants, images,
+                description: html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim().slice(0, 1500) || null,
+                tags: p.tags,
+            });
         }
         catch { /* try next source */ }
     }
@@ -117,29 +230,116 @@ export async function getListing(handle, source) {
 export async function priceOverview(limit) {
     const n = Math.min(Number(limit ?? 200) || 200, 500);
     const prices = [];
+    const byCondition = {};
+    for (const { source: s, p } of await sampleCatalog(n, [1, 2, 3, 4, 5])) {
+        const sl = slim(s.name, s.base, p);
+        if (sl.price_usd === null)
+            continue;
+        prices.push(sl.price_usd);
+        const c = sl.condition ?? "unknown";
+        if (!byCondition[c])
+            byCondition[c] = [];
+        byCondition[c].push(sl.price_usd);
+    }
+    if (!prices.length)
+        throw new FendiError("No priced listings found.");
+    const stats = (arr) => {
+        const a = [...arr].sort((x, y) => x - y);
+        const mid = a.length % 2 ? a[(a.length - 1) / 2] : (a[a.length / 2 - 1] + a[a.length / 2]) / 2;
+        return { n: a.length, min: a[0], median: mid, max: a[a.length - 1] };
+    };
+    const condStats = {};
+    for (const [c, arr] of Object.entries(byCondition))
+        condStats[c] = stats(arr);
+    return pretty({
+        brand: "Fendi", currency: "USD", overall: stats(prices), by_condition: condStats,
+        note: "Asking prices on resale sources, not appraisals. Not affiliated with Fendi.",
+    });
+}
+function normTitle(t) {
+    return t.toLowerCase().replace(/[^a-z0-9]+/g, " ").replace(/\s+/g, " ").trim();
+}
+export async function comparePrices(query, limit) {
+    const n = Math.min(Number(limit ?? 30) || 30, 60);
+    const all = [];
     for (const s of SOURCES) {
         try {
-            const base = s.catalog.replace("/products.json", "");
-            for (const p of await catalog(s, 1)) {
-                const sl = slim(s.name, base, p);
-                if (sl.price_usd !== null)
-                    prices.push(sl.price_usd);
-                if (prices.length >= n)
-                    break;
+            const data = await getJson(`${s.suggest}?q=${encodeURIComponent(query)}&resources[type]=product&resources[limit]=${n}`);
+            const products = data?.resources?.results?.products ?? [];
+            for (const p of products) {
+                if (matchesBrand(p.vendor))
+                    all.push(slim(s.name, s.base, p));
             }
         }
         catch { /* source down — keep the other */ }
-        if (prices.length >= n)
-            break;
     }
-    if (!prices.length)
-        throw new FendiError("No priced listings found.");
-    prices.sort((a, b) => a - b);
-    const mid = (arr) => arr.length % 2 ? arr[(arr.length - 1) / 2] : (arr[arr.length / 2 - 1] + arr[arr.length / 2]) / 2;
+    const groups = new Map();
+    for (const sl of all) {
+        const key = normTitle(sl.title);
+        if (!groups.has(key))
+            groups.set(key, []);
+        groups.get(key).push(sl);
+    }
+    const rows = [...groups.entries()].map(([model, items]) => {
+        const ps = items.map((i) => i.price_usd).filter((x) => x !== null);
+        return {
+            model: items[0].title, count: items.length,
+            sources: [...new Set(items.map((i) => i.source))],
+            min_usd: ps.length ? Math.min(...ps) : null,
+            max_usd: ps.length ? Math.max(...ps) : null,
+            spread_usd: ps.length > 1 ? Math.max(...ps) - Math.min(...ps) : 0,
+            listings: items.map((i) => ({ source: i.source, price_usd: i.price_usd, condition: i.condition, url: i.url })),
+        };
+    }).sort((a, b) => (b.spread_usd ?? 0) - (a.spread_usd ?? 0));
+    return pretty({ brand: "Fendi", query, groups: rows.length, rows: rows.slice(0, 15) });
+}
+export async function findDeals(limit, sample) {
+    const n = Math.min(Number(limit ?? 10) || 10, 25);
+    const per = Math.min(Number(sample ?? 200) || 200, 500);
+    const all = [];
+    for (const { source: s, p } of await sampleCatalog(per, [1, 2, 3, 4, 5])) {
+        const sl = slim(s.name, s.base, p);
+        if (sl.price_usd !== null && sl.available)
+            all.push(sl);
+    }
+    if (!all.length)
+        throw new FendiError("No available priced listings found.");
+    const ps = all.map((s) => s.price_usd).sort((a, b) => a - b);
+    const median = ps.length % 2 ? ps[(ps.length - 1) / 2] : (ps[ps.length / 2 - 1] + ps[ps.length / 2]) / 2;
+    const deals = all
+        .filter((s) => s.price_usd < median)
+        .map((s) => ({ ...s, vs_median_usd: Math.round((s.price_usd - median) * 100) / 100, vs_median_pct: Math.round(((s.price_usd - median) / median) * 1000) / 10 }))
+        .sort((a, b) => a.vs_median_pct - b.vs_median_pct);
     return pretty({
-        brand: "Fendi", currency: "USD", sample: prices.length,
-        min: prices[0], p25: prices[Math.floor(prices.length * 0.25)],
-        median: mid(prices), p75: prices[Math.floor(prices.length * 0.75)], max: prices[prices.length - 1],
-        note: "Asking prices on resale sources, not appraisals. Not affiliated with Fendi.",
+        brand: "Fendi", sample: all.length, brand_median_usd: median, count: Math.min(deals.length, n),
+        deals: deals.slice(0, n),
+        note: "Below-median asks, not appraisals or authenticity guarantees. Not affiliated with Fendi.",
+    });
+}
+export async function brandOverview() {
+    const bySource = {};
+    const byType = {};
+    const byCondition = {};
+    let total = 0;
+    for (const s of SOURCES) {
+        try {
+            const items = await catalogPages(s, [1, 2]);
+            bySource[s.name] = items.length;
+            for (const p of items) {
+                const sl = slim(s.name, s.base, p);
+                total++;
+                byType[sl.product_type || "unknown"] = (byType[sl.product_type || "unknown"] ?? 0) + 1;
+                const c = sl.condition ?? "unknown";
+                byCondition[c] = (byCondition[c] ?? 0) + 1;
+            }
+        }
+        catch {
+            bySource[s.name] = -1;
+        }
+    }
+    return pretty({
+        brand: "Fendi", catalog_sample: total, by_source: bySource,
+        by_product_type: byType, by_condition: byCondition,
+        note: "Sample of newest ~500 listings per source. Not affiliated with Fendi.",
     });
 }

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { errorMessage, searchListings, listNewest, getListing, priceOverview, } from "./api.js";
+import { errorMessage, searchListings, listNewest, getListing, priceOverview, comparePrices, findDeals, brandOverview, } from "./api.js";
 const text = (t) => ({ content: [{ type: "text", text: t }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -11,15 +11,17 @@ export function createServer() {
     });
     server.registerTool("search_listings", {
         title: "Search listings",
-        description: "Search resale listings by keyword across Fashionphile and Rebag.",
+        description: "Keyword search across Fashionphile and Rebag. Condition filter is Rebag-data only.",
         inputSchema: z.object({
             query: z.string().describe("Keyword, e.g. speedy, birkin, submariner."),
-            limit: z.string().describe("Max results (default 10, max 25).").optional()
+            limit: z.string().describe("Max results (default 10, max 25).").optional(),
+            max_price: z.string().describe("Max USD price.").optional(),
+            condition: z.string().describe("excellent, great, very good, good, fair (Rebag data only).").optional()
         }),
         annotations: READ_ONLY,
-    }, async ({ query, limit }) => {
+    }, async ({ query, limit, max_price: maxPrice, condition }) => {
         try {
-            return text(await searchListings(query, limit));
+            return text(await searchListings(query, limit, maxPrice, condition));
         }
         catch (e) {
             return textError(errorMessage(e));
@@ -27,15 +29,18 @@ export function createServer() {
     });
     server.registerTool("list_newest", {
         title: "Newest listings",
-        description: "Newest catalog listings from both resale sources.",
+        description: "Newest catalog listings, sorted by publish date.",
         inputSchema: z.object({
             limit: z.string().describe("Max results (default 20, max 50).").optional(),
-            page: z.string().describe("Catalog page (default 1).").optional()
+            page: z.string().describe("Catalog page (default 1).").optional(),
+            product_type: z.string().describe("Filter, e.g. Bags, Watches, Jewelry.").optional(),
+            max_price: z.string().describe("Max USD price.").optional(),
+            condition: z.string().describe("excellent, great, very good, good, fair (Rebag data only).").optional()
         }),
         annotations: READ_ONLY,
-    }, async ({ limit, page }) => {
+    }, async ({ limit, page, product_type: productType, max_price: maxPrice, condition }) => {
         try {
-            return text(await listNewest(limit, page));
+            return text(await listNewest(limit, page, productType, maxPrice, condition));
         }
         catch (e) {
             return textError(errorMessage(e));
@@ -43,7 +48,7 @@ export function createServer() {
     });
     server.registerTool("get_listing", {
         title: "Get listing",
-        description: "Full listing details by handle.",
+        description: "Full details: variants, images, parsed condition/color/material, description.",
         inputSchema: z.object({
             handle: z.string().describe("Product handle/slug."),
             source: z.string().describe("fashionphile or rebag (tries both).").optional()
@@ -59,7 +64,7 @@ export function createServer() {
     });
     server.registerTool("price_overview", {
         title: "Price overview",
-        description: "Ask-price distribution (min/p25/median/p75/max). Asks, not appraisals.",
+        description: "Ask-price stats overall + by condition.",
         inputSchema: z.object({
             limit: z.string().describe("Sample size (default 200, max 500).").optional()
         }),
@@ -72,5 +77,50 @@ export function createServer() {
             return textError(errorMessage(e));
         }
     });
+    server.registerTool("compare_prices", {
+        title: "Compare prices",
+        description: "Group same-model listings across sources with min/max/spread.",
+        inputSchema: z.object({
+            query: z.string().describe("Model keyword, e.g. neverfull, daytona."),
+            limit: z.string().describe("Suggest depth per source (default 30, max 60).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ query, limit }) => {
+        try {
+            return text(await comparePrices(query, limit));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("find_deals", {
+        title: "Find deals",
+        description: "Available listings priced below the brand median.",
+        inputSchema: z.object({
+            limit: z.string().describe("Max deals (default 10, max 25).").optional(),
+            sample: z.string().describe("Listings sampled (default 200, max 500).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ limit, sample }) => {
+        try {
+            return text(await findDeals(limit, sample));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("brand_overview", {
+        title: "Brand overview",
+        description: "Catalog sample counts by source, type and condition.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async ({}) => {
+        try {
+            return text(await brandOverview());
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
     return server;
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "fendi-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Fendi resale listings from Fashionphile and Rebag. Keyless.",
   "type": "module",
   "mcpName": "io.github.mrfentmen/fendi-mcp",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mrfentmen/awesome-mcps.git"
+    "url": "https://github.com/mrfentmen/premium-mcps.git"
   },
   "bin": {
     "fendi-mcp": "./dist/index.js"