scrapeunblocker 0.17.0 → 0.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a9fdb57b21c1b655ba3ec6bc4c87f0907872ccdf9ad279035e028192b7f4414
-  data.tar.gz: adfa7124cb12d1eac3aed2a818070be619a80e8a243e6d1816b34f534cb4601a
+  metadata.gz: 4a7407a3294512988eb4cc9c842879b2a239bbf0ec11a9f237330419f474566c
+  data.tar.gz: 1de06b6e0edea74520225e6e036f5e669efa28458bab9f4ab55cbaa8568e3858
 SHA512:
-  metadata.gz: c6765faaf5a348e030ea3c102d5574b05d3f0105526b1141d4bb9b2257eb8fb3ec5c9ab96c6b934f8d0d6b2d026eaec0821a247670fb18c9382243ac32fc2206
-  data.tar.gz: 806142bbf00967541f0a32b88afa96485416f46505266647b41ee2ed13bbbe53c0c0f50210ec53138c13118ae5df4c9afdb701b2d0e6e601311e07055c95a22b
+  metadata.gz: 47df1c68bc32800c2b86a6466de1d5b9c7090ec87f2c7594cd3f6c95480c26ddd81ace11cea0b45750bab2ecfdf971157157663eb2de6c4fc6bf3afeb385af75
+  data.tar.gz: 1890257bc228863e02cf9830889ab0d38da7068357d3a0df580801b143f699c3f8cba39c7d894d95c2853b6d2f622e10bd194f6308363204d8ff0e02b0968aed

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.17.1 (2026-10-30)
+
+- 2 new plugin methods on `Client`: `bodegaaurrera_search(query)` and `bodegaaurrera_product` (Bodega Aurrera, Walmart de Mexico's discount chain; prices in MXN). The search's first argument is optional for calls that pass `url:` instead; the product method takes `product_id:` or `url:`.
+
+No breaking changes.
+
 ## 0.17.0 (2026-10-30)
 
 - 29 new plugin methods on `Client`:

data/README.md

@@ -154,7 +154,7 @@ jobs = su.career_site_jobs("https://jobs.ashbyhq.com/ramp", keyword: "engineer")
 | Search engines | `bing_search`, `bing_images`, `duckduckgo_search`, `yahoo_search`, `yahoo_images`, `brave_search`, `brave_images` |
 | E-commerce | `amazon_product`, `amazon_search`, `amazon_bestsellers`, `amazon_reviews`, `amazon_offers`, `amazon_seller`, `walmart_search`, `walmart_product`, `target_search`, `target_category`, `target_product`, `bestbuy_search`, `bestbuy_product`, `homedepot_search`, `costco_search`, `costco_product`, `etsy_search`, `etsy_product`, `shein_search`, `zalando_search`, `aliexpress_search`, `aliexpress_product`, `alibaba_search`, `alibaba_product`, `alibaba1688_search`, `alibaba1688_product`, `tiktok_shop_search`, `tiktok_shop_product`, `tiktok_shop_store`, `oopbuy_search`, `smyths_inventory`, `smyths_details`, `smyths_search`, `smyths_category`, `wish_search`, `wish_product`, `shopee_search`, `shopee_product`, `taobao_search`, `taobao_product`, `flipkart_search`, `flipkart_product`, `lazada_search`, `lazada_product`, `allegro_search`, `allegro_product`, `falabella_search`, `falabella_product`, `magazineluiza_search`, `magazineluiza_product`, `mediamarkt_search`, `mediamarkt_product`, `cdiscount_search`, `cdiscount_product`, `idealo_search`, `idealo_offers`, `rakuten_search`, `rakuten_product`, `indiamart_search`, `indiamart_product`, `bedbathandbeyond_search`, `bedbathandbeyond_product`, `petco_search`, `petco_product`, `neobits_product`, `lowes_search`, `lowes_product`, `menards_search`, `menards_product`, `grainger_search`, `grainger_product` |
 | Classifieds & Resale | `ebay_product`, `ebay_search`, `vinted_search`, `leboncoin_search` |
-| Groceries | `woolworths_search`, `woolworths_category`, `woolworths_specials`, `woolworths_product`, `coles_search`, `coles_category`, `coles_specials`, `coles_product`, `aldi_au_search`, `aldi_au_category`, `aldi_au_specials`, `aldi_au_product`, `kroger_search`, `kroger_product`, `instacart_search`, `instacart_product`, `publix_search`, `publix_product` |
+| Groceries | `woolworths_search`, `woolworths_category`, `woolworths_specials`, `woolworths_product`, `coles_search`, `coles_category`, `coles_specials`, `coles_product`, `aldi_au_search`, `aldi_au_category`, `aldi_au_specials`, `aldi_au_product`, `kroger_search`, `kroger_product`, `instacart_search`, `instacart_product`, `publix_search`, `publix_product`, `bodegaaurrera_search`, `bodegaaurrera_product` |
 | Real estate | `zillow_search`, `zillow_detail`, `redfin_search`, `redfin_detail`, `rightmove_search`, `idealista_search`, `idealista_detail`, `immobilienscout24_search` |
 | Vehicles | `mobile_de`, `autoscout24_search` |
 | Jobs | `indeed_jobs`, `glassdoor_jobs`, `glassdoor_reviews`, `glassdoor_salaries`, `naukri_jobs`, `wellfound_jobs`, `wellfound_job`, `wellfound_company`, `wellfound_company_search`, `career_site_jobs`, `upwork_jobs` |

data/lib/scrapeunblocker/plugins.rb

@@ -2948,6 +2948,64 @@ module ScrapeUnblocker
       })
     end
 
+    # Scrape Bodega Aurrera (Mexico) product search.
+    #
+    # Searches Bodega Aurrera (bodegaaurrera.com.mx, Walmart de Mexico) for `query` and returns
+    # `products`, each with `position`, `productId`, `name`, `brand`, `url`, `price` (MXN),
+    # `wasPrice` and `savings` (only on a promotion), `unitPrice`, `priceRange`, `rating`,
+    # `reviewCount`, `availability` / `availabilityText` / `inStock`, `seller` / `sellerType`,
+    # `salesUnit`, `department`, `category` (path), `badges`, `fulfillment` (pickup / delivery
+    # labels), `sponsored` and `image`. Also `totalResults`, `storeId` (the store the prices and
+    # availability are for: the one the storefront assigns a new visitor - a store or postal
+    # code cannot be chosen) and `nextPage`. Sort with `sort` (relevance, price_low,
+    # price_high), start at `page` and collect up to `max_results` across pages (about 40 per
+    # page, each page billed as one request, see `pagesFetched`). `url` takes a Bodega Aurrera
+    # search link instead of `query`. A results page usually takes 1-3 s; a page that has to be
+    # rendered in a browser takes 20-60 s.
+    #
+    # @param query [String] What to search, e.g. 'leche', 'arroz', 'detergente' or 'pañales'.
+    # @param sort [String] Order: relevance, price_low, price_high. API default: relevance.
+    # @param page [Integer] 1-based results page to start from (1-25). API default: 1.
+    # @param max_results [Integer] Products to collect across pages (1-220); about 44 per page,
+    # and each page read is billed as one request. API default: 44.
+    # @param url [String] Instead of `query`: a Bodega Aurrera search link, e.g.
+    # https://www.bodegaaurrera.com.mx/search?q=leche (its sort and page are used).
+    # Calls POST /groceries/bodegaaurrera-search.
+    def bodegaaurrera_search(query = nil, sort: nil, page: nil, max_results: nil, url: nil)
+      post_json("/groceries/bodegaaurrera-search", {
+        query: query,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        url: url,
+      })
+    end
+
+    # Scrape one Bodega Aurrera (Mexico) product.
+    #
+    # Fetches one Bodega Aurrera product (by `product_id` or `url`) and returns it as JSON:
+    # `productId`, `name`, `brand`, `url`, `upc`, `model`, `price` (MXN), `wasPrice` / `savings`
+    # (only on a promotion), `unitPrice`, `installments`, `availability` / `availabilityText` /
+    # `inStock`, `orderLimit`, `orderMinimum`, `salesUnit`, `seller` / `sellerId` /
+    # `sellerType`, `rating`, `reviewCount`, `ratingBreakdown` (1-5 stars), `category` (path),
+    # `productType`, `shortDescription`, `description`, `ingredients`, `specifications` (name /
+    # value), `badges`, `fulfillment` (pickup / delivery messages), `fulfillmentOptions`,
+    # `store` (the store the price and availability are for - the one the storefront assigns a
+    # new visitor) and `image` / `images`. A call usually takes 1-3 s, or 20-60 s when the page
+    # has to be rendered in a browser. Companion to `/groceries/bodegaaurrera-search`.
+    #
+    # @param product_id [String] Bodega Aurrera item id, e.g. '00750649502153' (the number at
+    # the end of an /ip/ link; search results give it as `productId`).
+    # @param url [String] Instead of `product_id`: a Bodega Aurrera product link, e.g.
+    # https://www.bodegaaurrera.com.mx/ip/leche-great-value-entera-1-l/00750649502153.
+    # Calls POST /groceries/bodegaaurrera-product.
+    def bodegaaurrera_product(product_id: nil, url: nil)
+      post_json("/groceries/bodegaaurrera-product", {
+        product_id: product_id,
+        url: url,
+      })
+    end
+
     # Smyths Toys UK product stock, price, details and listings.
     #
     # Smyths Toys UK (smythstoys.com) as JSON, in four modes. `mode=product` (the default when
@@ -5731,7 +5789,7 @@ module ScrapeUnblocker
     # @param video [String] Video id (dQw4w9WgXcQ) or any YouTube video URL.
     # @param lang [String] Preferred caption language code, e.g. 'en'. Omit for the
     # default/first track. A prefix like 'en' matches 'en-US'.
-    # @param format [String] Output shape: segments, text. 'segments' returns timestamps; 'text'
+    # @param format [String] Output shape: text, segments. 'segments' returns timestamps; 'text'
     # returns only the joined plaintext. API default: segments.
     # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
     # 'DE') for the watch page. Defaults to US.

data/lib/scrapeunblocker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ScrapeUnblocker
-  VERSION = "0.17.0"
+  VERSION = "0.17.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrapeunblocker
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.17.1
 platform: ruby
 authors:
 - ScrapeUnblocker
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-29 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies: []
 description: JS-rendered pages that bypass Cloudflare, DataDome, PerimeterX and Akamai,
   plus Google SERP and 100+ ready-made site plugins (Amazon, Walmart, Zillow, Google