firecrawl-sdk 1.17.6 → 1.17.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a95cf606a9dba18ec0e90ff361f6100e76b035904a045fbc35b28f51155ba679
-  data.tar.gz: 63dcd5e0a23da6fc58bd7d4aa9b0fd5f3c3b36506ffb46a5b44fd2f2ee6b019c
+  metadata.gz: 22543b5053874d9d1a815949df7212abbcca9a72738a23ecfc696194696b6ad6
+  data.tar.gz: a53387ffdbb11b21ce357368f617dd83fdf341619a022db5997b8a4e3bfab6b1
 SHA512:
-  metadata.gz: 72b349328602ff6f9b7528ff975b192a319f66fc14e398bfda51ee74cf9c8ab5a824a455609d9a642e463721492bb5962acb3b00c80e4a7bb801da059a0f1581
-  data.tar.gz: 19ac1a8b8237502e2e1b7907e637a7a070d8e0f3d309c121eec1b8328dcc233d499d72354cce959fae7514edfe7314db33f90427441ec16167f373af2514fde6
+  metadata.gz: 7345b8e668fd1ece22c0de23408a7f99e6e5da42f2a573973cb32b4db18cd5bb2d8f61f505e0de5df4e0a0c96fd11af8c35531cd98bcdaa2aab470227678a9ac
+  data.tar.gz: 7a4ec95b23cd3e767e93742600a01c8a51123d9c9589823bf62f6a2fb2561ad77fb05c95a45324e44a0ef7322aea4fcd94a46ce6e3b705f61ec5831901ff27ec

data/README.md

@@ -193,6 +193,25 @@ results = client.search("latest news",
   Firecrawl::Models::SearchOptions.new(limit: 5, location: "US"))
 ```
 
+### Developer Search
+
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `developer_search` replaces the deprecated `search_github`.
+
+```ruby
+response = client.developer_search(
+  "retry an http request with exponential backoff",
+  Firecrawl::Models::DeveloperSearchOptions.new(
+    k: 5,
+    types: ["issue", "pull_request"],
+    repos: ["square/okhttp"]
+  )
+)
+
+response.results.each do |result|
+  puts "#{result.title} #{result.url}"
+end
+```
+
 ### Agent
 
 ```ruby

data/lib/firecrawl/client.rb

@@ -133,10 +133,9 @@ 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.
+    # @deprecated Stops responding after 2026-11-03. Use {#developer_search},
+    #   which 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]
@@ -144,6 +143,22 @@ module Firecrawl
       @http.get("/v2/search/research/github#{query(options.merge("query" => query_text, "origin" => "ruby-sdk@#{Firecrawl::VERSION}"))}")
     end
 
+    # Searches the developer index: public repositories, GitHub issues, merged
+    # pull requests, READMEs and code documentation.
+    #
+    # @param query [String] the search query
+    # @param options [Models::DeveloperSearchOptions, nil] developer search filters
+    # @return [Models::DeveloperSearchResponse]
+    # @raise [ArgumentError] if the query is blank
+    def developer_search(query, options = nil)
+      raise ArgumentError, "Query is required" if query.nil? || query.to_s.strip.empty?
+
+      body = { "query" => query }
+      body.merge!(options.to_h) if options
+      body["origin"] ||= "ruby-sdk@#{Firecrawl::VERSION}"
+      Models::DeveloperSearchResponse.new(@http.post("/v2/search/developer", body))
+    end
+
     # Interacts with the scrape-bound browser session for a scrape job.
     #
     # @param job_id [String] the scrape job ID

data/lib/firecrawl/models/developer_search_options.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # Options for a developer search request. Unset fields are omitted.
+    #
+    # - k: total ranked results, 1 to 100 (default 10)
+    # - passages: passages per result, 1 to 5 (default 1)
+    # - types: result kinds, any of "doc", "issue", "pull_request", "readme"
+    # - repos: GitHub owner/name filters, at most 20
+    # - sources: developer documentation source IDs, at most 20
+    # - language: one case-insensitive GitHub Linguist primary language
+    # - topic: repository topics that must all match, at most 8
+    # - license: one case-insensitive SPDX repository license identifier
+    # - min_stars, max_stars, archived, fork: repository filters
+    # - skills: "only" returns packaged agent-skill evidence only
+    class DeveloperSearchOptions
+      FIELDS = %i[
+        k passages types repos sources language topic license
+        min_stars max_stars archived fork skills
+      ].freeze
+
+      attr_reader(*FIELDS)
+
+      def initialize(**kwargs)
+        unknown = kwargs.keys - FIELDS
+        raise ArgumentError, "unknown developer search option(s): #{unknown.join(", ")}" unless unknown.empty?
+
+        FIELDS.each { |f| instance_variable_set(:"@#{f}", kwargs[f]) }
+      end
+
+      def to_h
+        FIELDS.to_h { |f| [f.to_s, public_send(f)] }.compact
+      end
+    end
+  end
+end

data/lib/firecrawl/models/developer_search_response.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Firecrawl
+  module Models
+    # One matched passage of a developer search result.
+    class DeveloperSearchPassage
+      attr_reader :text, :citation_url
+
+      def initialize(data)
+        @text = data["text"]
+        @citation_url = data["citation_url"]
+      end
+    end
+
+    # One ranked developer search result. `license` is either an SPDX string or
+    # a disclosure object (Hash), so it is kept as returned.
+    class DeveloperSearchResult
+      attr_reader :id, :url, :title, :passages, :license
+
+      def initialize(data)
+        @id = data["id"]
+        @url = data["url"]
+        @title = data["title"]
+        @passages = (data["passages"] || []).map { |p| DeveloperSearchPassage.new(p) }
+        @license = data["license"]
+      end
+    end
+
+    # Whether a requested repository is indexed, and which result types it has.
+    class DeveloperSearchRepoStatus
+      attr_reader :repo, :indexed, :types
+
+      def initialize(data)
+        @repo = data["repo"]
+        @indexed = data["indexed"] == true
+        @types = data["types"] || {}
+      end
+
+      def indexed?
+        indexed
+      end
+    end
+
+    # Whether a requested documentation source is indexed.
+    class DeveloperSearchSourceStatus
+      attr_reader :source, :indexed
+
+      def initialize(data)
+        @source = data["source"]
+        @indexed = data["indexed"] == true
+      end
+
+      def indexed?
+        indexed
+      end
+    end
+
+    # Response from a developer search. `repos` and `sources` are present only
+    # when those filters were requested.
+    class DeveloperSearchResponse
+      attr_reader :success, :partial, :results, :repos, :sources
+
+      def initialize(data)
+        @success = data["success"] == true
+        @partial = data["partial"] == true
+        @results = (data["results"] || []).map { |r| DeveloperSearchResult.new(r) }
+        @repos = data["repos"]&.map { |r| DeveloperSearchRepoStatus.new(r) }
+        @sources = data["sources"]&.map { |s| DeveloperSearchSourceStatus.new(s) }
+      end
+
+      def to_s
+        "DeveloperSearchResponse{results=#{results.size}}"
+      end
+    end
+  end
+end

data/lib/firecrawl/version.rb

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

data/lib/firecrawl.rb

@@ -20,6 +20,8 @@ require_relative "firecrawl/models/map_options"
 require_relative "firecrawl/models/map_data"
 require_relative "firecrawl/models/search_options"
 require_relative "firecrawl/models/search_data"
+require_relative "firecrawl/models/developer_search_options"
+require_relative "firecrawl/models/developer_search_response"
 require_relative "firecrawl/models/parse_file"
 require_relative "firecrawl/models/parse_options"
 require_relative "firecrawl/models/parse_format"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: firecrawl-sdk
 version: !ruby/object:Gem::Version
-  version: 1.17.6
+  version: 1.17.7
 platform: ruby
 authors:
 - Firecrawl
@@ -43,6 +43,8 @@ files:
 - lib/firecrawl/models/crawl_options.rb
 - lib/firecrawl/models/crawl_response.rb
 - lib/firecrawl/models/credit_usage.rb
+- lib/firecrawl/models/developer_search_options.rb
+- lib/firecrawl/models/developer_search_response.rb
 - lib/firecrawl/models/document.rb
 - lib/firecrawl/models/map_data.rb
 - lib/firecrawl/models/map_options.rb