firecrawl-sdk 1.9.1 → 1.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 616551a9caf1736bbc849f0058ce52dca94728cf024cb91319393e5bf192cfe1
-  data.tar.gz: ffe33e36c76d4a69319940e148ccce30bc50b3e44b81915698c76f7e4a1cb99b
+  metadata.gz: f17ef4d354c427ea550adb739310cd6b7d03a148c72febb6c69133f0f39a10c0
+  data.tar.gz: e1907bd8120fc8bb893233d85ec9f63cae511e65ce8db7dfee848ed0592de1d5
 SHA512:
-  metadata.gz: fbbe64a2fd02c6a8214cbb77f7dfc64791e392d2192f4c9d657ed6cb9bab3c820ed6ff9a430b0fb1abfdd11076b6a64600a4f8df0f9232bda02b8c3bf27d1385
-  data.tar.gz: f2a722b6f10ac0254d3d8f7dda69f653751539056cce8690b703e023f35b021b9ac451a798800bcb2293a9f414014d9eb22bb54fea779971e79cde106dde4b5c
+  metadata.gz: 93523ad1fe6bae7e66a9dc51b0c40d1cd580cdb6c9310a6709baa52142bf52bbed036c7c1b1f0361041d6672b2ac74cd45e974e3a0d251b27add73cae5176d34
+  data.tar.gz: ca1db36ccabd4060775c2e91f4284e3cf0f2ac393ee2b983a5437a66aa01b74fc477a7bce79fbb9468c51ca696d744e38893bb98729343b8c7c58fd0de6f318c

data/README.md

@@ -88,6 +88,21 @@ doc = client.scrape("https://example.com/products/widget",
 puts doc.product
 ```
 
+### Menu Extraction
+
+Use the `menu` format on restaurant/merchant menu pages to get structured
+menu data (merchant profile plus ordered sections, each holding items with
+per-item price, availability, images, and dietary information). It is the
+deterministic counterpart to the LLM-based `json` format. The returned `menu`
+field contains the extracted fields.
+
+```ruby
+doc = client.scrape("https://example.com/menu",
+  Firecrawl::Models::ScrapeOptions.new(formats: ["menu"]))
+
+puts doc.menu
+```
+
 ### Parse
 
 Upload a local file (`html`, `pdf`, `docx`, etc.) via multipart form data and

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, :product
+                  :warning, :change_tracking, :branding, :product, :menu
 
       def initialize(data)
         @markdown = data["markdown"]
@@ -29,6 +29,7 @@ module Firecrawl
         @change_tracking = data["changeTracking"]
         @branding = data["branding"]
         @product = data["product"] && ProductProfile.new(data["product"])
+        @menu = data["menu"] && MenuProfile.new(data["menu"])
       end
 
       def to_s

data/lib/firecrawl/models/menu_profile.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # Structured menu information extracted from a restaurant/merchant page
+    # via the `menu` scrape format.
+    class MenuProfile
+      # An image associated with a menu item.
+      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 menu item. Always present.
+      class Availability
+        attr_reader :in_stock, :text
+
+        def initialize(data)
+          data ||= {}
+          @in_stock = data["inStock"] || false
+          @text = data["text"]
+        end
+      end
+
+      # Merchant (restaurant/business) profile for the menu.
+      class Merchant
+        attr_reader :name, :type, :location
+
+        def initialize(data)
+          data ||= {}
+          @name = data["name"]
+          @type = data["type"]
+          @location = data["location"]
+        end
+      end
+
+      # Identifiers carried on a menu item.
+      class Identifiers
+        attr_reader :merchant_item_id
+
+        def initialize(data)
+          data ||= {}
+          @merchant_item_id = data["merchantItemId"]
+        end
+      end
+
+      # A single item on the menu. Pricing, availability, images, and dietary
+      # information live here rather than on the section or profile.
+      class Item
+        attr_reader :id, :name, :description, :images, :price, :availability,
+                    :dietary, :calories, :option_groups, :identifiers, :url,
+                    :source_url
+
+        def initialize(data)
+          @id = data["id"]
+          @name = data["name"]
+          @description = data["description"]
+          @images = (data["images"] || []).map { |img| Image.new(img) }
+          @price = data["price"] && Price.new(data["price"])
+          @availability = Availability.new(data["availability"])
+          @dietary = data["dietary"] || []
+          @calories = data["calories"]
+          @option_groups = data["optionGroups"] || []
+          @identifiers = Identifiers.new(data["identifiers"])
+          @url = data["url"]
+          @source_url = data["sourceUrl"]
+        end
+      end
+
+      # An ordered group of menu items.
+      class Section
+        attr_reader :id, :name, :description, :items
+
+        def initialize(data)
+          @id = data["id"]
+          @name = data["name"]
+          @description = data["description"]
+          @items = (data["items"] || []).map { |item| Item.new(item) }
+        end
+      end
+
+      attr_reader :is_menu, :confidence, :merchant, :currency, :sections,
+                  :source_url
+
+      def initialize(data)
+        @is_menu = data["isMenu"] || false
+        @confidence = data["confidence"]
+        @merchant = Merchant.new(data["merchant"])
+        @currency = data["currency"]
+        @sections = (data["sections"] || []).map { |section| Section.new(section) }
+        @source_url = data["sourceUrl"]
+      end
+
+      def to_s
+        "MenuProfile{merchant=#{merchant&.name || 'unknown'}, sourceUrl=#{source_url || 'unknown'}}"
+      end
+    end
+  end
+end

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/product/audio/video/changeTracking formats. The
+    # location, mobile) nor screenshot/branding/product/menu/audio/video/changeTracking formats. The
     # proxy field only accepts "auto" or "basic".
     class ParseOptions
-      UNSUPPORTED_FORMATS = %w[changeTracking screenshot screenshot@fullPage branding product audio video].freeze
+      UNSUPPORTED_FORMATS = %w[changeTracking screenshot screenshot@fullPage branding product menu audio video].freeze
 
       FIELDS = %i[
         formats headers include_tags exclude_tags only_main_content

data/lib/firecrawl/version.rb

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

data/lib/firecrawl.rb

@@ -5,6 +5,7 @@ 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/menu_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.1
+  version: 1.9.2
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-17 00:00:00.000000000 Z
+date: 2026-06-19 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.
@@ -38,6 +38,7 @@ files:
 - lib/firecrawl/models/document.rb
 - lib/firecrawl/models/map_data.rb
 - lib/firecrawl/models/map_options.rb
+- lib/firecrawl/models/menu_profile.rb
 - lib/firecrawl/models/monitor.rb
 - lib/firecrawl/models/parse_file.rb
 - lib/firecrawl/models/parse_options.rb