context.dev 1.4.0 → 1.6.0

data/lib/context_dev/resources/brand.rb

@@ -83,9 +83,8 @@ module ContextDev
       # {ContextDev::Models::BrandRetrieveByEmailParams} for more details.
       #
       # Retrieve brand information using an email address while detecting disposable and
-      # free email addresses. This endpoint extracts the domain from the email address
-      # and returns brand data for that domain. Disposable and free email addresses
-      # (like gmail.com, yahoo.com) will throw a 422 error.
+      # free email addresses. Disposable and free email addresses (like gmail.com,
+      # yahoo.com) will throw a 422 error.
       #
       # @overload retrieve_by_email(email:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
@@ -118,8 +117,7 @@ module ContextDev
       # {ContextDev::Models::BrandRetrieveByIsinParams} for more details.
       #
       # Retrieve brand information using an ISIN (International Securities
-      # Identification Number). This endpoint looks up the company associated with the
-      # ISIN and returns its brand data.
+      # Identification Number).
       #
       # @overload retrieve_by_isin(isin:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
@@ -151,14 +149,13 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::BrandRetrieveByNameParams} for more details.
       #
-      # Retrieve brand information using a company name. This endpoint searches for the
-      # company by name and returns its brand data.
+      # Retrieve brand information using a company name.
       #
       # @overload retrieve_by_name(name:, country_gl: nil, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
       # @param name [String] Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft Corporati
       #
-      # @param country_gl [Symbol, ContextDev::Models::BrandRetrieveByNameParams::CountryGl] Optional country code (GL parameter) to specify the country. This affects the ge
+      # @param country_gl [Symbol, ContextDev::Models::BrandRetrieveByNameParams::CountryGl] Optional country code hint (GL parameter) to specify the country for the company
       #
       # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByNameParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
@@ -186,8 +183,7 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::BrandRetrieveByTickerParams} for more details.
       #
-      # Retrieve brand information using a stock ticker symbol. This endpoint looks up
-      # the company associated with the ticker and returns its brand data.
+      # Retrieve brand information using a stock ticker symbol.
       #
       # @overload retrieve_by_ticker(ticker:, force_language: nil, max_speed: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
       #
@@ -222,8 +218,8 @@ module ContextDev
       # {ContextDev::Models::BrandRetrieveSimplifiedParams} for more details.
       #
       # Returns a simplified version of brand data containing only essential
-      # information: domain, title, colors, logos, and backdrops. This endpoint is
-      # optimized for faster responses and reduced data transfer.
+      # information: domain, title, colors, logos, and backdrops. Optimized for faster
+      # responses and reduced data transfer.
       #
       # @overload retrieve_simplified(domain:, timeout_ms: nil, request_options: {})
       #

data/lib/context_dev/resources/industry.rb

@@ -6,11 +6,11 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::IndustryRetrieveNaicsParams} for more details.
       #
-      # Endpoint to classify any brand into a 2022 NAICS code.
+      # Classify any brand into 2022 NAICS industry codes from its domain or name.
       #
       # @overload retrieve_naics(input:, max_results: nil, min_results: nil, timeout_ms: nil, request_options: {})
       #
-      # @param input [String] Brand domain or title to retrieve NAICS code for. If a valid domain is provided
+      # @param input [String] Brand domain or title to retrieve NAICS code for. If a valid domain is provided,
       #
       # @param max_results [Integer] Maximum number of NAICS codes to return. Must be between 1 and 10. Defaults to 5
       #
@@ -28,7 +28,7 @@ module ContextDev
         query = ContextDev::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
-          path: "brand/naics",
+          path: "web/naics",
           query: query.transform_keys(
             max_results: "maxResults",
             min_results: "minResults",

data/lib/context_dev/resources/web.rb

@@ -3,14 +3,72 @@
 module ContextDev
   module Resources
     class Web
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebExtractFontsParams} for more details.
+      #
+      # Scrape font information from a website including font families, usage
+      # statistics, fallbacks, and element/word counts.
+      #
+      # @overload extract_fonts(direct_url: nil, domain: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param direct_url [String] A specific URL to fetch fonts from directly, bypassing domain resolution (e.g.,
+      #
+      # @param domain [String] Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domai
+      #
+      # @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::WebExtractFontsResponse]
+      #
+      # @see ContextDev::Models::WebExtractFontsParams
+      def extract_fonts(params = {})
+        parsed, options = ContextDev::WebExtractFontsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/fonts",
+          query: query.transform_keys(direct_url: "directUrl", timeout_ms: "timeoutMS"),
+          model: ContextDev::Models::WebExtractFontsResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebExtractStyleguideParams} for more details.
+      #
+      # Extract a comprehensive design system from a website including colors,
+      # typography, spacing, shadows, and UI components.
+      #
+      # @overload extract_styleguide(direct_url: nil, domain: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param direct_url [String] A specific URL to fetch the styleguide from directly, bypassing domain resolutio
+      #
+      # @param domain [String] Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
+      #
+      # @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::WebExtractStyleguideResponse]
+      #
+      # @see ContextDev::Models::WebExtractStyleguideParams
+      def extract_styleguide(params = {})
+        parsed, options = ContextDev::WebExtractStyleguideParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/styleguide",
+          query: query.transform_keys(direct_url: "directUrl", timeout_ms: "timeoutMS"),
+          model: ContextDev::Models::WebExtractStyleguideResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebScreenshotParams} for more details.
       #
-      # Capture a screenshot of a website. Supports both viewport (standard browser
-      # view) and full-page screenshots. Can also screenshot specific page types (login,
-      # pricing, etc.) by using heuristics to find the appropriate URL. Either 'domain'
-      # or 'directUrl' must be provided as a query parameter, but not both. Returns a
-      # URL to the uploaded screenshot image hosted on our CDN.
+      # Capture a screenshot of a website.
       #
       # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
       #
@@ -34,7 +92,7 @@ module ContextDev
         query = ContextDev::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
-          path: "brand/screenshot",
+          path: "web/screenshot",
           query: query.transform_keys(direct_url: "directUrl", full_screenshot: "fullScreenshot"),
           model: ContextDev::Models::WebScreenshotResponse,
           options: options
@@ -45,10 +103,9 @@ module ContextDev
       # {ContextDev::Models::WebWebCrawlMdParams} for more details.
       #
       # Performs a crawl starting from a given URL, extracts page content as Markdown,
-      # and returns results for all crawled pages. Only follows links within the same
-      # domain as the starting URL. Costs 1 credit per successful page crawled.
+      # and returns results for all crawled pages.
       #
-      # @overload web_crawl_md(url:, follow_subdomains: nil, include_images: nil, include_links: nil, max_depth: nil, max_pages: nil, shorten_base64_images: nil, url_regex: nil, use_main_content_only: nil, request_options: {})
+      # @overload web_crawl_md(url:, follow_subdomains: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, shorten_base64_images: nil, url_regex: nil, use_main_content_only: nil, request_options: {})
       #
       # @param url [String] The starting URL for the crawl (must include http:// or https:// protocol)
       #
@@ -58,6 +115,8 @@ module ContextDev
       #
       # @param include_links [Boolean] Preserve hyperlinks in the Markdown output
       #
+      # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       # @param max_depth [Integer] Maximum link depth from the starting URL (0 = only the starting page)
       #
       # @param max_pages [Integer] Maximum number of pages to crawl. Hard cap: 500.
@@ -84,12 +143,17 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebWebScrapeHTMLParams} for more details.
+      #
       # Scrapes the given URL and returns the raw HTML content of the page.
       #
-      # @overload web_scrape_html(url:, request_options: {})
+      # @overload web_scrape_html(url:, max_age_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
+      # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebScrapeHTMLResponse]
@@ -101,7 +165,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/scrape/html",
-          query: query,
+          query: query.transform_keys(max_age_ms: "maxAgeMs"),
           model: ContextDev::Models::WebWebScrapeHTMLResponse,
           options: options
         )
@@ -135,17 +199,18 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
-      # Scrapes the given URL, converts the HTML content to Markdown, and returns the
-      # result.
+      # Scrapes the given URL into LLM usable Markdown.
       #
-      # @overload web_scrape_md(url:, include_images: nil, include_links: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
+      # @overload web_scrape_md(url:, include_images: nil, include_links: nil, max_age_ms: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
       #
-      # @param url [String] Full URL to scrape and convert to markdown (must include http:// or https:// pro
+      # @param url [String] Full URL to scrape into LLM usable Markdown (must include http:// or https:// pr
       #
       # @param include_images [Boolean] Include image references in Markdown output
       #
       # @param include_links [Boolean] Preserve hyperlinks in Markdown output
       #
+      # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
+      #
       # @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
       #
       # @param use_main_content_only [Boolean] Extract only the main content of the page, excluding headers, footers, sidebars,
@@ -164,6 +229,7 @@ module ContextDev
           query: query.transform_keys(
             include_images: "includeImages",
             include_links: "includeLinks",
+            max_age_ms: "maxAgeMs",
             shorten_base64_images: "shortenBase64Images",
             use_main_content_only: "useMainContentOnly"
           ),
@@ -175,16 +241,16 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebWebScrapeSitemapParams} for more details.
       #
-      # Crawls the sitemap of the given domain and returns all discovered page URLs.
-      # Supports sitemap index files (recursive), parallel fetching with concurrency
-      # control, deduplication, and filters out non-page resources (images, PDFs, etc.).
+      # Crawl an entire website's sitemap and return all discovered page URLs.
       #
-      # @overload web_scrape_sitemap(domain:, max_links: nil, request_options: {})
+      # @overload web_scrape_sitemap(domain:, max_links: nil, url_regex: nil, request_options: {})
       #
-      # @param domain [String] Domain name to crawl sitemaps for (e.g., 'example.com'). The domain will be auto
+      # @param domain [String] Domain to build a sitemap for
       #
       # @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
+      # @param url_regex [String] Optional RE2-compatible regex pattern. Only URLs matching this pattern are retur
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebWebScrapeSitemapResponse]
@@ -196,7 +262,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/scrape/sitemap",
-          query: query.transform_keys(max_links: "maxLinks"),
+          query: query.transform_keys(max_links: "maxLinks", url_regex: "urlRegex"),
           model: ContextDev::Models::WebWebScrapeSitemapResponse,
           options: options
         )

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -74,14 +74,14 @@ require_relative "context_dev/models/brand_retrieve_simplified_params"
 require_relative "context_dev/models/brand_retrieve_simplified_response"
 require_relative "context_dev/models/industry_retrieve_naics_params"
 require_relative "context_dev/models/industry_retrieve_naics_response"
-require_relative "context_dev/models/style_extract_fonts_params"
-require_relative "context_dev/models/style_extract_fonts_response"
-require_relative "context_dev/models/style_extract_styleguide_params"
-require_relative "context_dev/models/style_extract_styleguide_response"
 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_fonts_params"
+require_relative "context_dev/models/web_extract_fonts_response"
+require_relative "context_dev/models/web_extract_styleguide_params"
+require_relative "context_dev/models/web_extract_styleguide_response"
 require_relative "context_dev/models/web_screenshot_params"
 require_relative "context_dev/models/web_screenshot_response"
 require_relative "context_dev/models/web_web_crawl_md_params"
@@ -98,6 +98,5 @@ require_relative "context_dev/models"
 require_relative "context_dev/resources/ai"
 require_relative "context_dev/resources/brand"
 require_relative "context_dev/resources/industry"
-require_relative "context_dev/resources/style"
 require_relative "context_dev/resources/utility"
 require_relative "context_dev/resources/web"

data/rbi/context_dev/client.rbi

@@ -19,9 +19,6 @@ module ContextDev
     sig { returns(ContextDev::Resources::AI) }
     attr_reader :ai
 
-    sig { returns(ContextDev::Resources::Style) }
-    attr_reader :style
-
     sig { returns(ContextDev::Resources::Brand) }
     attr_reader :brand
 

data/rbi/context_dev/models/brand_identify_from_transaction_params.rbi

@@ -64,7 +64,6 @@ module ContextDev
 
       # When set to true, the API will perform an additional verification steps to
       # ensure the identified brand matches the transaction with high confidence.
-      # Defaults to false.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :high_confidence_only
 
@@ -132,7 +131,6 @@ module ContextDev
         force_language: nil,
         # When set to true, the API will perform an additional verification steps to
         # ensure the identified brand matches the transaction with high confidence.
-        # Defaults to false.
         high_confidence_only: nil,
         # Optional parameter to optimize the API call for maximum speed. When set to true,
         # the API will skip time-consuming operations for faster response at the cost of

data/rbi/context_dev/models/brand_retrieve_by_name_params.rbi

@@ -19,8 +19,8 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :name
 
-      # Optional country code (GL parameter) to specify the country. This affects the
-      # geographic location used for search queries.
+      # Optional country code hint (GL parameter) to specify the country for the company
+      # name.
       sig do
         returns(
           T.nilable(ContextDev::BrandRetrieveByNameParams::CountryGl::OrSymbol)
@@ -87,8 +87,8 @@ module ContextDev
         # Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
         # Corporation'). Must be 3-30 characters.
         name:,
-        # Optional country code (GL parameter) to specify the country. This affects the
-        # geographic location used for search queries.
+        # Optional country code hint (GL parameter) to specify the country for the company
+        # name.
         country_gl: nil,
         # Optional parameter to force the language of the retrieved brand data.
         force_language: nil,
@@ -121,8 +121,8 @@ module ContextDev
       def to_hash
       end
 
-      # Optional country code (GL parameter) to specify the country. This affects the
-      # geographic location used for search queries.
+      # Optional country code hint (GL parameter) to specify the country for the company
+      # name.
       module CountryGl
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/models/industry_retrieve_naics_params.rbi

@@ -14,9 +14,9 @@ module ContextDev
           )
         end
 
-      # Brand domain or title to retrieve NAICS code for. If a valid domain is provided
-      # in `input`, it will be used for classification, otherwise, we will search for
-      # the brand using the provided title.
+      # Brand domain or title to retrieve NAICS code for. If a valid domain is provided,
+      # it will be used for classification, otherwise, we will search for the brand
+      # using the provided title.
       sig { returns(String) }
       attr_accessor :input
 
@@ -54,9 +54,9 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
-        # Brand domain or title to retrieve NAICS code for. If a valid domain is provided
-        # in `input`, it will be used for classification, otherwise, we will search for
-        # the brand using the provided title.
+        # Brand domain or title to retrieve NAICS code for. If a valid domain is provided,
+        # it will be used for classification, otherwise, we will search for the brand
+        # using the provided title.
         input:,
         # Maximum number of NAICS codes to return. Must be between 1 and 10. Defaults
         # to 5.

data/rbi/context_dev/models/{style_extract_fonts_params.rbi → web_extract_fonts_params.rbi}

@@ -2,22 +2,35 @@
 
 module ContextDev
   module Models
-    class StyleExtractFontsParams < ContextDev::Internal::Type::BaseModel
+    class WebExtractFontsParams < ContextDev::Internal::Type::BaseModel
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
       OrHash =
         T.type_alias do
           T.any(
-            ContextDev::StyleExtractFontsParams,
+            ContextDev::WebExtractFontsParams,
             ContextDev::Internal::AnyHash
           )
         end
 
+      # A specific URL to fetch fonts from directly, bypassing domain resolution (e.g.,
+      # 'https://example.com/design-system'). When provided, fonts are extracted from
+      # this exact URL. You must provide either 'domain' or 'directUrl', but not both.
+      sig { returns(T.nilable(String)) }
+      attr_reader :direct_url
+
+      sig { params(direct_url: String).void }
+      attr_writer :direct_url
+
       # Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
-      # domain will be automatically normalized and validated.
-      sig { returns(String) }
-      attr_accessor :domain
+      # domain will be automatically normalized and validated. You must provide either
+      # 'domain' or 'directUrl', but not both.
+      sig { returns(T.nilable(String)) }
+      attr_reader :domain
+
+      sig { params(domain: String).void }
+      attr_writer :domain
 
       # 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
@@ -30,15 +43,21 @@ module ContextDev
 
       sig do
         params(
+          direct_url: String,
           domain: String,
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # A specific URL to fetch fonts from directly, bypassing domain resolution (e.g.,
+        # 'https://example.com/design-system'). When provided, fonts are extracted from
+        # this exact URL. You must provide either 'domain' or 'directUrl', but not both.
+        direct_url: nil,
         # Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
-        # domain will be automatically normalized and validated.
-        domain:,
+        # domain will be automatically normalized and validated. You must provide either
+        # 'domain' or 'directUrl', but not both.
+        domain: 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).
@@ -50,6 +69,7 @@ module ContextDev
       sig do
         override.returns(
           {
+            direct_url: String,
             domain: String,
             timeout_ms: Integer,
             request_options: ContextDev::RequestOptions