firecrawl-sdk 1.16.0 → 1.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f3695aabd644bab09a7baa7c340d72fe38f376cba6d2f2cc1635d9df2f3d66e
-  data.tar.gz: 445c52d6c75a8a3ba54b751a00b6ccf3d09745693bbee5462f6253eba3f7eb8d
+  metadata.gz: e2b500556e1d7b0d222ae8937ae86dccdcf8c6499871c0202608a46b4611ef17
+  data.tar.gz: 2e4913c995ed97d8b55f295ab6adb0e61fe42cc0f08aff1f8aa12763f765b2be
 SHA512:
-  metadata.gz: daaf47ae8bc4b2ae5a549b873c5978fa01e1abf2cd9a4dfd5829da5a0797b2109892885c991830a4aecd6c69b469ac09ecd52a545f278238d57ecb13a779be42
-  data.tar.gz: 73433fb46a58926b598d1fee36aadf7551dbfdaf636d484860d81bf65fd7c13ce014272e5b32508db76ecfd6db728ba64e5232d764f6207f2b70b1e6867032ac
+  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

@@ -129,6 +129,10 @@ module Firecrawl
 
     # Search GitHub research content.
     #
+    # @deprecated Stops responding after 2026-11-03. Use the developer index at
+    #   GET or POST /v2/search/developer, which this SDK does not wrap yet, so
+    #   call it directly. It does not carry over the score breakdown or the
+    #   web fallback results.
     # @param query_text [String] GitHub query
     # @param options [Hash] optional query parameters
     # @return [Hash]
@@ -191,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/models/search_options.rb

@@ -5,7 +5,7 @@ module Firecrawl
     # Options for a web search request.
     class SearchOptions
       FIELDS = %i[
-        sources categories include_domains exclude_domains limit tbs location
+        sources categories include_domains exclude_domains limit tbs location country
         ignore_invalid_urls timeout highlights scrape_options integration enterprise
       ].freeze
 
@@ -24,6 +24,7 @@ module Firecrawl
           "limit" => limit,
           "tbs" => tbs,
           "location" => location,
+          "country" => country,
           "ignoreInvalidURLs" => ignore_invalid_urls,
           "timeout" => timeout,
           "highlights" => highlights,

data/lib/firecrawl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Firecrawl
-  VERSION = "1.16.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.16.0
+  version: 1.17.1
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-31 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