@pullapi/amazon-scraper-mcp 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# Amazon Scraper MCP Server
+
+An MCP server that provides real-time Amazon data — search products, get full details with pricing and specs, read customer reviews, and browse bestsellers — for use with Claude, Cursor, and other MCP-compatible AI tools.
+
+## Features
+
+- **Get Product** — Get full Amazon product details including price, rating, features, images, and specifications
+- **Search Products** — Search Amazon products by keyword
+- **Get Reviews** — Get customer reviews for an Amazon product
+- **Get Bestsellers** — Get Amazon bestseller products, optionally filtered by category
+
+## Tools
+
+### get_product
+
+Get full Amazon product details including price, rating, features, images, and specifications
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `asin` | string | Yes | Amazon Standard Identification Number (ASIN) |
+
+### search_products
+
+Search Amazon products by keyword
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `query` | string | Yes | Search query |
+| `page` | number | No | Page number for pagination (default: 1) |
+
+### get_reviews
+
+Get customer reviews for an Amazon product
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `asin` | string | Yes | Amazon ASIN |
+
+### get_bestsellers
+
+Get Amazon bestseller products, optionally filtered by category
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `category` | string | No | Category name to filter bestsellers |
+
+## 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": {
+    "amazon": {
+      "command": "npx",
+      "args": ["-y", "@pullapi/amazon-scraper-mcp"],
+      "env": {
+        "RAPIDAPI_KEY": "your-rapidapi-key"
+      }
+    }
+  }
+}
+```
+
+## Usage with Cursor
+
+Add to your Cursor MCP settings (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "amazon": {
+      "command": "npx",
+      "args": ["-y", "@pullapi/amazon-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,42 @@
+#!/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 full Amazon product details including price, rating, features, images, and specifications",
+        parameters: {
+            asin: { type: "string", description: "Amazon Standard Identification Number (ASIN)", required: true },
+        },
+        endpoint: "/amazon/product",
+    },
+    {
+        name: "search_products",
+        description: "Search Amazon products by keyword",
+        parameters: {
+            query: { type: "string", description: "Search query", required: true },
+            page: { type: "number", description: "Page number for pagination", default: 1 },
+        },
+        endpoint: "/amazon/search",
+    },
+    {
+        name: "get_reviews",
+        description: "Get customer reviews for an Amazon product",
+        parameters: {
+            asin: { type: "string", description: "Amazon ASIN", required: true },
+        },
+        endpoint: "/amazon/reviews",
+    },
+    {
+        name: "get_bestsellers",
+        description: "Get Amazon bestseller products, optionally filtered by category",
+        parameters: {
+            category: { type: "string", description: "Category name to filter bestsellers" },
+        },
+        endpoint: "/amazon/bestsellers",
+    },
+];
+(0, mcp_core_1.createServer)("pullapi-amazon", tools, {
+    rapidapiHost: "pullapi-amazon.p.rapidapi.com",
+});

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@pullapi/amazon-scraper-mcp",
+  "mcpName": "com.pullapi/amazon",
+  "version": "1.0.0",
+  "description": "Amazon MCP server — product search, details, reviews & bestsellers. For Claude, Cursor & AI agents.",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "server.json",
+    "README.md"
+  ],
+  "types": "dist/index.d.ts",
+  "bin": {
+    "pullapi-amazon-scraper-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "scraper",
+    "claude",
+    "cursor",
+    "ai-agent",
+    "amazon",
+    "amazon-api",
+    "amazon-scraper",
+    "ecommerce",
+    "products",
+    "product-search",
+    "reviews",
+    "shopping",
+    "asin",
+    "bestsellers"
+  ],
+  "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/amazon"
+  },
+  "homepage": "https://github.com/basitmakine/pullapi/tree/master/mcp/packages/amazon#readme"
+}

package/server.json

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