firecrawl-sdk 1.9.0 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 027be403af5ba321ba2d4dbeaa774433666ece0a98cca4ac03ffbce52ac6cae2
-  data.tar.gz: d0ee19ba03f949234d00482c6e0c451986de84c4e4dfde7860c970845a23e3b4
+  metadata.gz: 616551a9caf1736bbc849f0058ce52dca94728cf024cb91319393e5bf192cfe1
+  data.tar.gz: ffe33e36c76d4a69319940e148ccce30bc50b3e44b81915698c76f7e4a1cb99b
 SHA512:
-  metadata.gz: fb9869b378f9d8252cd45ad2b5be1d7f5e9c30f3c67d4752177e3d205a689b75f3da972f389e5d70260bbde576e1677068c4b538ea82c92c25643a239debd879
-  data.tar.gz: f8ad0a882856666ef4662d6356608759513305babc5392100c1cba5ddcaffb89392c67c447aa181cb3ab97230cd0bec4f7f957c11e4585068ef58a2eadcbacda
+  metadata.gz: fbbe64a2fd02c6a8214cbb77f7dfc64791e392d2192f4c9d657ed6cb9bab3c820ed6ff9a430b0fb1abfdd11076b6a64600a4f8df0f9232bda02b8c3bf27d1385
+  data.tar.gz: f2a722b6f10ac0254d3d8f7dda69f653751539056cce8690b703e023f35b021b9ac451a798800bcb2293a9f414014d9eb22bb54fea779971e79cde106dde4b5c

data/README.md

@@ -74,11 +74,25 @@ doc = client.scrape("https://www.youtube.com/watch?v=dQw4w9WgXcQ",
 puts doc.video
 ```
 
+### Product Extraction
+
+Use the `product` format on product pages to get structured product data
+(title, brand, category, and per-variant price, availability, and images).
+It is the deterministic counterpart to the LLM-based `json` format. The
+returned `product` field contains the extracted fields.
+
+```ruby
+doc = client.scrape("https://example.com/products/widget",
+  Firecrawl::Models::ScrapeOptions.new(formats: ["product"]))
+
+puts doc.product
+```
+
 ### Parse
 
 Upload a local file (`html`, `pdf`, `docx`, etc.) via multipart form data and
 parse it synchronously. Parse options intentionally exclude browser-only
-features such as change tracking, screenshot, branding, audio, video, actions,
+features such as change tracking, screenshot, branding, audio, video, product, actions,
 wait_for, location, and mobile. The `proxy` option only accepts `"auto"` or `"basic"`.
 
 ```ruby

data/lib/firecrawl/models/document.rb

@@ -7,7 +7,7 @@ module Firecrawl
       attr_reader :markdown, :html, :raw_html, :json, :summary,
                   :metadata, :links, :images, :screenshot, :audio,
                   :video, :attributes, :actions, :answer, :highlights,
-                  :warning, :change_tracking, :branding
+                  :warning, :change_tracking, :branding, :product
 
       def initialize(data)
         @markdown = data["markdown"]
@@ -28,6 +28,7 @@ module Firecrawl
         @warning = data["warning"]
         @change_tracking = data["changeTracking"]
         @branding = data["branding"]
+        @product = data["product"] && ProductProfile.new(data["product"])
       end
 
       def to_s

data/lib/firecrawl/models/parse_options.rb

@@ -5,10 +5,10 @@ module Firecrawl
     # Options for parsing uploaded files via `/v2/parse`.
     #
     # Parse does not support browser-rendering features (actions, waitFor,
-    # location, mobile) nor screenshot/branding/audio/video/changeTracking formats. The
+    # location, mobile) nor screenshot/branding/product/audio/video/changeTracking formats. The
     # proxy field only accepts "auto" or "basic".
     class ParseOptions
-      UNSUPPORTED_FORMATS = %w[changeTracking screenshot screenshot@fullPage branding audio video].freeze
+      UNSUPPORTED_FORMATS = %w[changeTracking screenshot screenshot@fullPage branding product audio video].freeze
 
       FIELDS = %i[
         formats headers include_tags exclude_tags only_main_content

data/lib/firecrawl/models/product_profile.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # Structured product information extracted from a product page via the
+    # `product` scrape format.
+    class ProductProfile
+      # An image associated with a product or variant.
+      class Image
+        attr_reader :url, :alt
+
+        def initialize(data)
+          @url = data["url"]
+          @alt = data["alt"]
+        end
+      end
+
+      # A monetary value with an optional currency and formatted string.
+      class Price
+        attr_reader :amount, :currency, :formatted
+
+        def initialize(data)
+          @amount = data["amount"]
+          @currency = data["currency"]
+          @formatted = data["formatted"]
+        end
+      end
+
+      # Stock availability information for a variant. Always present.
+      class Availability
+        attr_reader :in_stock, :text
+
+        def initialize(data)
+          data ||= {}
+          @in_stock = data["inStock"] || false
+          @text = data["text"]
+        end
+      end
+
+      # Sale pricing for a variant, carrying the pre-sale original price.
+      class Sale
+        attr_reader :original_price
+
+        def initialize(data)
+          @original_price = data["originalPrice"] && Price.new(data["originalPrice"])
+        end
+      end
+
+      # A purchasable variant of a product. Pricing, availability, and images
+      # live here rather than on the top-level product.
+      class Variant
+        attr_reader :id, :sku, :title, :values, :price, :sale,
+                    :availability, :images
+
+        def initialize(data)
+          @id = data["id"]
+          @sku = data["sku"]
+          @title = data["title"]
+          @values = data["values"]
+          @price = data["price"] && Price.new(data["price"])
+          @sale = data["sale"] && Sale.new(data["sale"])
+          @availability = Availability.new(data["availability"])
+          @images = (data["images"] || []).map { |img| Image.new(img) }
+        end
+      end
+
+      attr_reader :title, :brand, :category, :url, :description, :variants
+
+      def initialize(data)
+        @title = data["title"]
+        @brand = data["brand"]
+        @category = data["category"]
+        @url = data["url"]
+        @description = data["description"]
+        @variants = (data["variants"] || []).map { |variant| Variant.new(variant) }
+      end
+
+      def to_s
+        "ProductProfile{title=#{title || 'untitled'}, url=#{url || 'unknown'}}"
+      end
+    end
+  end
+end

data/lib/firecrawl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Firecrawl
-  VERSION = "1.9.0"
+  VERSION = "1.9.1"
 end

data/lib/firecrawl.rb

@@ -4,6 +4,7 @@ require_relative "firecrawl/version"
 require_relative "firecrawl/errors"
 require_relative "firecrawl/http_client"
 require_relative "firecrawl/models/query_format"
+require_relative "firecrawl/models/product_profile"
 require_relative "firecrawl/models/document"
 require_relative "firecrawl/models/scrape_options"
 require_relative "firecrawl/models/crawl_options"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: firecrawl-sdk
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.9.1
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-16 00:00:00.000000000 Z
+date: 2026-06-17 00:00:00.000000000 Z
 dependencies: []
 description: A type-safe Ruby client for the Firecrawl v2 API. Supports scraping,
   crawling, batch scraping, URL mapping, web search, and AI agent operations.
@@ -41,6 +41,7 @@ files:
 - lib/firecrawl/models/monitor.rb
 - lib/firecrawl/models/parse_file.rb
 - lib/firecrawl/models/parse_options.rb
+- lib/firecrawl/models/product_profile.rb
 - lib/firecrawl/models/query_format.rb
 - lib/firecrawl/models/scrape_options.rb
 - lib/firecrawl/models/search_data.rb