@pullapi/ebay-scraper-mcp 1.0.0

package/README.md

@@ -0,0 +1,104 @@
+# eBay Scraper MCP Server
+
+An MCP server that provides real-time eBay data — search products, get listing details, view seller profiles, and research sold item prices — for use with Claude, Cursor, and other MCP-compatible AI tools.
+
+## Features
+
+- **Get Product** — Get eBay product listing details including price, condition, seller info, and specifications
+- **Search Products** — Search eBay for products with filters for condition, price, and sorting
+- **Get Seller** — Get eBay seller profile including feedback, items sold, and store info
+- **Get Sold Items** — Get recently sold/completed eBay listings for price research
+
+## Tools
+
+### get_product
+
+Get eBay product listing details including price, condition, seller info, and specifications
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `item_id` | string | Yes | eBay item ID |
+
+### search_products
+
+Search eBay for products with filters for condition, price, and sorting
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `query` | string | Yes | Search query |
+| `sort` | string | No | Sort order (default: best_match) — one of: `best_match`, `price_asc`, `price_desc`, `ending_soonest`, `newly_listed` |
+| `condition` | string | No | Item condition filter — one of: `new`, `used`, `refurbished` |
+| `min_price` | number | No | Minimum price filter |
+| `max_price` | number | No | Maximum price filter |
+| `page` | number | No | Page number (default: 1) |
+
+### get_seller
+
+Get eBay seller profile including feedback, items sold, and store info
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `username` | string | Yes | eBay seller username |
+
+### get_sold_items
+
+Get recently sold/completed eBay listings for price research
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `query` | string | Yes | Search query for sold items |
+| `min_price` | number | No | Minimum sold price |
+| `max_price` | number | No | Maximum sold price |
+| `page` | number | No | Page number (default: 1) |
+
+## Configuration
+
+Get your API key from [RapidAPI](https://rapidapi.com/pullapi/api).
+
+## Usage with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ebay": {
+      "command": "npx",
+      "args": ["-y", "@pullapi/ebay-scraper-mcp"],
+      "env": {
+        "RAPIDAPI_KEY": "your-rapidapi-key"
+      }
+    }
+  }
+}
+```
+
+## Usage with Cursor
+
+Add to your Cursor MCP settings (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "ebay": {
+      "command": "npx",
+      "args": ["-y", "@pullapi/ebay-scraper-mcp"],
+      "env": {
+        "RAPIDAPI_KEY": "your-rapidapi-key"
+      }
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_core_1 = require("@pullapi/mcp-core");
+const tools = [
+    {
+        name: "get_product",
+        description: "Get eBay product listing details including price, condition, seller info, and specifications",
+        parameters: {
+            item_id: { type: "string", description: "eBay item ID", required: true },
+        },
+        endpoint: "/ebay/product",
+    },
+    {
+        name: "search_products",
+        description: "Search eBay for products with filters for condition, price, and sorting",
+        parameters: {
+            query: { type: "string", description: "Search query", required: true },
+            sort: { type: "string", description: "Sort order", default: "best_match", enum: ["best_match", "price_asc", "price_desc", "ending_soonest", "newly_listed"] },
+            condition: { type: "string", description: "Item condition filter", enum: ["new", "used", "refurbished"] },
+            min_price: { type: "number", description: "Minimum price filter" },
+            max_price: { type: "number", description: "Maximum price filter" },
+            page: { type: "number", description: "Page number", default: 1 },
+        },
+        endpoint: "/ebay/search",
+    },
+    {
+        name: "get_seller",
+        description: "Get eBay seller profile including feedback, items sold, and store info",
+        parameters: {
+            username: { type: "string", description: "eBay seller username", required: true },
+        },
+        endpoint: "/ebay/seller",
+    },
+    {
+        name: "get_sold_items",
+        description: "Get recently sold/completed eBay listings for price research",
+        parameters: {
+            query: { type: "string", description: "Search query for sold items", required: true },
+            min_price: { type: "number", description: "Minimum sold price" },
+            max_price: { type: "number", description: "Maximum sold price" },
+            page: { type: "number", description: "Page number", default: 1 },
+        },
+        endpoint: "/ebay/sold",
+    },
+];
+(0, mcp_core_1.createServer)("pullapi-ebay", tools, {
+    rapidapiHost: "pullapi-ebay.p.rapidapi.com",
+});

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@pullapi/ebay-scraper-mcp",
+  "mcpName": "com.pullapi/ebay",
+  "version": "1.0.0",
+  "description": "eBay MCP server — product search, listings, seller profiles & sold items. For Claude, Cursor & AI agents.",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "server.json",
+    "README.md"
+  ],
+  "types": "dist/index.d.ts",
+  "bin": {
+    "pullapi-ebay-scraper-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "scraper",
+    "claude",
+    "cursor",
+    "ai-agent",
+    "ebay",
+    "ebay-api",
+    "ebay-scraper",
+    "ecommerce",
+    "auctions",
+    "shopping",
+    "sold-items",
+    "price-research",
+    "marketplace"
+  ],
+  "dependencies": {
+    "@pullapi/mcp-core": "*"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/basitmakine/pullapi.git",
+    "directory": "mcp/packages/ebay"
+  },
+  "homepage": "https://github.com/basitmakine/pullapi/tree/master/mcp/packages/ebay#readme"
+}

package/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "com.pullapi/ebay",
+  "title": "eBay Scraper",
+  "description": "Product search, details, seller profiles, and sold items",
+  "version": "1.0.0",
+  "websiteUrl": "https://pullapi.com",
+  "repository": {
+    "url": "https://github.com/basitmakine/pullapi",
+    "source": "github",
+    "subfolder": "mcp/packages/ebay"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@pullapi/ebay-scraper-mcp",
+      "version": "1.0.0",
+      "transport": { "type": "stdio" },
+      "environmentVariables": [
+        {
+          "name": "RAPIDAPI_KEY",
+          "description": "Your RapidAPI key from rapidapi.com",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}