Merge pull request #44 from brand-dot-dev/release-please--branches--main--changes--next--components--brand.dev

YahiaBakour · web-flow · commit 1d97bc74c59d · 2026-02-23T11:25:06.000-05:00
release: 0.27.0
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.26.0"
+  ".": "0.27.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 16
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-98ef96cef5b06ad7a29dadba48258da7d9ea0a2b3938dc9e714ae06eb9afa1a3.yml
-openapi_spec_hash: 9e957a30999dff7d4ada925e437bd202
-config_hash: c3aaaa9794dba44d524c06591ab17894
+configured_endpoints: 20
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-2cdd67823c6ac9d1ab68032a695c31a098ad285ffb0c073b9dfc00afe5de9b88.yml
+openapi_spec_hash: ac8a965beb9b667b6204a5c573507219
+config_hash: 4cd3173ea1cce7183640aae49cfbb374
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.27.0 (2026-02-23)
+
+Full Changelog: [v0.26.0...v0.27.0](https://github.com/brand-dot-dev/typescript-sdk/compare/v0.26.0...v0.27.0)
+
+### Features
+
+* **api:** manual updates ([f0fcc0f](https://github.com/brand-dot-dev/typescript-sdk/commit/f0fcc0f44172a69581295384f9ffcc9a2da8fc57))
+
 ## 0.26.0 (2026-02-22)
 
 Full Changelog: [v0.25.0...v0.26.0](https://github.com/brand-dot-dev/typescript-sdk/compare/v0.25.0...v0.26.0)
diff --git a/api.md b/api.md
@@ -18,6 +18,10 @@ Types:
 - <code><a href="./src/resources/brand.ts">BrandRetrieveSimplifiedResponse</a></code>
 - <code><a href="./src/resources/brand.ts">BrandScreenshotResponse</a></code>
 - <code><a href="./src/resources/brand.ts">BrandStyleguideResponse</a></code>
+- <code><a href="./src/resources/brand.ts">BrandWebScrapeHTMLResponse</a></code>
+- <code><a href="./src/resources/brand.ts">BrandWebScrapeImagesResponse</a></code>
+- <code><a href="./src/resources/brand.ts">BrandWebScrapeMdResponse</a></code>
+- <code><a href="./src/resources/brand.ts">BrandWebScrapeSitemapResponse</a></code>
 
 Methods:
 
@@ -37,3 +41,7 @@ Methods:
 - <code title="get /brand/retrieve-simplified">client.brand.<a href="./src/resources/brand.ts">retrieveSimplified</a>({ ...params }) -> BrandRetrieveSimplifiedResponse</code>
 - <code title="get /brand/screenshot">client.brand.<a href="./src/resources/brand.ts">screenshot</a>({ ...params }) -> BrandScreenshotResponse</code>
 - <code title="get /brand/styleguide">client.brand.<a href="./src/resources/brand.ts">styleguide</a>({ ...params }) -> BrandStyleguideResponse</code>
+- <code title="get /web/scrape/html">client.brand.<a href="./src/resources/brand.ts">webScrapeHTML</a>({ ...params }) -> BrandWebScrapeHTMLResponse</code>
+- <code title="get /web/scrape/images">client.brand.<a href="./src/resources/brand.ts">webScrapeImages</a>({ ...params }) -> BrandWebScrapeImagesResponse</code>
+- <code title="get /web/scrape/markdown">client.brand.<a href="./src/resources/brand.ts">webScrapeMd</a>({ ...params }) -> BrandWebScrapeMdResponse</code>
+- <code title="get /web/scrape/sitemap">client.brand.<a href="./src/resources/brand.ts">webScrapeSitemap</a>({ ...params }) -> BrandWebScrapeSitemapResponse</code>
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "brand.dev",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "The official TypeScript library for the Brand Dev API",
   "author": "Brand Dev <hello@brand.dev>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/manifest.json b/packages/mcp-server/manifest.json
@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "brand.dev-mcp",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "The official MCP Server for the Brand Dev API",
   "author": {
     "name": "Brand Dev",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "brand.dev-mcp",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "The official MCP Server for the Brand Dev API",
   "author": "Brand Dev <hello@brand.dev>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/src/methods.ts b/packages/mcp-server/src/methods.ts
@@ -106,6 +106,30 @@ export const sdkMethods: SdkMethod[] = [
     httpMethod: 'get',
     httpPath: '/brand/styleguide',
   },
+  {
+    clientCallName: 'client.brand.webScrapeHTML',
+    fullyQualifiedName: 'brand.webScrapeHTML',
+    httpMethod: 'get',
+    httpPath: '/web/scrape/html',
+  },
+  {
+    clientCallName: 'client.brand.webScrapeImages',
+    fullyQualifiedName: 'brand.webScrapeImages',
+    httpMethod: 'get',
+    httpPath: '/web/scrape/images',
+  },
+  {
+    clientCallName: 'client.brand.webScrapeMd',
+    fullyQualifiedName: 'brand.webScrapeMd',
+    httpMethod: 'get',
+    httpPath: '/web/scrape/markdown',
+  },
+  {
+    clientCallName: 'client.brand.webScrapeSitemap',
+    fullyQualifiedName: 'brand.webScrapeSitemap',
+    httpMethod: 'get',
+    httpPath: '/web/scrape/sitemap',
+  },
 ];
 
 function allowedMethodsForCodeTool(options: McpOptions | undefined): SdkMethod[] | undefined {
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
@@ -20,7 +20,7 @@ export const newMcpServer = async (stainlessApiKey: string | undefined) =>
   new McpServer(
     {
       name: 'brand_dev_api',
-      version: '0.26.0',
+      version: '0.27.0',
     },
     {
       instructions: await getInstructions(stainlessApiKey),
diff --git a/src/client.ts b/src/client.ts
@@ -50,6 +50,14 @@ import {
   BrandScreenshotResponse,
   BrandStyleguideParams,
   BrandStyleguideResponse,
+  BrandWebScrapeHTMLParams,
+  BrandWebScrapeHTMLResponse,
+  BrandWebScrapeImagesParams,
+  BrandWebScrapeImagesResponse,
+  BrandWebScrapeMdParams,
+  BrandWebScrapeMdResponse,
+  BrandWebScrapeSitemapParams,
+  BrandWebScrapeSitemapResponse,
 } from './resources/brand';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -789,6 +797,10 @@ export declare namespace BrandDev {
     type BrandRetrieveSimplifiedResponse as BrandRetrieveSimplifiedResponse,
     type BrandScreenshotResponse as BrandScreenshotResponse,
     type BrandStyleguideResponse as BrandStyleguideResponse,
+    type BrandWebScrapeHTMLResponse as BrandWebScrapeHTMLResponse,
+    type BrandWebScrapeImagesResponse as BrandWebScrapeImagesResponse,
+    type BrandWebScrapeMdResponse as BrandWebScrapeMdResponse,
+    type BrandWebScrapeSitemapResponse as BrandWebScrapeSitemapResponse,
     type BrandRetrieveParams as BrandRetrieveParams,
     type BrandAIProductParams as BrandAIProductParams,
     type BrandAIProductsParams as BrandAIProductsParams,
@@ -805,5 +817,9 @@ export declare namespace BrandDev {
     type BrandRetrieveSimplifiedParams as BrandRetrieveSimplifiedParams,
     type BrandScreenshotParams as BrandScreenshotParams,
     type BrandStyleguideParams as BrandStyleguideParams,
+    type BrandWebScrapeHTMLParams as BrandWebScrapeHTMLParams,
+    type BrandWebScrapeImagesParams as BrandWebScrapeImagesParams,
+    type BrandWebScrapeMdParams as BrandWebScrapeMdParams,
+    type BrandWebScrapeSitemapParams as BrandWebScrapeSitemapParams,
   };
 }
diff --git a/src/resources/brand.ts b/src/resources/brand.ts
@@ -170,6 +170,50 @@ export class Brand extends APIResource {
   styleguide(query: BrandStyleguideParams, options?: RequestOptions): APIPromise<BrandStyleguideResponse> {
     return this._client.get('/brand/styleguide', { query, ...options });
   }
+
+  /**
+   * Scrapes the given URL and returns the raw HTML content of the page. Uses
+   * automatic proxy escalation to handle blocked sites.
+   */
+  webScrapeHTML(
+    query: BrandWebScrapeHTMLParams,
+    options?: RequestOptions,
+  ): APIPromise<BrandWebScrapeHTMLResponse> {
+    return this._client.get('/web/scrape/html', { query, ...options });
+  }
+
+  /**
+   * Scrapes all images from the given URL. Extracts images from img, svg,
+   * picture/source, link, and video elements including inline SVGs, base64 data
+   * URIs, and standard URLs.
+   */
+  webScrapeImages(
+    query: BrandWebScrapeImagesParams,
+    options?: RequestOptions,
+  ): APIPromise<BrandWebScrapeImagesResponse> {
+    return this._client.get('/web/scrape/images', { query, ...options });
+  }
+
+  /**
+   * Scrapes the given URL, converts the HTML content to GitHub Flavored Markdown
+   * (GFM), and returns the result. Uses automatic proxy escalation to handle blocked
+   * sites.
+   */
+  webScrapeMd(query: BrandWebScrapeMdParams, options?: RequestOptions): APIPromise<BrandWebScrapeMdResponse> {
+    return this._client.get('/web/scrape/markdown', { query, ...options });
+  }
+
+  /**
+   * 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.).
+   */
+  webScrapeSitemap(
+    query: BrandWebScrapeSitemapParams,
+    options?: RequestOptions,
+  ): APIPromise<BrandWebScrapeSitemapResponse> {
+    return this._client.get('/web/scrape/sitemap', { query, ...options });
+  }
 }
 
 export interface BrandRetrieveResponse {
@@ -4685,6 +4729,130 @@ export namespace BrandStyleguideResponse {
   }
 }
 
+export interface BrandWebScrapeHTMLResponse {
+  /**
+   * Raw HTML content of the page
+   */
+  html: string;
+
+  /**
+   * Indicates success
+   */
+  success: true;
+
+  /**
+   * The URL that was scraped
+   */
+  url: string;
+}
+
+export interface BrandWebScrapeImagesResponse {
+  /**
+   * Array of scraped images
+   */
+  images: Array<BrandWebScrapeImagesResponse.Image>;
+
+  /**
+   * Indicates success
+   */
+  success: true;
+
+  /**
+   * The URL that was scraped
+   */
+  url: string;
+}
+
+export namespace BrandWebScrapeImagesResponse {
+  export interface Image {
+    /**
+     * Alt text of the image, or null if not present
+     */
+    alt: string | null;
+
+    /**
+     * The HTML element the image was found in
+     */
+    element: 'img' | 'svg' | 'link' | 'source' | 'video';
+
+    /**
+     * The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+     */
+    src: string;
+
+    /**
+     * The type/format of the src value
+     */
+    type: 'url' | 'html' | 'base64';
+  }
+}
+
+export interface BrandWebScrapeMdResponse {
+  /**
+   * Page content converted to GitHub Flavored Markdown
+   */
+  markdown: string;
+
+  /**
+   * Indicates success
+   */
+  success: true;
+
+  /**
+   * The URL that was scraped
+   */
+  url: string;
+}
+
+export interface BrandWebScrapeSitemapResponse {
+  /**
+   * The normalized domain that was crawled
+   */
+  domain: string;
+
+  /**
+   * Metadata about the sitemap crawl operation
+   */
+  meta: BrandWebScrapeSitemapResponse.Meta;
+
+  /**
+   * Indicates success
+   */
+  success: true;
+
+  /**
+   * Array of discovered page URLs from the sitemap (max 500)
+   */
+  urls: Array<string>;
+}
+
+export namespace BrandWebScrapeSitemapResponse {
+  /**
+   * Metadata about the sitemap crawl operation
+   */
+  export interface Meta {
+    /**
+     * Number of errors encountered during crawling
+     */
+    errors: number;
+
+    /**
+     * Total number of sitemap files discovered
+     */
+    sitemapsDiscovered: number;
+
+    /**
+     * Number of sitemap files successfully fetched and parsed
+     */
+    sitemapsFetched: number;
+
+    /**
+     * Number of sitemap files skipped (due to errors, timeouts, or limits)
+     */
+    sitemapsSkipped: number;
+  }
+}
+
 export interface BrandRetrieveParams {
   /**
    * Domain name to retrieve brand data for (e.g., 'example.com', 'google.com').
@@ -5802,6 +5970,46 @@ export interface BrandStyleguideParams {
   timeoutMS?: number;
 }
 
+export interface BrandWebScrapeHTMLParams {
+  /**
+   * Full URL to scrape (must include http:// or https:// protocol)
+   */
+  url: string;
+}
+
+export interface BrandWebScrapeImagesParams {
+  /**
+   * Full URL to scrape images from (must include http:// or https:// protocol)
+   */
+  url: string;
+}
+
+export interface BrandWebScrapeMdParams {
+  /**
+   * Full URL to scrape and convert to markdown (must include http:// or https://
+   * protocol)
+   */
+  url: string;
+
+  /**
+   * Include image references in Markdown output
+   */
+  includeImages?: boolean;
+
+  /**
+   * Preserve hyperlinks in Markdown output
+   */
+  includeLinks?: boolean;
+}
+
+export interface BrandWebScrapeSitemapParams {
+  /**
+   * Domain name to crawl sitemaps for (e.g., 'example.com'). The domain will be
+   * automatically normalized and validated.
+   */
+  domain: string;
+}
+
 export declare namespace Brand {
   export {
     type BrandRetrieveResponse as BrandRetrieveResponse,
@@ -5820,6 +6028,10 @@ export declare namespace Brand {
     type BrandRetrieveSimplifiedResponse as BrandRetrieveSimplifiedResponse,
     type BrandScreenshotResponse as BrandScreenshotResponse,
     type BrandStyleguideResponse as BrandStyleguideResponse,
+    type BrandWebScrapeHTMLResponse as BrandWebScrapeHTMLResponse,
+    type BrandWebScrapeImagesResponse as BrandWebScrapeImagesResponse,
+    type BrandWebScrapeMdResponse as BrandWebScrapeMdResponse,
+    type BrandWebScrapeSitemapResponse as BrandWebScrapeSitemapResponse,
     type BrandRetrieveParams as BrandRetrieveParams,
     type BrandAIProductParams as BrandAIProductParams,
     type BrandAIProductsParams as BrandAIProductsParams,
@@ -5836,5 +6048,9 @@ export declare namespace Brand {
     type BrandRetrieveSimplifiedParams as BrandRetrieveSimplifiedParams,
     type BrandScreenshotParams as BrandScreenshotParams,
     type BrandStyleguideParams as BrandStyleguideParams,
+    type BrandWebScrapeHTMLParams as BrandWebScrapeHTMLParams,
+    type BrandWebScrapeImagesParams as BrandWebScrapeImagesParams,
+    type BrandWebScrapeMdParams as BrandWebScrapeMdParams,
+    type BrandWebScrapeSitemapParams as BrandWebScrapeSitemapParams,
   };
 }
diff --git a/src/resources/index.ts b/src/resources/index.ts
diff --git a/src/version.ts b/src/version.ts
diff --git a/tests/api-resources/brand.test.ts b/tests/api-resources/brand.test.ts

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.26.0"`
	`2`	`+ ".": "0.27.0"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "brand.dev",`
`3`		`- "version": "0.26.0",`
	`3`	`+ "version": "0.27.0",`
`4`	`4`	`"description": "The official TypeScript library for the Brand Dev API",`
`5`	`5`	`"author": "Brand Dev <hello@brand.dev>",`
`6`	`6`	`"types": "dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"dxt_version": "0.2",`
`3`	`3`	`"name": "brand.dev-mcp",`
`4`		`- "version": "0.26.0",`
	`4`	`+ "version": "0.27.0",`
`5`	`5`	`"description": "The official MCP Server for the Brand Dev API",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "Brand Dev",`
Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@ export const newMcpServer = async (stainlessApiKey: string \| undefined) =>`
`20`	`20`	`new McpServer(`
`21`	`21`	`{`
`22`	`22`	`name: 'brand_dev_api',`
`23`		`- version: '0.26.0',`
	`23`	`+ version: '0.27.0',`
`24`	`24`	`},`
`25`	`25`	`{`
`26`	`26`	`instructions: await getInstructions(stainlessApiKey),`