firecrawl-sdk 1.8.0 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e60c06ab05dc82b6a73b45fd0653e25ea9a52e6995b653adc02de1ead2544fc
-  data.tar.gz: 9d7229377ce68b2bf96edce29aa9db2685d11c45c108e1cdb4bab7f9b29b4081
+  metadata.gz: 1c5ff8541498b47b08ff9b54d1c14969c734fba849e09c3fcc1d48143be53f1e
+  data.tar.gz: 71fb5c61c9c20ec229d077b7db82eb2ba60c48581a0b96969f7d515fa91778eb
 SHA512:
-  metadata.gz: 88f68bb69bf81891e6768901dfcdd7ee04c8dc2d878056f85311a7acf79f5a2fe5a8dc9ef6c9cd03570e690404bf498cccc994c733b9261d96a829ae78a581fa
-  data.tar.gz: ec03a978278b33c33e5452b8876a80ba205401e5a4689c023ed9ad1afa62cb28720cbb41d4e21272e4fb077f6b4c2767b6cfbe375b6d041b84246488162f212d
+  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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Firecrawl
-  VERSION = "1.8.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.8.0
+  version: 1.8.1
 platform: ruby
 authors:
 - Firecrawl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-01 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.