firecrawl-sdk 1.7.0 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f89972a4033215c664988fa49128f1fa00ce00954ee95df9c18862d51ab3510f
-  data.tar.gz: 49dccdb0175e34e36f824e27973a3bcbd3a1327a266658113af69752da274a5d
+  metadata.gz: 1c5ff8541498b47b08ff9b54d1c14969c734fba849e09c3fcc1d48143be53f1e
+  data.tar.gz: 71fb5c61c9c20ec229d077b7db82eb2ba60c48581a0b96969f7d515fa91778eb
 SHA512:
-  metadata.gz: fa95c7d9d96a3278d339292a6ec9dd70add7a5e74fea10b1b8a96989255dcd5e3d125a16ec6094e06b02e83da03a9f7a8c4e9d7a51469697f9377d31fc25f69e
-  data.tar.gz: 3f95f218c9f090fce256a2842db6ad6291e24ac2b06d36bc535e298db3f3dee7b312fc91fe46cdd94d43b40d7dae337e7c0aa5e4c67eb0fbe0e422398ecc757c
+  metadata.gz: 2a44065aa34a8bd32f691ebd249c4d11b48998582dd6ba9f5da6bca80d95370341be3b0dd0482076918b8ccad268b928034b9bd477daddd831bc042da59391a2
+  data.tar.gz: 347d45a6810b3b66afb4a6bbb6b977f13dbf770c2c57eaedcb8bc9d7c4b071bf3be25f299c606adc74cc74819a7f6c23ae9009dbe183d789a7c36dc76a43ec8e

data/lib/firecrawl/client.rb

@@ -39,9 +39,10 @@ module Firecrawl
       backoff_factor: DEFAULT_BACKOFF_FACTOR
     )
       resolved_key = api_key || ENV["FIRECRAWL_API_KEY"]
-      if resolved_key.nil? || resolved_key.strip.empty?
-        raise FirecrawlError, "API key is required. Provide api_key: or set FIRECRAWL_API_KEY environment variable."
-      end
+      # A nil/empty key is allowed: scrape, search, and interact fall back to the
+      # keyless free tier (rate-limited per IP). Other methods return 401 from the
+      # API until a key is provided.
+      resolved_key = nil if resolved_key.nil? || resolved_key.strip.empty?
 
       resolved_url = api_url || ENV["FIRECRAWL_API_URL"] || DEFAULT_API_URL
       unless resolved_url.match?(%r{\Ahttps?://}i)
@@ -78,6 +79,7 @@ module Firecrawl
 
       body = { "url" => url }
       body.merge!(options.to_h) if options
+      body["origin"] ||= "ruby-sdk@#{Firecrawl::VERSION}"
       raw = @http.post("/v2/scrape", body)
       data = raw["data"] || raw
       Models::Document.new(data)
@@ -96,6 +98,7 @@ module Firecrawl
 
       body = { "code" => code, "language" => language }
       body["timeout"] = timeout if timeout
+      body["origin"] ||= "ruby-sdk@#{Firecrawl::VERSION}"
       @http.post("/v2/scrape/#{job_id}/interact", body)
     end
 
@@ -377,6 +380,7 @@ module Firecrawl
 
       body = { "query" => query }
       body.merge!(options.to_h) if options
+      body["origin"] ||= "ruby-sdk@#{Firecrawl::VERSION}"
       raw = @http.post("/v2/search", body)
       data = raw["data"] || raw
       Models::SearchData.new(data)

data/lib/firecrawl/http_client.rb

@@ -23,7 +23,7 @@ module Firecrawl
     def post(path, body, extra_headers: {})
       uri = URI("#{@base_url}#{path}")
       request = Net::HTTP::Post.new(uri)
-      request["Authorization"] = "Bearer #{@api_key}"
+      request["Authorization"] = "Bearer #{@api_key}" if @api_key
       request["Content-Type"] = "application/json"
       extra_headers.each { |k, v| request[k] = v }
       request.body = JSON.generate(body)
@@ -34,7 +34,7 @@ module Firecrawl
     def get(path)
       uri = URI("#{@base_url}#{path}")
       request = Net::HTTP::Get.new(uri)
-      request["Authorization"] = "Bearer #{@api_key}"
+      request["Authorization"] = "Bearer #{@api_key}" if @api_key
       execute_with_retry(uri, request)
     end
 
@@ -47,7 +47,7 @@ module Firecrawl
         raise FirecrawlError, "Absolute URL origin (#{uri.scheme}://#{uri.host}:#{uri.port}) does not match API base URL origin (#{base_uri.scheme}://#{base_uri.host}:#{base_uri.port}). Refusing to send credentials."
       end
       request = Net::HTTP::Get.new(uri)
-      request["Authorization"] = "Bearer #{@api_key}"
+      request["Authorization"] = "Bearer #{@api_key}" if @api_key
       execute_with_retry(uri, request)
     end
 
@@ -55,7 +55,7 @@ module Firecrawl
     def delete(path)
       uri = URI("#{@base_url}#{path}")
       request = Net::HTTP::Delete.new(uri)
-      request["Authorization"] = "Bearer #{@api_key}"
+      request["Authorization"] = "Bearer #{@api_key}" if @api_key
       execute_with_retry(uri, request)
     end
 
@@ -63,7 +63,7 @@ module Firecrawl
     def patch(path, body)
       uri = URI("#{@base_url}#{path}")
       request = Net::HTTP::Patch.new(uri)
-      request["Authorization"] = "Bearer #{@api_key}"
+      request["Authorization"] = "Bearer #{@api_key}" if @api_key
       request["Content-Type"] = "application/json"
       request.body = JSON.generate(body)
       execute_with_retry(uri, request)
@@ -84,7 +84,7 @@ module Firecrawl
 
       builder = lambda do
         request = Net::HTTP::Post.new(uri)
-        request["Authorization"] = "Bearer #{@api_key}"
+        request["Authorization"] = "Bearer #{@api_key}" if @api_key
         request["Content-Type"] = "multipart/form-data; boundary=#{boundary}"
         request.body = body
         request

data/lib/firecrawl/models/parse_options.rb

@@ -13,7 +13,7 @@ module Firecrawl
       FIELDS = %i[
         formats headers include_tags exclude_tags only_main_content
         timeout parsers skip_tls_verification remove_base64_images
-        block_ads proxy integration json_options
+        block_ads proxy integration redact_pii json_options
       ].freeze
 
       attr_reader(*FIELDS)
@@ -38,6 +38,7 @@ module Firecrawl
           "blockAds" => block_ads,
           "proxy" => proxy,
           "integration" => integration,
+          "redactPII" => redact_pii,
           "jsonOptions" => json_options.is_a?(Hash) ? json_options : json_options&.to_h,
         }.compact
       end

data/lib/firecrawl/models/scrape_options.rb

@@ -8,7 +8,7 @@ module Firecrawl
         formats headers include_tags exclude_tags only_main_content
         timeout wait_for mobile parsers actions location
         skip_tls_verification remove_base64_images block_ads proxy
-        max_age store_in_cache lockdown integration
+        max_age store_in_cache lockdown redact_pii integration
       ].freeze
 
       attr_reader(*FIELDS)
@@ -38,6 +38,7 @@ module Firecrawl
           "maxAge" => max_age,
           "storeInCache" => store_in_cache,
           "lockdown" => lockdown,
+          "redactPII" => redact_pii,
           "integration" => integration,
         }.compact
       end

data/lib/firecrawl/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: firecrawl-sdk
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.1
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-23 00:00:00.000000000 Z
+date: 2026-06-15 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.