scrapeunblocker-mcp 0.12.6 → 0.12.7

package/dist/index.js

@@ -1064,7 +1064,7 @@ var PLUGINS = [
     "category": "Google",
     "path": "/goods/google-shopping",
     "fixed": {},
-    "description": "Runs the Google Shopping vertical (`udm=28`) for `q` and returns the product cards as JSON: `title`, `price`, `currency`, `currencyCode`, `originalPrice`, `discount`, `merchant`, `rating`, `reviewCount` and Google's own ids for the product (`productId`, `catalogId`, `offerId` - stable across searches, for tracking one product). Set `proxy_country`/`gl` to target a market (prices/merchants are region-specific) and `min_price`/`max_price` to filter. One render returns the first page of products (v1). Note: Google Shopping exposes no per-product URL, so `url` is omitted and `image` is best-effort.",
+    "description": "Runs the Google Shopping vertical (`udm=28`) for `q` and returns the product cards as JSON: `title`, `price`, `currency`, `currencyCode`, `originalPrice`, `discount`, `merchant`, `delivery`, `rating`, `reviewCount`, `image` and Google's own ids for the product (`productId`, `catalogId`, `offerId` - stable across searches, for tracking one product). Set `proxy_country`/`gl` to target a market (prices/merchants are region-specific) and `min_price`/`max_price` to filter. One render returns the first page of products (v1). Note: Google Shopping exposes no per-product URL, so `url` is omitted. `image` is the product's thumbnail URL.",
     "params": [
       {
         "name": "q",
@@ -1836,7 +1836,7 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/amazon-product",
     "fixed": {},
-    "description": "Fetches a single Amazon product and returns it as JSON: `title`, `brand`, `price` + `currency`, `listPrice` and `savingsPercent`, `availability` (+ a boolean `inStock`), `rating`, `reviewCount`, `seller`, `features` (bullet points), `categories` (breadcrumb) and `images`. Identify the product with either `asin` (plus `marketplace`) or a full product `url`. Amazon prices each page in the currency of the delivery location it infers from the visitor's IP address, so `proxy_country` defaults to the marketplace's home country (amazon.com -> US) and the call is routed through proxies in that country. The country of the proxy that served the request is reported as `exitCountry`.",
+    "description": "Fetches a single Amazon product and returns it as JSON: `title`, `brand` and `brandStoreUrl`, `parentAsin`, `manufacturer`, `modelNumber`, `partNumber`, `productCodes` (UPC, EAN, GTIN, ISBN), `condition`, the `amazonsChoice`, `bestSellerBadge`, `deal` and `coupon` markers, `price` + `currency`, `listPrice`, `savingsPercent` and `savingsAmount`, `unitPrice`, `subscribeAndSavePrice`, `shippingPrice`, `recentSales`, `availability` (+ a boolean `inStock`), `maxOrderQuantity`, `rating`, `reviewCount`, `ratingDistribution` (percent per star), `reviewSummary`, `seller`, `sellerUrl`, `sellerId`, `shipsFrom`, `fulfilledByAmazon`, `prime`, `delivery`, `returnPolicy`, `offersCount` and `offersFromPrice`, `bestSellersRank`, `features` (bullet points), `categories` (breadcrumb), `description`, `fromTheManufacturer` and `fromTheBrand` (text and images), `importantInformation`, `ingredients`, `whatsInTheBox`, `documents`, `warrantyAndSupport`, `productDetails`, `productOverview`, `dimensions`, `weight`, `dateFirstAvailable`, `variantDimensions` and `variants` (each with its own ASIN and options), `sustainability`, `protectionPlans`, `newerModel`, `sponsoredProducts`, `relatedProducts`, `images` (the whole gallery) and `videos`. A field the page does not show is null or empty. Identify the product with either `asin` (plus `marketplace`) or a full product `url`. Other sellers' full offers are not on the product page: only their count and lowest price are returned here, `/marketplace/amazon-offers` lists them. `prime` and `delivery` are what a visitor who is not signed in sees. Amazon prices each page in the currency of the delivery location it infers from the visitor's IP address, so `proxy_country` defaults to the marketplace's home country (amazon.com -> US) and the call is routed through proxies in that country. The country of the proxy that served the request is reported as `exitCountry`.",
     "params": [
       {
         "name": "asin",
@@ -2109,7 +2109,7 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/walmart-search",
     "fixed": {},
-    "description": "Searches Walmart for `query` and returns the products as JSON: `name`, `price` and `wasPrice`, `rating`, `reviewCount`, `brand`, `seller`, `availability`, `image` and a product `url`. Sort with `sort`, filter with `min_price`/`max_price`, and collect up to `max_results` across pages.",
+    "description": "Searches Walmart for `query` and returns the products as JSON: `name`, `price` and `wasPrice`, `rating`, `reviewCount`, `brand`, `seller`, `availability`, `image`, a product `url`, `sponsored`, `unitPrice`, `priceRange`, `promotions`, `fulfillment`, `deliveryAvailable` and `variants`. The response also carries the search's `totalResults`, `pages`, `filters` and `sponsoredProducts`. Sort with `sort`, filter with `min_price`/`max_price`, and collect up to `max_results` across pages.",
     "params": [
       {
         "name": "query",
@@ -2164,7 +2164,7 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/walmart-product",
     "fixed": {},
-    "description": "Fetches one Walmart product page (by `item_id` or `url`) and returns it as JSON: `itemId`, `title`, `brand`, `model`, `upc`, `price`, `wasPrice`, `listPrice`, `unitPrice` (e.g. per ounce, where Walmart shows one), `currency`, `rollback` / `clearance`, `availability` and `inStock`, `condition`, `seller` (name, Walmart or marketplace seller, its rating and review count), `additionalSellerCount`, `fulfillment` (shipping, pickup and delivery: available or not, date, fee, store or place), `returnPolicy`, `rating`, `reviewCount`, `reviewSummary` (star histogram, recommend percentage, aspect scores), the first `reviews`, `categories`, `shortDescription`, `description`, `highlights`, `specifications`, `warranty`, `variantOptions` and every `variants` entry (its own item id, attributes, price, stock), `images` and `videos`. Fulfillment dates and the store are what Walmart quotes for the US location it assigns to the request (`location` names it), not a ZIP code or store you choose. Other sellers' offers are not on the product page: only their count (`additionalSellerCount`) is returned. Companion to `/marketplace/walmart-search`.",
+    "description": "Fetches one Walmart product page (by `item_id` or `url`) and returns it as JSON: `itemId`, `title`, `brand`, `model`, `upc`, `price`, `wasPrice`, `listPrice`, `unitPrice` (e.g. per ounce, where Walmart shows one), `currency`, `rollback` / `clearance`, `availability` and `inStock`, `condition`, `seller` (name, Walmart or marketplace seller, its rating and review count), `additionalSellerCount`, `fulfillment` (shipping, pickup and delivery: available or not, date, fee, store or place), `returnPolicy`, `rating`, `reviewCount`, `totalReviewCount`, `reviewSummary` (star histogram, recommend percentage, aspect scores), `reviewSummaryText`, `reviewBullets`, `reviewTopics`, `topPositiveReview`, `topNegativeReview`, the first `reviews`, `offersCount`, `otherOffersFromPrice`, `otherSellers`, `promotions`, `deliveryAvailable`, `pickupAvailable`, `categories`, `relatedPages`, `colors`, `shortDescription`, `description`, `pageSummary`, `highlights`, `specifications`, `directions`, `ingredients`, `activeIngredients`, `nutritionFacts`, `warranty`, `variantOptions` and every `variants` entry (its own item id, attributes, price, stock), `images`, `videos`, `infographics` and `view360Images`. Fulfillment dates and the store are what Walmart quotes for the US location it assigns to the request (`location` names it), not a ZIP code or store you choose. The product page holds only some of the other sellers' offers (`otherSellers`); `offersCount` is how many there are. Companion to `/marketplace/walmart-search`.",
     "params": [
       {
         "name": "item_id",
@@ -3384,7 +3384,7 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/taobao-search",
     "fixed": {},
-    "description": "Returns the products Taobao lists for a keyword `q` (or a `category`) as JSON: `products` (`position`, `itemId`, `title`, `url`, `image`, `price` in yuan with `currency` CNY, `priceLabel` (Taobao's price tag, e.g. \u4F18\u60E0\u4EF7), `localPrices` (the same price in the storefront's currency, HKD and TWD), `shopId`, `shopName`, `descriptionMatchScore`, `freeShipping`, `categoryId`, `rootCategoryId`, `sellingPoints`, `reviewHighlights`), `totalResults` (how many listings Taobao reports), and `filterOptions` (brand and property facets; pass an option's `filter` value back as `filter`). Sort by relevance, sales or price and filter by a yuan price range (products whose listed price falls outside it are left out and counted in `droppedOutsidePriceRange`). Taobao shows signed-out visitors only the first 20 products of a list, so one call returns up to 20 (narrow with price ranges and filters to reach more). When Taobao has no list for the keyword, the call answers with the list of the closest keyword Taobao itself suggests and says so: `keywordSubstituted` true and `matchedKeyword`. Text comes in Chinese as sellers write it. Companion to `/marketplace/taobao-product`. One unit per call.",
+    "description": "Returns the products Taobao lists for a keyword `q` (or a `category`) as JSON: `products` (`position`, `itemId`, `itemKey` (the item's catalogue key: pass it to `/marketplace/taobao-product` as `item_id`), `title`, `url`, `catalogueUrl` (the item's public catalogue page), `image`, `price` in yuan with `currency` CNY, `priceLabel` (Taobao's price tag, e.g. \u4F18\u60E0\u4EF7), `localPrices` (the same price in the storefront's currency, HKD and TWD), `shopId`, `shopName`, `descriptionMatchScore`, `freeShipping`, `categoryId`, `rootCategoryId`, `sellingPoints`, `reviewHighlights`), `totalResults` (how many listings Taobao reports), and `filterOptions` (brand and property facets; pass an option's `filter` value back as `filter`). Sort by relevance, sales or price and filter by a yuan price range (products whose listed price falls outside it are left out and counted in `droppedOutsidePriceRange`). Taobao shows signed-out visitors only the first 20 products of a list, so one call returns up to 20 (narrow with price ranges and filters to reach more). When Taobao has no list for the keyword, the call answers with the list of the closest keyword Taobao itself suggests and says so: `keywordSubstituted` true and `matchedKeyword`. Text comes in Chinese as sellers write it. Companion to `/marketplace/taobao-product`. One unit per call.",
     "params": [
       {
         "name": "q",
@@ -3431,19 +3431,19 @@ var PLUGINS = [
     "category": "E-commerce",
     "path": "/marketplace/taobao-product",
     "fixed": {},
-    "description": "Returns one Taobao or Tmall item (by `item_id` or `url`) as JSON: `itemId`, `url`, `platform` (taobao / tmall), `title` (`titleTruncated` when Taobao shortens it, as it does for Tmall items), `price`, `originalPrice` and `priceMax` (for a price range) in yuan with `currency` CNY, `image`, `location` (ships from), `categoryId`, `rootCategoryId`, `categoryPath`, `freeShipping`, `paymentMethods`, `sellableLanguages`, `rating` (positive / neutral / negative split and counts; Taobao items only, Tmall does not publish it), `latestReview` (`rating`, `content`, `date`, `variant`, `hasMedia`, `followUps`; no reviewer identity, so no review photo or video URLs) and `shop` (`shopId`, `name`, `url`, `logo`, `sellerType` B = Tmall / C = Taobao, `creditLevel`, `openedAt`, `itemCount`, `scores` for description, service and delivery). This is what Taobao shows signed-out visitors: variants (SKUs), stock and monthly sales need a Taobao login and are not included. Companion to `/marketplace/taobao-search`. One unit per call.",
+    "description": "Returns one Taobao or Tmall item (by `item_id` or `url`) as JSON: `itemId`, `itemKey` (the item's catalogue key), `url`, `catalogueUrl`, `platform` (taobao / tmall), `title` (`titleTruncated` when Taobao shortens it, as it does for Tmall items), `price`, `originalPrice` and `priceMax` (for a price range) in yuan with `currency` CNY, `image`, `location` (ships from), `categoryId`, `rootCategoryId`, `categoryPath`, `freeShipping`, `paymentMethods`, `sellableLanguages`, `rating` (positive / neutral / negative split and counts; Taobao items only, Tmall does not publish it), `latestReview` (`rating`, `content`, `date`, `variant`, `hasMedia`, `followUps`; no reviewer identity, so no review photo or video URLs) and `shop` (`shopId`, `name`, `url`, `logo`, `sellerType` B = Tmall / C = Taobao, `creditLevel`, `openedAt`, `itemCount`, `scores` for description, service and delivery). This is what Taobao shows signed-out visitors: variants (SKUs), stock and monthly sales need a Taobao login and are not included. Taobao's public catalogue opens an item by its catalogue key (`itemKey` in `/marketplace/taobao-search` results, or the key in a www.taobao.com/list/item/<key>.htm or world.taobao.com/item/<key>.htm link); a numeric id is tried as given and answers 404 when the catalogue does not open it. Companion to `/marketplace/taobao-search`. One unit per call.",
     "params": [
       {
         "name": "item_id",
         "type": "string",
         "required": false,
-        "description": "Numeric Taobao or Tmall item id, e.g. '765833709683' (the `id` in item.taobao.com/item.htm?id=...)."
+        "description": "The item's catalogue key, as `/marketplace/taobao-search` returns it in `itemKey`, e.g. 'M3hoaXBUL3N4L2VnVUJncG9JWFphZz09'. A numeric Taobao or Tmall item id (the `id` in item.taobao.com/item.htm?id=...) is tried as given; Taobao's public catalogue opens items by key, so a numeric id may answer 404."
       },
       {
         "name": "url",
         "type": "string",
         "required": false,
-        "description": "Taobao or Tmall item link, e.g. 'https://item.taobao.com/item.htm?id=765833709683' or 'https://detail.tmall.com/item.htm?id=1081364414020' (world.taobao.com, mobile and overseas item links work too). Either item_id or url is required."
+        "description": "The item's catalogue link, e.g. 'https://www.taobao.com/list/item/M3hoaXBUL3N4L2VnVUJncG9JWFphZz09.htm' or 'https://world.taobao.com/item/M3hoaXBUL3N4L2VnVUJncG9JWFphZz09.htm' (the links Taobao's own lists and search engines give). An item.taobao.com or detail.tmall.com link is taken by its numeric id, as `item_id` is. Either item_id or url is required."
       }
     ]
   },
@@ -5804,7 +5804,7 @@ var PLUGINS = [
     "category": "Real estate",
     "path": "/realestate/zillow-detail",
     "fixed": {},
-    "description": "Fetches one Zillow property (by `url` or `zpid`) and returns the full record as JSON: `price`, `zestimate`, `rentZestimate`, `beds`, `baths`, `area`, `lotSize`, `yearBuilt`, `homeType`, `status`, `description`, `priceHistory`, `taxHistory`, `schools`, `facts`, `parking`, listing `brokerName`/`listingAgent`, `mlsid`, `monthlyHoaFee`, `pricePerSqft`, `daysOnZillow`, `taxAssessedValue`, coordinates, the `photos` gallery and `virtualTourUrl`. Every field is always present and is `null` when Zillow does not show it for that listing (for-sale and sold pages carry fewer sections than rentals). Companion to the Zillow search plugin (`/realestate/zillow`).",
+    "description": "Fetches one Zillow property (by `url` or `zpid`) and returns the full record as JSON: `price`, `zestimate`, `rentZestimate`, `beds`, `baths`, `area`, `lotSize`, `yearBuilt`, `homeType`, `status`, `description`, `priceHistory`, `taxHistory`, `schools`, `facts`, `parking`, listing `brokerName`/`listingAgent`, `mlsid`, `monthlyHoaFee`, `pricePerSqft`, `daysOnZillow`, `datePosted`, `pageViewCount` and `favoriteCount` (how many people viewed and saved the listing), `taxAssessedValue`, coordinates, the `photos` gallery and `virtualTourUrl`. Every field is always present and is `null` when Zillow does not show it for that listing (for-sale and sold pages carry fewer sections than rentals). Companion to the Zillow search plugin (`/realestate/zillow`).",
     "params": [
       {
         "name": "url",
@@ -7137,7 +7137,7 @@ var PLUGINS = [
     "category": "Reviews & Companies",
     "path": "/reviews/trustpilot",
     "fixed": {},
-    "description": "Returns a company's Trustpilot profile and reviews as JSON. `company` is the reviewed domain (e.g. `www.nike.com`). The response has a `company` summary (`trustScore`, `totalReviews`, `ratingDistribution` 1-5, `categories`, `contact`) and a `reviews` array - each with `rating`, `title`, `text`, `verified`, `author` (name, country, review count), `reply` (the company's response) and dates. Page with `page`/`pages` (20 reviews per page), and filter with `stars`, `sort` (recency/relevancy), `language`, `date`, `search`, `verified` or `replies`.",
+    "description": "Returns a company's Trustpilot profile and reviews as JSON. `company` is the reviewed domain (e.g. `www.nike.com`). The response has a `company` summary (`trustScore`, `totalReviews`, `ratingDistribution` 1-5, `categories`, `contact`) and a `reviews` array - each with `url`, `rating`, `title`, `text`, `verified`, `verificationLevel`, `verificationSource`, `source`, `pending`, `merged`, `author` (name, country, review count, `id`, `image`, `profileUrl`, `reviewsOfThisCompany`), `reply` (the company's response, with dates) and `date` / `experiencedDate` / `updatedDate`. Page with `page`/`pages` (20 reviews per page), and filter with `stars`, `sort` (recency/relevancy), `language`, `date`, `search`, `verified` or `replies`.",
     "params": [
       {
         "name": "company",
@@ -8955,7 +8955,7 @@ ${body}`);
 }
 
 // src/index.ts
-var VERSION = "0.12.6";
+var VERSION = "0.12.7";
 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.12.6",
+  "version": "0.12.7",
   "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": [