secondhand-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# Secondhand MCP
+
+An MCP server for searching secondary marketplaces. Lets Claude and other AI assistants search for deals on Facebook Marketplace and eBay.
+
+## Features
+
+- Search multiple marketplaces from a single interface
+- Price filtering with min/max ranges
+- Location-based search by city
+- Detailed listing inspection (photos, descriptions, seller info)
+- Availability filtering — sold/pending items excluded by default
+- Works with Claude Desktop, Claude Code, Cursor, and other MCP clients
+- Lightweight — no browser dependencies, native HTTP requests
+
+## Supported Marketplaces
+
+| Marketplace | Status | Auth Required |
+|-------------|--------|---------------|
+| Facebook Marketplace | Working | No |
+| eBay | Working | Yes (API keys) |
+
+## Setup
+
+### From Source
+
+```bash
+git clone https://github.com/jlsookiki/secondhand-mcp.git
+cd secondhand-mcp
+npm install
+npm run build
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "secondhand": {
+      "command": "npx",
+      "args": ["-y", "secondhand-mcp"],
+      "env": {
+        "EBAY_CLIENT_ID": "your-ebay-client-id",
+        "EBAY_CLIENT_SECRET": "your-ebay-client-secret"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to `~/.claude/.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "secondhand": {
+      "command": "npx",
+      "args": ["-y", "secondhand-mcp"],
+      "env": {
+        "EBAY_CLIENT_ID": "your-ebay-client-id",
+        "EBAY_CLIENT_SECRET": "your-ebay-client-secret"
+      }
+    }
+  }
+}
+```
+
+eBay credentials are optional — if omitted, eBay will be disabled and only Facebook Marketplace will be available.
+
+## Configuration
+
+### Choosing Marketplaces
+
+By default all marketplaces are enabled. To limit which marketplaces are active, set the `MARKETPLACES` env var (comma-separated):
+
+```json
+{
+  "env": {
+    "MARKETPLACES": "facebook",
+    "EBAY_CLIENT_ID": "...",
+    "EBAY_CLIENT_SECRET": "..."
+  }
+}
+```
+
+Valid values: `facebook`, `ebay`
+
+### eBay API Keys
+
+eBay uses the official [Browse API](https://developer.ebay.com/api-docs/buy/browse/overview.html). You need a free eBay developer account:
+
+1. Create an account at [developer.ebay.com](https://developer.ebay.com)
+2. Create an application to get a Client ID and Client Secret
+3. Add them to your MCP config as `EBAY_CLIENT_ID` and `EBAY_CLIENT_SECRET`
+
+## Tools
+
+### `search_marketplace`
+
+Search for items across marketplaces. Returns a summary per listing: **title, price, location, listing ID, and photo count**.
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `query` | Yes | | Search terms |
+| `marketplace` | No | `facebook` | `facebook`, `ebay`, or `all` |
+| `location` | No | `san francisco` | City to search in (Facebook only) |
+| `maxPrice` | No | | Maximum price |
+| `minPrice` | No | | Minimum price |
+| `limit` | No | `20` | Max results |
+| `showSold` | No | `false` | Include sold/unavailable items (Facebook only) |
+| `includeImages` | No | `false` | Include image URLs in output |
+
+**Data returned per marketplace:**
+
+| Field | Facebook | eBay |
+|-------|----------|------|
+| Title | Yes | Yes |
+| Price | Yes | Yes |
+| Location | City name | City, State |
+| Condition | No | Yes |
+| Photo count | Yes (1 thumbnail) | Yes (1 thumbnail) |
+| Seller | Yes | Yes |
+
+### `get_listing_details`
+
+Get full details for a specific listing using an ID from search results.
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `listingId` | Yes | | Listing ID from search results |
+| `marketplace` | No | `facebook` | `facebook` or `ebay` |
+
+**Data returned per marketplace:**
+
+| Field | Facebook | eBay |
+|-------|----------|------|
+| Description | Yes | Yes |
+| All photos | Yes | Yes |
+| Location | City | City, State, Country |
+| Seller | Name | Username |
+| Delivery types | Yes | No |
+| Shipping options | Yes/No flag | Service codes |
+
+### `list_marketplaces`
+
+List all enabled marketplaces and their status.
+
+## Example Output
+
+```
+Found 15 listings for "stroller" on facebook
+Location: san francisco
+
+**$25** - Baby stroller
+   San Francisco, CA
+   ID: 123456789
+   1 photo
+
+**$50** - Thule Urban Glide Jogging Stroller
+   San Francisco, CA
+   ID: 987654321
+   1 photo
+```
+
+Use `get_listing_details` with a listing ID to see full photos, description, and seller info.
+
+## How It Works
+
+**Facebook Marketplace** — Uses Facebook's internal GraphQL API to search listings directly. No login, no browser automation. Resolves city names to coordinates, then searches with location/price/query filters. Uses undocumented `doc_id` endpoints that may need updating if Facebook changes their frontend.
+
+**eBay** — Uses the official eBay Browse API with OAuth 2.0 client credentials. Tokens are cached and auto-refreshed.
+
+## Adding New Marketplaces
+
+1. Create a new file in `src/marketplaces/` (e.g., `craigslist.ts`)
+2. Extend `BaseMarketplace` and implement `search()` and optionally `getListingDetails()`
+3. Add the constructor to the `allMarketplaces` registry in `src/marketplaces/index.ts`
+
+## Development
+
+```bash
+npm install
+npm run build
+```
+
+## Limitations
+
+- **Facebook Marketplace**: Uses undocumented GraphQL API — may break if Facebook changes `doc_id` values (constants in `src/marketplaces/facebook.ts`)
+- **Rate limiting**: Don't make too many requests too quickly
+- **eBay**: Requires developer API keys (free tier available)
+
+## License
+
+MIT
+
+## Disclaimer
+
+This tool is for personal use. Respect each marketplace's Terms of Service.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Secondhand MCP Server
+ *
+ * An MCP server for searching secondary marketplaces like
+ * Facebook Marketplace, eBay, Craigslist, and more.
+ */
+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":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,349 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Secondhand MCP Server
+ *
+ * An MCP server for searching secondary marketplaces like
+ * Facebook Marketplace, eBay, Craigslist, and more.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const marketplaces_1 = require("./marketplaces");
+// Initialize marketplaces
+(0, marketplaces_1.initializeMarketplaces)();
+// Define available tools
+const tools = [
+    {
+        name: 'search_marketplace',
+        description: `Search for items on secondary marketplaces. Supports: ${(0, marketplaces_1.listMarketplaceNames)().join(', ')}. Returns listing ID, title, price, location, and photo count. Facebook: location-based search, no auth. eBay: keyword search with condition filter, requires API keys. Use get_listing_details with a listing ID for full description, all photos, seller info, and shipping options.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (e.g., "stroller", "iPhone 14", "vintage couch")'
+                },
+                marketplace: {
+                    type: 'string',
+                    description: `Marketplace to search. Options: ${(0, marketplaces_1.listMarketplaceNames)().join(', ')}, or "all" to search all marketplaces`,
+                    default: 'facebook'
+                },
+                location: {
+                    type: 'string',
+                    description: 'City or area to search (e.g., "san francisco", "nyc", "los angeles")',
+                    default: 'san francisco'
+                },
+                maxPrice: {
+                    type: 'number',
+                    description: 'Maximum price filter (optional)'
+                },
+                minPrice: {
+                    type: 'number',
+                    description: 'Minimum price filter (optional)'
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default: 20)',
+                    default: 20
+                },
+                showSold: {
+                    type: 'boolean',
+                    description: 'Include sold/unavailable items in results (default: false)',
+                    default: false
+                },
+                includeImages: {
+                    type: 'boolean',
+                    description: 'Include full image URLs in results (default: false). Use get_listing_details for full photos.',
+                    default: false
+                }
+            },
+            required: ['query']
+        }
+    },
+    {
+        name: 'get_listing_details',
+        description: 'Get full details for a specific listing using an ID from search results. Facebook returns: description, all photos, location, seller name, delivery types, shipping availability. eBay returns: description, all photos, location (city/state/country), seller username, shipping service options.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingId: {
+                    type: 'string',
+                    description: 'The listing ID (from search results or a marketplace URL)'
+                },
+                marketplace: {
+                    type: 'string',
+                    description: 'Which marketplace the listing is from (default: facebook)',
+                    default: 'facebook'
+                }
+            },
+            required: ['listingId']
+        }
+    },
+    {
+        name: 'list_marketplaces',
+        description: 'List all available marketplaces and their status',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    }
+];
+// Create server
+const server = new index_js_1.Server({
+    name: 'secondhand-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle tool listing
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// Handle tool calls
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case 'search_marketplace': {
+            const params = args;
+            const searchParams = {
+                query: params.query,
+                location: params.location || 'san francisco',
+                maxPrice: params.maxPrice,
+                minPrice: params.minPrice,
+                limit: params.limit || 20,
+                showSold: params.showSold || false,
+            };
+            const marketplaceName = params.marketplace || 'facebook';
+            if (marketplaceName === 'all') {
+                // Search all marketplaces
+                const results = [];
+                for (const mp of (0, marketplaces_1.getAllMarketplaces)()) {
+                    try {
+                        const result = await mp.search(searchParams);
+                        results.push(result);
+                    }
+                    catch (error) {
+                        results.push({
+                            marketplace: mp.name,
+                            success: false,
+                            listings: [],
+                            error: String(error)
+                        });
+                    }
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatMultipleResults(results, searchParams, params.includeImages || false)
+                        }
+                    ]
+                };
+            }
+            else {
+                // Search specific marketplace
+                const marketplace = (0, marketplaces_1.getMarketplace)(marketplaceName);
+                if (!marketplace) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Unknown marketplace: ${marketplaceName}. Available: ${(0, marketplaces_1.listMarketplaceNames)().join(', ')}`
+                            }
+                        ],
+                        isError: true
+                    };
+                }
+                try {
+                    const result = await marketplace.search(searchParams);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: formatSingleResult(result, searchParams, params.includeImages || false)
+                            }
+                        ]
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Error searching ${marketplace.displayName}: ${error}`
+                            }
+                        ],
+                        isError: true
+                    };
+                }
+            }
+        }
+        case 'get_listing_details': {
+            const { listingId, marketplace: mpName } = args;
+            if (!listingId) {
+                return {
+                    content: [{ type: 'text', text: 'Missing required parameter: listingId' }],
+                    isError: true,
+                };
+            }
+            try {
+                const targetMp = mpName || 'facebook';
+                let details;
+                if (targetMp === 'ebay') {
+                    const ebay = (0, marketplaces_1.getMarketplace)('ebay');
+                    details = await ebay.getListingDetails(listingId);
+                }
+                else {
+                    const fb = (0, marketplaces_1.getMarketplace)('facebook');
+                    details = await fb.getListingDetails(listingId);
+                }
+                return {
+                    content: [{ type: 'text', text: formatListingDetails(details) }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: `Error fetching listing details: ${error}` }],
+                    isError: true,
+                };
+            }
+        }
+        case 'list_marketplaces': {
+            const marketplaces = (0, marketplaces_1.getAllMarketplaces)();
+            const info = marketplaces.map(mp => ({
+                name: mp.name,
+                displayName: mp.displayName,
+                requiresAuth: mp.requiresAuth
+            }));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Available Marketplaces:\n\n${info.map(m => `• ${m.displayName} (${m.name}) - ${m.requiresAuth ? 'Requires auth' : 'No auth required'}`).join('\n')}`
+                    }
+                ]
+            };
+        }
+        default:
+            return {
+                content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                isError: true
+            };
+    }
+});
+// Format results for display
+function formatSingleResult(result, params, includeImages) {
+    if (!result.success) {
+        return `❌ ${result.marketplace}: ${result.error}`;
+    }
+    if (result.listings.length === 0) {
+        return `No listings found for "${params.query}" in ${params.location}`;
+    }
+    const lines = [
+        `🔍 Found ${result.listings.length} listings for "${params.query}" on ${result.marketplace}`,
+        `📍 Location: ${params.location}`,
+        ''
+    ];
+    // Sort by price
+    const sorted = [...result.listings].sort((a, b) => (a.priceNumeric || 0) - (b.priceNumeric || 0));
+    for (const listing of sorted) {
+        lines.push(`**${listing.price}** - ${listing.title}`);
+        if (listing.location) {
+            lines.push(`   📍 ${listing.location}`);
+        }
+        lines.push(`   🆔 ${listing.id}`);
+        if (listing.images && listing.images.length > 0) {
+            if (includeImages) {
+                lines.push(`   🖼️ Images: ${listing.images.join(' , ')}`);
+            }
+            else {
+                lines.push(`   📷 ${listing.images.length} photo${listing.images.length > 1 ? 's' : ''}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatMultipleResults(results, params, includeImages) {
+    const lines = [
+        `🔍 Search results for "${params.query}" across all marketplaces`,
+        `📍 Location: ${params.location}`,
+        ''
+    ];
+    for (const result of results) {
+        lines.push(`## ${result.marketplace}`);
+        if (!result.success) {
+            lines.push(`❌ Error: ${result.error}`);
+        }
+        else if (result.listings.length === 0) {
+            lines.push('No listings found');
+        }
+        else {
+            lines.push(`Found ${result.listings.length} listings:`);
+            const sorted = [...result.listings].sort((a, b) => (a.priceNumeric || 0) - (b.priceNumeric || 0)).slice(0, 10); // Top 10 per marketplace
+            for (const listing of sorted) {
+                lines.push(`  • **${listing.price}** - ${listing.title}`);
+                if (listing.images && listing.images.length > 0) {
+                    if (includeImages) {
+                        lines.push(`    🖼️ Images: ${listing.images.join(' , ')}`);
+                    }
+                    else {
+                        lines.push(`    📷 ${listing.images.length} photo${listing.images.length > 1 ? 's' : ''}`);
+                    }
+                }
+                lines.push(`    🆔 ${listing.id}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatListingDetails(details) {
+    const lines = [
+        `📋 Listing Details`,
+        `🔗 ${details.url}`,
+        '',
+    ];
+    if (details.description) {
+        lines.push(`**Description:** ${details.description}`);
+        lines.push('');
+    }
+    if (details.location) {
+        lines.push(`📍 ${details.location}`);
+    }
+    if (details.seller) {
+        lines.push(`👤 Seller: ${details.seller}`);
+    }
+    if (details.deliveryTypes && details.deliveryTypes.length > 0) {
+        lines.push(`🚚 Delivery: ${details.deliveryTypes.join(', ')}`);
+    }
+    if (details.isShippingOffered) {
+        lines.push(`📦 Shipping available`);
+    }
+    if (details.images.length > 0) {
+        lines.push('');
+        lines.push(`🖼️ Photos (${details.images.length}):`);
+        for (const img of details.images) {
+            lines.push(`   ${img}`);
+        }
+    }
+    return lines.join('\n');
+}
+// Start server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Secondhand MCP server started');
+}
+// Clean shutdown
+process.on('SIGINT', () => process.exit(0));
+process.on('SIGTERM', () => process.exit(0));
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    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;;;;;GAKG;;AAEH,wEAAmE;AACnE,wEAAiF;AACjF,iEAI4C;AAG5C,iDAOwB;AAExB,0BAA0B;AAC1B,IAAA,qCAAsB,GAAE,CAAC;AAEzB,yBAAyB;AACzB,MAAM,KAAK,GAAW;IACpB;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,yDAAyD,IAAA,mCAAoB,GAAE,CAAC,IAAI,CAAC,IAAI,CAAC,wRAAwR;QAC/X,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+DAA+D;iBAC7E;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC,IAAA,mCAAoB,GAAE,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC;oBACxH,OAAO,EAAE,UAAU;iBACpB;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sEAAsE;oBACnF,OAAO,EAAE,eAAe;iBACzB;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;oBAChE,OAAO,EAAE,EAAE;iBACZ;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,4DAA4D;oBACzE,OAAO,EAAE,KAAK;iBACf;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,+FAA+F;oBAC5G,OAAO,EAAE,KAAK;iBACf;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,oSAAoS;QACjT,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;oBACxE,OAAO,EAAE,UAAU;iBACpB;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,kDAAkD;QAC/D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB;IACE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,sBAAsB;AACtB,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC,CAAC,CAAC;AAEH,oBAAoB;AACpB,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,IASd,CAAC;YAEF,MAAM,YAAY,GAAiB;gBACjC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,eAAe;gBAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;aACnC,CAAC;YAEF,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,IAAI,UAAU,CAAC;YAEzD,IAAI,eAAe,KAAK,KAAK,EAAE,CAAC;gBAC9B,0BAA0B;gBAC1B,MAAM,OAAO,GAAmB,EAAE,CAAC;gBACnC,KAAK,MAAM,EAAE,IAAI,IAAA,iCAAkB,GAAE,EAAE,CAAC;oBACtC,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;wBAC7C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACvB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,IAAI,CAAC;4BACX,WAAW,EAAE,EAAE,CAAC,IAAI;4BACpB,OAAO,EAAE,KAAK;4BACd,QAAQ,EAAE,EAAE;4BACZ,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;yBACrB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC;yBAClF;qBACF;iBACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,MAAM,WAAW,GAAG,IAAA,6BAAc,EAAC,eAAe,CAAC,CAAC;gBACpD,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,wBAAwB,eAAe,gBAAgB,IAAA,mCAAoB,GAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;6BACjG;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACtD,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC;6BAC9E;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,mBAAmB,WAAW,CAAC,WAAW,KAAK,KAAK,EAAE;6BAC7D;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAG1C,CAAC;YAEF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,EAAE,CAAC;oBAC1E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,UAAU,CAAC;gBACtC,IAAI,OAAuB,CAAC;gBAE5B,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACxB,MAAM,IAAI,GAAG,IAAA,6BAAc,EAAC,MAAM,CAAoB,CAAC;oBACvD,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,GAAG,IAAA,6BAAc,EAAC,UAAU,CAAwB,CAAC;oBAC7D,OAAO,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBAClD,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;iBACjE,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mCAAmC,KAAK,EAAE,EAAE,CAAC;oBAC7E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,YAAY,GAAG,IAAA,iCAAkB,GAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACnC,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,YAAY,EAAE,EAAE,CAAC,YAAY;aAC9B,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8BAA8B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC/C,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAC5F,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACf;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBAC1D,OAAO,EAAE,IAAI;aACd,CAAC;IACN,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,6BAA6B;AAC7B,SAAS,kBAAkB,CAAC,MAAoB,EAAE,MAAoB,EAAE,aAAsB;IAC5F,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,0BAA0B,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,kBAAkB,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,WAAW,EAAE;QAC5F,gBAAgB,MAAM,CAAC,QAAQ,EAAE;QACjC,EAAE;KACH,CAAC;IAEF,gBAAgB;IAChB,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAChD,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAC9C,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,IAAI,aAAa,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAuB,EAAE,MAAoB,EAAE,aAAsB;IAClG,MAAM,KAAK,GAAG;QACZ,0BAA0B,MAAM,CAAC,KAAK,2BAA2B;QACjE,gBAAgB,MAAM,CAAC,QAAQ,EAAE;QACjC,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAEvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY,CAAC,CAAC;YAExD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAChD,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAC9C,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,yBAAyB;YAEzC,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,KAAK,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1D,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,IAAI,aAAa,EAAE,CAAC;wBAClB,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAC9D,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,MAAM,CAAC,MAAM,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7F,CAAC;gBACH,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAuB;IACnD,MAAM,KAAK,GAAG;QACZ,oBAAoB;QACpB,MAAM,OAAO,CAAC,GAAG,EAAE;QACnB,EAAE;KACH,CAAC;IAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QACrD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACjD,CAAC;AAED,iBAAiB;AACjB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7C,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/marketplaces/base.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Base interface for all marketplace implementations
+ */
+import { SearchParams, SearchResult, LocationCoordinates } from '../types';
+export interface Marketplace {
+    /** Unique identifier for this marketplace */
+    readonly name: string;
+    /** Human-readable display name */
+    readonly displayName: string;
+    /** Whether this marketplace requires authentication */
+    readonly requiresAuth: boolean;
+    /** Search for listings */
+    search(params: SearchParams): Promise<SearchResult>;
+    /** Get location coordinates for a city/area (if supported) */
+    getLocation?(query: string): Promise<LocationCoordinates | null>;
+    /** Check if the marketplace is accessible */
+    healthCheck(): Promise<boolean>;
+}
+export declare abstract class BaseMarketplace implements Marketplace {
+    abstract readonly name: string;
+    abstract readonly displayName: string;
+    abstract readonly requiresAuth: boolean;
+    abstract search(params: SearchParams): Promise<SearchResult>;
+    healthCheck(): Promise<boolean>;
+    protected parsePrice(priceStr: string): {
+        numeric: number;
+        currency: string;
+    } | null;
+    protected createError(message: string): SearchResult;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/marketplaces/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/marketplaces/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,0BAA0B;IAC1B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpD,8DAA8D;IAC9D,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAEjE,6CAA6C;IAC7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,8BAAsB,eAAgB,YAAW,WAAW;IAC1D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAExC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAEtD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWpF,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;CAQrD"}

package/dist/marketplaces/base.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Base interface for all marketplace implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseMarketplace = void 0;
+class BaseMarketplace {
+    async healthCheck() {
+        return true;
+    }
+    parsePrice(priceStr) {
+        // Handle common price formats: $50, $1,234.56, €50, £50
+        const match = priceStr.match(/([£€$])?[\s]*([\d,]+(?:\.\d{2})?)/);
+        if (!match)
+            return null;
+        const currency = match[1] || '$';
+        const numeric = parseFloat(match[2].replace(/,/g, ''));
+        return { numeric, currency };
+    }
+    createError(message) {
+        return {
+            marketplace: this.name,
+            success: false,
+            listings: [],
+            error: message
+        };
+    }
+}
+exports.BaseMarketplace = BaseMarketplace;
+//# sourceMappingURL=base.js.map

package/dist/marketplaces/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/marketplaces/base.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAwBH,MAAsB,eAAe;IAOnC,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAES,UAAU,CAAC,QAAgB;QACnC,wDAAwD;QACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAEvD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAES,WAAW,CAAC,OAAe;QACnC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,OAAO;SACf,CAAC;IACJ,CAAC;CACF;AA9BD,0CA8BC"}