context.dev 1.25.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1a0062418eca906ad8f308d3ab6541bd3a6c9f0b8bc1805b58a978e7aea61c2
-  data.tar.gz: a02eb3ec2fe28d611a14d976810b5ff51c2e2c49e432cdea9d89661eaae2de9c
+  metadata.gz: 8f2f6c8c373d61ab07f5969d5f7f9bb52539093279b41b09a5e7bbefc6d4bd9e
+  data.tar.gz: d4afbf2bb5144a50a0b9930321c3ab8b3d193fd1a01da993ae2285a226a32597
 SHA512:
-  metadata.gz: 7b3c3c7ff3f1e75e6199c810205c287cb0b1e03ff2cf332a2392e5e5880a3722090959d96b39bd39dddefd1c4961faf569d03c10fbcda26e9231ad67875dd45b
-  data.tar.gz: 5aef11c0e5b365ad204eced64e126807a96dfe32351da7940a2f780c07c461bcf0e2e8542e2e2cbfc8af6fa41d49864788b9979101e3d42e8920fb853c4ce5da
+  metadata.gz: 6e38d8989d26cecb219a1dcbb39d29c4f7bc92d9dda81de355959267ceeaa1c1587ea778163a1ce5267afcff70d36ac666b6b442226ba359ca0c82465b8bb05a
+  data.tar.gz: b9a94c13fc5cc8bf84c84bfbd46277e519d878bfc74f6d82f4e941bf01adf4bb9b9197f2eb32f06d722624a410ee703b351beb7f1d0ff51f7228f7addd5ea75d

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.27.0 (2026-06-01)
+
+Full Changelog: [v1.26.0...v1.27.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.26.0...v1.27.0)
+
+### Features
+
+* **api:** manual updates ([e3971dc](https://github.com/context-dot-dev/context-ruby-sdk/commit/e3971dcc3b94f5b998562f8ecb82a292cc8f00bd))
+
+## 1.26.0 (2026-06-01)
+
+Full Changelog: [v1.25.0...v1.26.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.25.0...v1.26.0)
+
+### Features
+
+* **api:** api update ([d442168](https://github.com/context-dot-dev/context-ruby-sdk/commit/d442168b67accce12463e36f03630f155c1c7be3))
+* **api:** api update ([f3a97c1](https://github.com/context-dot-dev/context-ruby-sdk/commit/f3a97c19ef01be5e6cf1ce7ecfa26c972edfdf33))
+* **api:** api update ([8d8abf7](https://github.com/context-dot-dev/context-ruby-sdk/commit/8d8abf7c1600bce17ea26aa245f41b2e3199f722))
+
 ## 1.25.0 (2026-05-31)
 
 Full Changelog: [v1.24.0...v1.25.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.24.0...v1.25.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.25.0"
+gem "context.dev", "~> 1.27.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_extract_competitors_params.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#extract_competitors
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute domain
+      #   Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #   and normalized to their domain.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute num_competitors
+      #   Exact number of direct competitors to return. Defaults to 5.
+      #
+      #   @return [Integer, nil]
+      optional :num_competitors, Integer
+
+      # @!attribute timeout_ms
+      #   Optional timeout in milliseconds for the request. If the request takes longer
+      #   than this value, it will be aborted with a 408 status code. Maximum allowed
+      #   value is 300000ms (5 minutes).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!method initialize(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::WebExtractCompetitorsParams} for more details.
+      #
+      #   @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #
+      #   @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/context_dev/models/web_extract_competitors_response.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#extract_competitors
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute competitors
+      #   Direct competitors ordered by relevance and confidence.
+      #
+      #   @return [Array<ContextDev::Models::WebExtractCompetitorsResponse::Competitor>]
+      required :competitors,
+               -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebExtractCompetitorsResponse::Competitor] }
+
+      # @!attribute domain
+      #   Normalized input domain.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute status
+      #   Status of the response.
+      #
+      #   @return [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Status]
+      required :status, enum: -> { ContextDev::Models::WebExtractCompetitorsResponse::Status }
+
+      # @!attribute target
+      #   Target company profile inferred from the landing page.
+      #
+      #   @return [ContextDev::Models::WebExtractCompetitorsResponse::Target]
+      required :target, -> { ContextDev::Models::WebExtractCompetitorsResponse::Target }
+
+      # @!method initialize(competitors:, domain:, status:, target:)
+      #   @param competitors [Array<ContextDev::Models::WebExtractCompetitorsResponse::Competitor>] Direct competitors ordered by relevance and confidence.
+      #
+      #   @param domain [String] Normalized input domain.
+      #
+      #   @param status [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Status] Status of the response.
+      #
+      #   @param target [ContextDev::Models::WebExtractCompetitorsResponse::Target] Target company profile inferred from the landing page.
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        # @!attribute confidence
+        #   Confidence that this company is a direct competitor.
+        #
+        #   @return [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence]
+        required :confidence,
+                 enum: -> { ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence }
+
+        # @!attribute description
+        #   Short description of the competitor.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute domain
+        #   Competitor's normalized official domain.
+        #
+        #   @return [String]
+        required :domain, String
+
+        # @!attribute name
+        #   Competitor company or product name.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute source_urls
+        #   Search result URLs used as evidence for this competitor.
+        #
+        #   @return [Array<String>]
+        required :source_urls, ContextDev::Internal::Type::ArrayOf[String], api_name: :sourceUrls
+
+        # @!attribute url
+        #   Competitor website URL.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(confidence:, description:, domain:, name:, source_urls:, url:)
+        #   @param confidence [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence] Confidence that this company is a direct competitor.
+        #
+        #   @param description [String] Short description of the competitor.
+        #
+        #   @param domain [String] Competitor's normalized official domain.
+        #
+        #   @param name [String] Competitor company or product name.
+        #
+        #   @param source_urls [Array<String>] Search result URLs used as evidence for this competitor.
+        #
+        #   @param url [String] Competitor website URL.
+
+        # Confidence that this company is a direct competitor.
+        #
+        # @see ContextDev::Models::WebExtractCompetitorsResponse::Competitor#confidence
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH = :high
+          MEDIUM = :medium
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Status of the response.
+      #
+      # @see ContextDev::Models::WebExtractCompetitorsResponse#status
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        OK = :ok
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see ContextDev::Models::WebExtractCompetitorsResponse#target
+      class Target < ContextDev::Internal::Type::BaseModel
+        # @!attribute company_name
+        #   Company or product name inferred from the landing page.
+        #
+        #   @return [String]
+        required :company_name, String, api_name: :companyName
+
+        # @!attribute field
+        #   Specific operating field, product category, or market.
+        #
+        #   @return [String]
+        required :field, String
+
+        # @!attribute field_description
+        #   One-sentence description of what the target company sells and who it serves.
+        #
+        #   @return [String]
+        required :field_description, String, api_name: :fieldDescription
+
+        # @!attribute website_url
+        #   Resolved URL used for the landing page analysis.
+        #
+        #   @return [String]
+        required :website_url, String, api_name: :websiteUrl
+
+        # @!method initialize(company_name:, field:, field_description:, website_url:)
+        #   Target company profile inferred from the landing page.
+        #
+        #   @param company_name [String] Company or product name inferred from the landing page.
+        #
+        #   @param field [String] Specific operating field, product category, or market.
+        #
+        #   @param field_description [String] One-sentence description of what the target company sells and who it serves.
+        #
+        #   @param website_url [String] Resolved URL used for the landing page analysis.
+      end
+    end
+  end
+end

data/lib/context_dev/models/web_extract_params.rb

@@ -23,12 +23,12 @@ module ContextDev
       required :url, String
 
       # @!attribute fact_check
-      #   When true (default), every returned value must be grounded in facts stated on
-      #   the page; fields that cannot be supported by the page are returned as
-      #   null/empty. When false, the model may make reasonable inferences and derivations
-      #   from the page content (e.g. ideal customer, competitor analysis,
-      #   recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-      #   metrics) faithful to the source.
+      #   When true, every returned value must be grounded in facts stated on the page;
+      #   fields that cannot be supported by the page are returned as null/empty. When
+      #   false (default), the model may make reasonable inferences and derivations from
+      #   the page content (e.g. ideal customer, competitor analysis, recommendations)
+      #   while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+      #   faithful to the source.
       #
       #   @return [Boolean, nil]
       optional :fact_check, ContextDev::Internal::Type::Boolean, api_name: :factCheck
@@ -54,7 +54,7 @@ module ContextDev
 
       # @!attribute max_age_ms
       #   Return cached scrape results if a prior scrape for the same parameters is
-      #   younger than this many milliseconds.
+      #   younger than this many milliseconds. Defaults to 7 days (604800000 ms).
       #
       #   @return [Integer, nil]
       optional :max_age_ms, Integer, api_name: :maxAgeMs
@@ -93,7 +93,7 @@ module ContextDev
       #
       #   @param url [String] The starting website URL to crawl and extract from. Must include http:// or http
       #
-      #   @param fact_check [Boolean] When true (default), every returned value must be grounded in facts stated on th
+      #   @param fact_check [Boolean] When true, every returned value must be grounded in facts stated on the page; fi
       #
       #   @param follow_subdomains [Boolean] When true, follow links on subdomains of the starting URL's domain.
       #

data/lib/context_dev/models.rb

@@ -67,6 +67,8 @@ module ContextDev
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   WebExtractParams = ContextDev::Models::WebExtractParams

data/lib/context_dev/resources/web.rb

@@ -6,10 +6,8 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebExtractParams} for more details.
       #
-      # Crawl a website, convert pages to Markdown using the scrape cache, and extract
-      # structured data into the provided JSON Schema. The schema must describe the
-      # response data object. This endpoint does not accept targeted page-type
-      # selection.
+      # Crawl a website, use the provided JSON Schema and instructions to prioritize
+      # relevant internal links, and extract structured data from the selected pages.
       #
       # @overload extract(schema:, url:, fact_check: nil, follow_subdomains: nil, include_frames: nil, instructions: nil, max_age_ms: nil, pdf: nil, stop_after_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
@@ -17,7 +15,7 @@ module ContextDev
       #
       # @param url [String] The starting website URL to crawl and extract from. Must include http:// or http
       #
-      # @param fact_check [Boolean] When true (default), every returned value must be grounded in facts stated on th
+      # @param fact_check [Boolean] When true, every returned value must be grounded in facts stated on the page; fi
       #
       # @param follow_subdomains [Boolean] When true, follow links on subdomains of the starting URL's domain.
       #
@@ -51,6 +49,37 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebExtractCompetitorsParams} for more details.
+      #
+      # Analyze a company's landing page and web search evidence to return direct
+      # competitors for the same product or market.
+      #
+      # @overload extract_competitors(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #
+      # @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::WebExtractCompetitorsResponse]
+      #
+      # @see ContextDev::Models::WebExtractCompetitorsParams
+      def extract_competitors(params)
+        parsed, options = ContextDev::WebExtractCompetitorsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/competitors",
+          query: query.transform_keys(num_competitors: "numCompetitors", timeout_ms: "timeoutMS"),
+          model: ContextDev::Models::WebExtractCompetitorsResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebExtractFontsParams} for more details.
       #

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "1.25.0"
+  VERSION = "1.27.0"
 end

data/lib/context_dev.rb

@@ -80,6 +80,8 @@ require_relative "context_dev/models/utility_prefetch_by_email_params"
 require_relative "context_dev/models/utility_prefetch_by_email_response"
 require_relative "context_dev/models/utility_prefetch_params"
 require_relative "context_dev/models/utility_prefetch_response"
+require_relative "context_dev/models/web_extract_competitors_params"
+require_relative "context_dev/models/web_extract_competitors_response"
 require_relative "context_dev/models/web_extract_fonts_params"
 require_relative "context_dev/models/web_extract_fonts_response"
 require_relative "context_dev/models/web_extract_params"

data/rbi/context_dev/models/web_extract_competitors_params.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::WebExtractCompetitorsParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      # and normalized to their domain.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Exact number of direct competitors to return. Defaults to 5.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :num_competitors
+
+      sig { params(num_competitors: Integer).void }
+      attr_writer :num_competitors
+
+      # Optional timeout in milliseconds for the request. If the request takes longer
+      # than this value, it will be aborted with a 408 status code. Maximum allowed
+      # value is 300000ms (5 minutes).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      sig do
+        params(
+          domain: String,
+          num_competitors: Integer,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+        # and normalized to their domain.
+        domain:,
+        # Exact number of direct competitors to return. Defaults to 5.
+        num_competitors: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            domain: String,
+            num_competitors: Integer,
+            timeout_ms: Integer,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/context_dev/models/web_extract_competitors_response.rbi

@@ -0,0 +1,297 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::WebExtractCompetitorsResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Direct competitors ordered by relevance and confidence.
+      sig do
+        returns(
+          T::Array[
+            ContextDev::Models::WebExtractCompetitorsResponse::Competitor
+          ]
+        )
+      end
+      attr_accessor :competitors
+
+      # Normalized input domain.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Status of the response.
+      sig do
+        returns(
+          ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol
+        )
+      end
+      attr_accessor :status
+
+      # Target company profile inferred from the landing page.
+      sig { returns(ContextDev::Models::WebExtractCompetitorsResponse::Target) }
+      attr_reader :target
+
+      sig do
+        params(
+          target:
+            ContextDev::Models::WebExtractCompetitorsResponse::Target::OrHash
+        ).void
+      end
+      attr_writer :target
+
+      sig do
+        params(
+          competitors:
+            T::Array[
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::OrHash
+            ],
+          domain: String,
+          status:
+            ContextDev::Models::WebExtractCompetitorsResponse::Status::OrSymbol,
+          target:
+            ContextDev::Models::WebExtractCompetitorsResponse::Target::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Direct competitors ordered by relevance and confidence.
+        competitors:,
+        # Normalized input domain.
+        domain:,
+        # Status of the response.
+        status:,
+        # Target company profile inferred from the landing page.
+        target:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            competitors:
+              T::Array[
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor
+              ],
+            domain: String,
+            status:
+              ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol,
+            target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Confidence that this company is a direct competitor.
+        sig do
+          returns(
+            ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+          )
+        end
+        attr_accessor :confidence
+
+        # Short description of the competitor.
+        sig { returns(String) }
+        attr_accessor :description
+
+        # Competitor's normalized official domain.
+        sig { returns(String) }
+        attr_accessor :domain
+
+        # Competitor company or product name.
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Search result URLs used as evidence for this competitor.
+        sig { returns(T::Array[String]) }
+        attr_accessor :source_urls
+
+        # Competitor website URL.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            confidence:
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::OrSymbol,
+            description: String,
+            domain: String,
+            name: String,
+            source_urls: T::Array[String],
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Confidence that this company is a direct competitor.
+          confidence:,
+          # Short description of the competitor.
+          description:,
+          # Competitor's normalized official domain.
+          domain:,
+          # Competitor company or product name.
+          name:,
+          # Search result URLs used as evidence for this competitor.
+          source_urls:,
+          # Competitor website URL.
+          url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              confidence:
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol,
+              description: String,
+              domain: String,
+              name: String,
+              source_urls: T::Array[String],
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Confidence that this company is a direct competitor.
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HIGH =
+            T.let(
+              :high,
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+            )
+          MEDIUM =
+            T.let(
+              :medium,
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      # Status of the response.
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              ContextDev::Models::WebExtractCompetitorsResponse::Status
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        OK =
+          T.let(
+            :ok,
+            ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Target < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebExtractCompetitorsResponse::Target,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Company or product name inferred from the landing page.
+        sig { returns(String) }
+        attr_accessor :company_name
+
+        # Specific operating field, product category, or market.
+        sig { returns(String) }
+        attr_accessor :field
+
+        # One-sentence description of what the target company sells and who it serves.
+        sig { returns(String) }
+        attr_accessor :field_description
+
+        # Resolved URL used for the landing page analysis.
+        sig { returns(String) }
+        attr_accessor :website_url
+
+        # Target company profile inferred from the landing page.
+        sig do
+          params(
+            company_name: String,
+            field: String,
+            field_description: String,
+            website_url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Company or product name inferred from the landing page.
+          company_name:,
+          # Specific operating field, product category, or market.
+          field:,
+          # One-sentence description of what the target company sells and who it serves.
+          field_description:,
+          # Resolved URL used for the landing page analysis.
+          website_url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              company_name: String,
+              field: String,
+              field_description: String,
+              website_url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models/web_extract_params.rbi

@@ -22,12 +22,12 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
-      # When true (default), every returned value must be grounded in facts stated on
-      # the page; fields that cannot be supported by the page are returned as
-      # null/empty. When false, the model may make reasonable inferences and derivations
-      # from the page content (e.g. ideal customer, competitor analysis,
-      # recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-      # metrics) faithful to the source.
+      # When true, every returned value must be grounded in facts stated on the page;
+      # fields that cannot be supported by the page are returned as null/empty. When
+      # false (default), the model may make reasonable inferences and derivations from
+      # the page content (e.g. ideal customer, competitor analysis, recommendations)
+      # while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+      # faithful to the source.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :fact_check
 
@@ -57,7 +57,7 @@ module ContextDev
       attr_writer :instructions
 
       # Return cached scrape results if a prior scrape for the same parameters is
-      # younger than this many milliseconds.
+      # younger than this many milliseconds. Defaults to 7 days (604800000 ms).
       sig { returns(T.nilable(Integer)) }
       attr_reader :max_age_ms
 
@@ -118,12 +118,12 @@ module ContextDev
         # The starting website URL to crawl and extract from. Must include http:// or
         # https://.
         url:,
-        # When true (default), every returned value must be grounded in facts stated on
-        # the page; fields that cannot be supported by the page are returned as
-        # null/empty. When false, the model may make reasonable inferences and derivations
-        # from the page content (e.g. ideal customer, competitor analysis,
-        # recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-        # metrics) faithful to the source.
+        # When true, every returned value must be grounded in facts stated on the page;
+        # fields that cannot be supported by the page are returned as null/empty. When
+        # false (default), the model may make reasonable inferences and derivations from
+        # the page content (e.g. ideal customer, competitor analysis, recommendations)
+        # while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+        # faithful to the source.
         fact_check: nil,
         # When true, follow links on subdomains of the starting URL's domain.
         follow_subdomains: nil,
@@ -133,7 +133,7 @@ module ContextDev
         # interpret fields in the schema.
         instructions: nil,
         # Return cached scrape results if a prior scrape for the same parameters is
-        # younger than this many milliseconds.
+        # younger than this many milliseconds. Defaults to 7 days (604800000 ms).
         max_age_ms: nil,
         pdf: nil,
         # Soft time budget for the crawl in milliseconds.

data/rbi/context_dev/models.rbi

@@ -32,6 +32,8 @@ module ContextDev
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   WebExtractParams = ContextDev::Models::WebExtractParams

data/rbi/context_dev/resources/web.rbi

@@ -3,10 +3,8 @@
 module ContextDev
   module Resources
     class Web
-      # Crawl a website, convert pages to Markdown using the scrape cache, and extract
-      # structured data into the provided JSON Schema. The schema must describe the
-      # response data object. This endpoint does not accept targeted page-type
-      # selection.
+      # Crawl a website, use the provided JSON Schema and instructions to prioritize
+      # relevant internal links, and extract structured data from the selected pages.
       sig do
         params(
           schema: T::Hash[Symbol, T.anything],
@@ -31,12 +29,12 @@ module ContextDev
         # The starting website URL to crawl and extract from. Must include http:// or
         # https://.
         url:,
-        # When true (default), every returned value must be grounded in facts stated on
-        # the page; fields that cannot be supported by the page are returned as
-        # null/empty. When false, the model may make reasonable inferences and derivations
-        # from the page content (e.g. ideal customer, competitor analysis,
-        # recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-        # metrics) faithful to the source.
+        # When true, every returned value must be grounded in facts stated on the page;
+        # fields that cannot be supported by the page are returned as null/empty. When
+        # false (default), the model may make reasonable inferences and derivations from
+        # the page content (e.g. ideal customer, competitor analysis, recommendations)
+        # while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+        # faithful to the source.
         fact_check: nil,
         # When true, follow links on subdomains of the starting URL's domain.
         follow_subdomains: nil,
@@ -46,7 +44,7 @@ module ContextDev
         # interpret fields in the schema.
         instructions: nil,
         # Return cached scrape results if a prior scrape for the same parameters is
-        # younger than this many milliseconds.
+        # younger than this many milliseconds. Defaults to 7 days (604800000 ms).
         max_age_ms: nil,
         pdf: nil,
         # Soft time budget for the crawl in milliseconds.
@@ -62,6 +60,30 @@ module ContextDev
       )
       end
 
+      # Analyze a company's landing page and web search evidence to return direct
+      # competitors for the same product or market.
+      sig do
+        params(
+          domain: String,
+          num_competitors: Integer,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebExtractCompetitorsResponse)
+      end
+      def extract_competitors(
+        # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+        # and normalized to their domain.
+        domain:,
+        # Exact number of direct competitors to return. Defaults to 5.
+        num_competitors: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
       # Scrape font information from a website including font families, usage
       # statistics, fallbacks, and element/word counts.
       sig do

data/sig/context_dev/models/web_extract_competitors_params.rbs

@@ -0,0 +1,36 @@
+module ContextDev
+  module Models
+    type web_extract_competitors_params =
+      { domain: String, num_competitors: Integer, timeout_ms: Integer }
+      & ContextDev::Internal::Type::request_parameters
+
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      attr_accessor domain: String
+
+      attr_reader num_competitors: Integer?
+
+      def num_competitors=: (Integer) -> Integer
+
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      def initialize: (
+        domain: String,
+        ?num_competitors: Integer,
+        ?timeout_ms: Integer,
+        ?request_options: ContextDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        domain: String,
+        num_competitors: Integer,
+        timeout_ms: Integer,
+        request_options: ContextDev::RequestOptions
+      }
+    end
+  end
+end

data/sig/context_dev/models/web_extract_competitors_response.rbs

@@ -0,0 +1,130 @@
+module ContextDev
+  module Models
+    type web_extract_competitors_response =
+      {
+        competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor],
+        domain: String,
+        status: ContextDev::Models::WebExtractCompetitorsResponse::status,
+        target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+      }
+
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      attr_accessor competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor]
+
+      attr_accessor domain: String
+
+      attr_accessor status: ContextDev::Models::WebExtractCompetitorsResponse::status
+
+      attr_accessor target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+
+      def initialize: (
+        competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor],
+        domain: String,
+        status: ContextDev::Models::WebExtractCompetitorsResponse::status,
+        target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+      ) -> void
+
+      def to_hash: -> {
+        competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor],
+        domain: String,
+        status: ContextDev::Models::WebExtractCompetitorsResponse::status,
+        target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+      }
+
+      type competitor =
+        {
+          confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence,
+          description: String,
+          domain: String,
+          name: String,
+          source_urls: ::Array[String],
+          url: String
+        }
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        attr_accessor confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence
+
+        attr_accessor description: String
+
+        attr_accessor domain: String
+
+        attr_accessor name: String
+
+        attr_accessor source_urls: ::Array[String]
+
+        attr_accessor url: String
+
+        def initialize: (
+          confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence,
+          description: String,
+          domain: String,
+          name: String,
+          source_urls: ::Array[String],
+          url: String
+        ) -> void
+
+        def to_hash: -> {
+          confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence,
+          description: String,
+          domain: String,
+          name: String,
+          source_urls: ::Array[String],
+          url: String
+        }
+
+        type confidence = :high | :medium
+
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH: :high
+          MEDIUM: :medium
+
+          def self?.values: -> ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence]
+        end
+      end
+
+      type status = :ok
+
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        OK: :ok
+
+        def self?.values: -> ::Array[ContextDev::Models::WebExtractCompetitorsResponse::status]
+      end
+
+      type target =
+        {
+          company_name: String,
+          field: String,
+          field_description: String,
+          website_url: String
+        }
+
+      class Target < ContextDev::Internal::Type::BaseModel
+        attr_accessor company_name: String
+
+        attr_accessor field: String
+
+        attr_accessor field_description: String
+
+        attr_accessor website_url: String
+
+        def initialize: (
+          company_name: String,
+          field: String,
+          field_description: String,
+          website_url: String
+        ) -> void
+
+        def to_hash: -> {
+          company_name: String,
+          field: String,
+          field_description: String,
+          website_url: String
+        }
+      end
+    end
+  end
+end

data/sig/context_dev/models.rbs

@@ -27,6 +27,8 @@ module ContextDev
 
   class UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  class WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   class WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   class WebExtractParams = ContextDev::Models::WebExtractParams

data/sig/context_dev/resources/web.rbs

@@ -16,6 +16,13 @@ module ContextDev
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebExtractResponse
 
+      def extract_competitors: (
+        domain: String,
+        ?num_competitors: Integer,
+        ?timeout_ms: Integer,
+        ?request_options: ContextDev::request_opts
+      ) -> ContextDev::Models::WebExtractCompetitorsResponse
+
       def extract_fonts: (
         ?direct_url: String,
         ?domain: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.27.0
 platform: ruby
 authors:
 - Context Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-31 00:00:00.000000000 Z
+date: 2026-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -97,6 +97,8 @@ files:
 - lib/context_dev/models/utility_prefetch_by_email_response.rb
 - lib/context_dev/models/utility_prefetch_params.rb
 - lib/context_dev/models/utility_prefetch_response.rb
+- lib/context_dev/models/web_extract_competitors_params.rb
+- lib/context_dev/models/web_extract_competitors_response.rb
 - lib/context_dev/models/web_extract_fonts_params.rb
 - lib/context_dev/models/web_extract_fonts_response.rb
 - lib/context_dev/models/web_extract_params.rb
@@ -172,6 +174,8 @@ files:
 - rbi/context_dev/models/utility_prefetch_by_email_response.rbi
 - rbi/context_dev/models/utility_prefetch_params.rbi
 - rbi/context_dev/models/utility_prefetch_response.rbi
+- rbi/context_dev/models/web_extract_competitors_params.rbi
+- rbi/context_dev/models/web_extract_competitors_response.rbi
 - rbi/context_dev/models/web_extract_fonts_params.rbi
 - rbi/context_dev/models/web_extract_fonts_response.rbi
 - rbi/context_dev/models/web_extract_params.rbi
@@ -246,6 +250,8 @@ files:
 - sig/context_dev/models/utility_prefetch_by_email_response.rbs
 - sig/context_dev/models/utility_prefetch_params.rbs
 - sig/context_dev/models/utility_prefetch_response.rbs
+- sig/context_dev/models/web_extract_competitors_params.rbs
+- sig/context_dev/models/web_extract_competitors_response.rbs
 - sig/context_dev/models/web_extract_fonts_params.rbs
 - sig/context_dev/models/web_extract_fonts_response.rbs
 - sig/context_dev/models/web_extract_params.rbs