firecrawl-sdk 1.17.0 → 1.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4692141ed256c6cf62171578f7bfdbb852ddb915a60b48ba520a73ecc8885b1
-  data.tar.gz: ff206e069d080e13598824ff3faa7eaf86b89b2cacbc051cd53aa861b20d1977
+  metadata.gz: e2b500556e1d7b0d222ae8937ae86dccdcf8c6499871c0202608a46b4611ef17
+  data.tar.gz: 2e4913c995ed97d8b55f295ab6adb0e61fe42cc0f08aff1f8aa12763f765b2be
 SHA512:
-  metadata.gz: 83a86911be8bfd5b9736bbfbe610c40934b31a9e6da25de714972be4399c9374421955e2b0ef5e41b6a15c0829c3c3ff30dbc1004a75c9a6210182f0df620399
-  data.tar.gz: 9ca272944fc87bf14462b30e0f7f99239a1253ca11c88c1d7393469f52491362e0a72f7c5e354467e0f154c1e780aa08732e162fdc2345832ffe0d4779f98bc9
+  metadata.gz: d138c5083321098460e7ab5777201300ba0b1701f93361e97a27e0b87c88c9bd3163e56124d9b2da94536855a99e41522d13002c73379d1c67dd7bfb280b9624
+  data.tar.gz: 64e7178e770554abd242289756c2de70fcd3d76d2104002e36c2d8773065aa14f1e4ca161b60a72ed063da9fb4f5fa1a050d49f79809fbedf951ce2d481909fe

data/README.md

@@ -126,6 +126,15 @@ doc = client.parse(file,
 puts doc.markdown
 ```
 
+List the file formats the parse endpoint accepts. `available` is `false` for
+formats the deployment can't currently handle (e.g. images when OCR is off).
+
+```ruby
+client.get_parse_formats.each do |f|
+  puts "#{f.format} (#{f.kind}) #{f.extensions.join(", ")} #{f.mime_types.join(", ")} available=#{f.available}"
+end
+```
+
 ### Crawl
 
 ```ruby

data/lib/firecrawl/client.rb

@@ -195,6 +195,15 @@ module Firecrawl
       Models::Document.new(data)
     end
 
+    # Lists the file formats accepted by {#parse} on this deployment.
+    #
+    # @return [Array<Models::ParseFormat>]
+    def get_parse_formats
+      raw = @http.get("/v2/parse/formats")
+      formats = (raw["data"] || {})["formats"] || []
+      formats.map { |f| Models::ParseFormat.new(f) }
+    end
+
     # ================================================================
     # CRAWL
     # ================================================================

data/lib/firecrawl/models/parse_format.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # A file format accepted by the `/v2/parse` endpoint.
+    #
+    # `kind` is usually one of {KIND_DOCUMENT} or {KIND_IMAGE}, but newer API
+    # versions may return other values, which are kept as-is.
+    class ParseFormat
+      KIND_DOCUMENT = "document"
+      KIND_IMAGE = "image"
+
+      attr_reader :format, :kind, :extensions, :mime_types, :available
+
+      def initialize(data)
+        @format = data["format"]
+        @kind = data["kind"]
+        @extensions = data["extensions"] || []
+        @mime_types = data["mimeTypes"] || []
+        @available = data["available"]
+      end
+
+      def document?
+        kind == KIND_DOCUMENT
+      end
+
+      def image?
+        kind == KIND_IMAGE
+      end
+
+      def to_s
+        "ParseFormat{format=#{format}, kind=#{kind}, available=#{available}}"
+      end
+    end
+  end
+end

data/lib/firecrawl/version.rb

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

data/lib/firecrawl.rb

@@ -22,6 +22,7 @@ require_relative "firecrawl/models/search_options"
 require_relative "firecrawl/models/search_data"
 require_relative "firecrawl/models/parse_file"
 require_relative "firecrawl/models/parse_options"
+require_relative "firecrawl/models/parse_format"
 require_relative "firecrawl/models/agent_options"
 require_relative "firecrawl/models/agent_response"
 require_relative "firecrawl/models/agent_list_response"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: firecrawl-sdk
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.17.1
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-08 00:00:00.000000000 Z
+date: 2026-10-02 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.
@@ -45,6 +45,7 @@ files:
 - lib/firecrawl/models/menu_profile.rb
 - lib/firecrawl/models/monitor.rb
 - lib/firecrawl/models/parse_file.rb
+- lib/firecrawl/models/parse_format.rb
 - lib/firecrawl/models/parse_options.rb
 - lib/firecrawl/models/pdf_parser.rb
 - lib/firecrawl/models/product_profile.rb