scrapeunblocker-mcp 0.9.0 → 0.10.0

package/dist/index.js

@@ -905,6 +905,75 @@ var PLUGINS = [
       }
     ]
   },
+  {
+    "name": "maps_reviews",
+    "title": "Scrape Google Maps reviews",
+    "category": "Google",
+    "path": "/maps/reviews",
+    "fixed": {},
+    "description": "Returns one Google Maps place's reviews as JSON, sorted the way Google sorts them: `relevant`, `newest`, `highest` or `lowest`. Each review has `rating` (1-5), `date` (exact ISO 8601, UTC) + `timestamp`, `relativeDate`, `text` (original) + `language`, `translatedText` (into `hl`, when the review is in another language), `author`, `photos`, `details` (guided answers such as 'Rooms: 5'), `ownerResponse` and `reviewUrl`. The answer also carries a `place` summary and `nextPageToken` for paging. Identify the place with `feature_id` (0xHEX:0xHEX), `place_id` (ChIJ...) or a Maps `url`. Reviews come in pages of 20; each page fetched is one billed unit.",
+    "params": [
+      {
+        "name": "url",
+        "type": "string",
+        "required": false,
+        "description": "A Google Maps place URL (share link or /maps/place/... URL). The feature id or place_id is read out of it."
+      },
+      {
+        "name": "place_id",
+        "type": "string",
+        "required": false,
+        "description": "A Google place_id, e.g. 'ChIJN1t_tDeuEmsRUsoyG83frY4'."
+      },
+      {
+        "name": "feature_id",
+        "type": "string",
+        "required": false,
+        "description": "A Maps feature id '0xHEX:0xHEX', e.g. '0x4776901a5d4813b3:0x2a497c8b414893c'. Fastest - no resolve step."
+      },
+      {
+        "name": "sort",
+        "type": "string",
+        "required": false,
+        "description": "Review order: 'relevant' (Google's default), 'newest', 'highest' or 'lowest'. SerpApi's 'qualityScore', 'newestFirst', 'ratingHigh' and 'ratingLow' are accepted too.",
+        "default": "relevant"
+      },
+      {
+        "name": "max_reviews",
+        "type": "integer",
+        "required": false,
+        "description": "How many reviews to return, 1-200. Reviews come in pages of 20; each page fetched is one billed unit.",
+        "default": 20
+      },
+      {
+        "name": "next_page_token",
+        "type": "string",
+        "required": false,
+        "description": "Continue from a previous answer's `nextPageToken` (same place and sort). When `max_reviews` is not a multiple of 20 the next page can repeat a few reviews - dedupe on `reviewId`."
+      },
+      {
+        "name": "hl",
+        "type": "string",
+        "required": false,
+        "description": "Language for Google's labels and the review translation (`translatedText`), e.g. 'en', 'de'. The original text is always returned in `text`.",
+        "default": "en"
+      },
+      {
+        "name": "gl",
+        "type": "string",
+        "required": false,
+        "description": "Google country, ISO-2 lowercase, e.g. 'us'.",
+        "default": "us"
+      },
+      {
+        "name": "proxy_country",
+        "type": "string",
+        "required": false,
+        "description": "Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Reviews are the same from any country.",
+        "default": "us"
+      }
+    ]
+  },
   {
     "name": "google_trends",
     "title": "Scrape Google Trends (interest over time, by region, related queries)",
@@ -3014,7 +3083,7 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/shopee-search",
     "fixed": {},
-    "description": "Searches a Shopee market (Singapore, Indonesia, Malaysia, Thailand, Vietnam, Philippines, Taiwan or Brazil - `country`) for `q` and returns one page of results: up to 40 `products`, each with `position`, `itemId`, `shopId`, `name`, `url`, `image`, `price`, `originalPrice` (when Shopee shows the crossed-out price), `discountPercent`, `currency`, `rating` (average stars), `location` (where the seller ships from) and `labels` (promotion badges). `sort` orders the results, `min_price` / `max_price` filter them, `shop_id` keeps one shop's products (or lists the shop without `q`), and `url` takes a Shopee search or category link instead. Shopee shows one page per search, so run several sort orders or price ranges for more products. `price` is what Shopee shows a signed-out shopper, which can be a promotional or new-customer price (see `labels`). Not available: stock, units sold, rating counts and reviews (Shopee does not publish them on the pages these endpoints read). One unit per call.",
+    "description": "Searches a Shopee market (Singapore, Indonesia, Malaysia, Thailand, Vietnam, Philippines, Taiwan or Brazil - `country`) for `q` and returns one page of results: up to 40 `products`, each with `position`, `itemId`, `shopId`, `name`, `url`, `image`, `price`, `originalPrice` (when Shopee shows the crossed-out price), `discountPercent`, `isPixPrice`, `currency`, `rating` (average stars), `location` (where the seller ships from) and `labels` (promotion badges). `sort` orders the results, `min_price` / `max_price` filter them, `shop_id` keeps one shop's products (or lists the shop without `q`), and `url` takes a Shopee search or category link instead. Shopee shows one page per search, so run several sort orders or price ranges for more products. `price` is what Shopee shows a signed-out shopper, which can be a promotional or new-customer price (see `labels`). In Brazil a card often shows the Pix price (`isPixPrice: true`): `price` is then the Pix price and `discountPercent` is measured against the list price, which Shopee does not show on such a card, so `originalPrice` is null. Not available: per-variation prices, stock counts, units sold, rating counts and reviews (Shopee does not publish them on the pages these endpoints read). One unit per call.",
     "params": [
       {
         "name": "q",
@@ -3074,7 +3143,7 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/shopee-product",
     "fixed": {},
-    "description": "One Shopee product as JSON, from a product link (`url`) or `shop_id` + `item_id` + `country`: `title`, `price`, `originalPrice`, `discountPercent`, `currency`, `rating` (average stars), `labels`, `images`, `shopLocation` and `shop` (`name`, `username`, `url`, `rating`, `ratingCount`, `followers`, `itemCount`, `responseRatePercent`, `isOfficialShop`, `isPreferredPlusSeller`, `location`, `joinedAt`). With `dataLevel: full` it also has `description`, `brand`, `condition`, `categories`, `videos`, `variations` (option names), `models` (`modelId`, `name`), `attributes`, `isOfficialShop`, `isPreOrder`, `estimatedShippingDays` and `createdAt`; `dataLevel: meta` means Shopee showed only the product's title and main image (some markets), with price, rating and shop still included. `price` is what Shopee shows a signed-out shopper, which can be a promotional or new-customer price (see `labels`). Not available: stock, units sold, rating counts and reviews (Shopee does not publish them on the pages these endpoints read). One unit per call.",
+    "description": "One Shopee product as JSON, from a product link (`url`) or `shop_id` + `item_id` + `country`: `title`, `price`, `originalPrice`, `discountPercent`, `currency`, `rating` (average stars), `labels`, `images`, `shopLocation` and `shop` (`name`, `username`, `url`, `rating`, `ratingCount`, `followers`, `itemCount`, `responseRatePercent`, `isOfficialShop`, `isPreferredPlusSeller`, `location`, `joinedAt`). With `dataLevel: full` it also has `availability` (`in_stock`, `sold_out` or `unavailable` for a withdrawn listing) and `inStock`, `description`, `brand`, `condition`, `categories` (the path the product page's breadcrumb shows, with ids), `browseCategories` (the browse tree, whose ids Shopee's category links use), `videos`, `variations` (option names), `models` (`modelId`, `name`, `available` - false for a sold-out variation - and `tierIndex`, the model's option in each variation), `attributes`, `isOfficialShop`, `isPreOrder`, `estimatedShippingDays` and `createdAt`; `dataLevel: meta` means Shopee showed only the product's title and main image (some markets), with price, rating and shop still included. A product Shopee says does not exist (removed, or never existed) answers 404 with JSON `{\"status\": \"not_found\", ...}`; a 502 means the call could not get an answer from Shopee and can be retried. `price` is what Shopee shows a signed-out shopper, which can be a promotional or new-customer price (see `labels`). In Brazil a card often shows the Pix price (`isPixPrice: true`): `price` is then the Pix price and `discountPercent` is measured against the list price, which Shopee does not show on such a card, so `originalPrice` is null. Not available: per-variation prices, stock counts, units sold, rating counts and reviews (Shopee does not publish them on the pages these endpoints read). One unit per call.",
     "params": [
       {
         "name": "url",
@@ -7554,7 +7623,7 @@ ${body}`);
 }
 
 // src/index.ts
-var VERSION = "0.9.0";
+var VERSION = "0.10.0";
 var DEFAULT_BASE_URL = "https://api.scrapeunblocker.com";
 var API_KEY_HEADER = "x-scrapeunblocker-key";
 function resolveApiKey() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeunblocker-mcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "mcpName": "com.scrapeunblocker/scrapeunblocker-mcp",
   "description": "Model Context Protocol (MCP) server for ScrapeUnblocker - lets Claude fetch any web page's HTML (or AI-parsed JSON) and run 100+ site plugins that return structured JSON, through the ScrapeUnblocker anti-bot API, using your own API key.",
   "keywords": [