@mendable/firecrawl-js 4.46.0 → 4.48.0

package/dist/index.d.cts

@@ -765,10 +765,10 @@ interface FindToolsOptions {
     offset?: number;
 }
 interface FindToolsData {
-    level: "providers" | "groups" | "tools";
+    level: "categories" | "providers" | "groups" | "tools";
     items: Array<{
         id: string;
-        name: string;
+        name?: string;
         next?: AlexandriaCall;
         execute?: Pick<AlexandriaCall, "provider" | "capability">;
         [key: string]: unknown;
@@ -2019,6 +2019,7 @@ interface HttpClientOptions {
     timeoutMs?: number;
     maxRetries?: number;
     backoffFactor?: number;
+    origin?: string;
 }
 interface RequestOptions {
     headers?: Record<string, string>;
@@ -2030,9 +2031,12 @@ declare class HttpClient {
     private readonly apiUrl;
     private readonly maxRetries;
     private readonly backoffFactor;
+    private readonly origin;
     constructor(options: HttpClientOptions);
     getApiUrl(): string;
     getApiKey(): string;
+    /** The attribution origin stamped into requests that do not set their own. */
+    getOrigin(): string;
     /** The client-wide default request timeout, for callers that need to
      * extend a specific request beyond it (e.g. scrape auto-resume). */
     getTimeoutMs(): number;
@@ -2119,6 +2123,10 @@ declare function browser(http: HttpClient, args?: {
         name: string;
         saveChanges?: boolean;
     };
+    /** Country the session browses from, as an ISO 3166-1 alpha-2 code (default US). */
+    location?: {
+        country: string;
+    };
     integration?: string;
     origin?: string;
 }): Promise<BrowserCreateResponse>;
@@ -2261,6 +2269,12 @@ interface FirecrawlClientOptions {
     maxRetries?: number;
     /** Exponential backoff factor for retries (optional). */
     backoffFactor?: number;
+    /**
+     * Attribution tag stamped into request bodies. Defaults to `js-sdk@<version>`,
+     * or `js-sdk.<package>@<version>` when an installed package creates the client
+     * (set FIRECRAWL_DISABLE_CALLER_ORIGIN=1 to keep the plain default).
+     */
+    origin?: string;
 }
 /** Accepts a plain API key string or a full options object. */
 type FirecrawlClientInput = FirecrawlClientOptions | string;
@@ -2268,7 +2282,7 @@ type FirecrawlClientInput = FirecrawlClientOptions | string;
  * Firecrawl v2 client. Provides typed access to all v2 endpoints and utilities.
  */
 declare class FirecrawlClient {
-    private readonly http;
+    protected readonly http: HttpClient;
     private _research?;
     private isCloudService;
     /**
@@ -2585,7 +2599,7 @@ declare class FirecrawlClient {
     }): Promise<AgentThreadResponse>;
     /**
      * Create a new browser session.
-     * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile).
+     * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile, location).
      * @returns Session id, CDP URL, live view URL, and expiration time.
      */
     browser(args?: Parameters<typeof browser>[1]): Promise<BrowserCreateResponse>;
@@ -2658,10 +2672,12 @@ declare class FirecrawlClient {
  * Configuration interface for FirecrawlApp.
  * @param apiKey - Optional API key for authentication.
  * @param apiUrl - Optional base URL of the API; defaults to 'https://api.firecrawl.dev'.
+ * @param origin - Optional attribution tag stamped into request bodies.
  */
 interface FirecrawlAppConfig {
     apiKey?: string | null;
     apiUrl?: string | null;
+    origin?: string;
 }
 /**
  * Metadata for a Firecrawl document.
@@ -3258,6 +3274,8 @@ declare class FirecrawlApp {
     apiKey: string;
     apiUrl: string;
     version: string;
+    private readonly clientOrigin?;
+    private readonly callerPackage;
     private isCloudService;
     private getVersion;
     private init;
@@ -3265,7 +3283,8 @@ declare class FirecrawlApp {
      * Initializes a new instance of the FirecrawlApp class.
      * @param config - Configuration options for the FirecrawlApp instance.
      */
-    constructor({ apiKey, apiUrl }: FirecrawlAppConfig);
+    constructor({ apiKey, apiUrl, origin }: FirecrawlAppConfig);
+    private resolveOrigin;
     /**
      * Scrapes a URL using the Firecrawl API.
      * @param url - The URL to scrape.

package/dist/index.d.ts

@@ -765,10 +765,10 @@ interface FindToolsOptions {
     offset?: number;
 }
 interface FindToolsData {
-    level: "providers" | "groups" | "tools";
+    level: "categories" | "providers" | "groups" | "tools";
     items: Array<{
         id: string;
-        name: string;
+        name?: string;
         next?: AlexandriaCall;
         execute?: Pick<AlexandriaCall, "provider" | "capability">;
         [key: string]: unknown;
@@ -2019,6 +2019,7 @@ interface HttpClientOptions {
     timeoutMs?: number;
     maxRetries?: number;
     backoffFactor?: number;
+    origin?: string;
 }
 interface RequestOptions {
     headers?: Record<string, string>;
@@ -2030,9 +2031,12 @@ declare class HttpClient {
     private readonly apiUrl;
     private readonly maxRetries;
     private readonly backoffFactor;
+    private readonly origin;
     constructor(options: HttpClientOptions);
     getApiUrl(): string;
     getApiKey(): string;
+    /** The attribution origin stamped into requests that do not set their own. */
+    getOrigin(): string;
     /** The client-wide default request timeout, for callers that need to
      * extend a specific request beyond it (e.g. scrape auto-resume). */
     getTimeoutMs(): number;
@@ -2119,6 +2123,10 @@ declare function browser(http: HttpClient, args?: {
         name: string;
         saveChanges?: boolean;
     };
+    /** Country the session browses from, as an ISO 3166-1 alpha-2 code (default US). */
+    location?: {
+        country: string;
+    };
     integration?: string;
     origin?: string;
 }): Promise<BrowserCreateResponse>;
@@ -2261,6 +2269,12 @@ interface FirecrawlClientOptions {
     maxRetries?: number;
     /** Exponential backoff factor for retries (optional). */
     backoffFactor?: number;
+    /**
+     * Attribution tag stamped into request bodies. Defaults to `js-sdk@<version>`,
+     * or `js-sdk.<package>@<version>` when an installed package creates the client
+     * (set FIRECRAWL_DISABLE_CALLER_ORIGIN=1 to keep the plain default).
+     */
+    origin?: string;
 }
 /** Accepts a plain API key string or a full options object. */
 type FirecrawlClientInput = FirecrawlClientOptions | string;
@@ -2268,7 +2282,7 @@ type FirecrawlClientInput = FirecrawlClientOptions | string;
  * Firecrawl v2 client. Provides typed access to all v2 endpoints and utilities.
  */
 declare class FirecrawlClient {
-    private readonly http;
+    protected readonly http: HttpClient;
     private _research?;
     private isCloudService;
     /**
@@ -2585,7 +2599,7 @@ declare class FirecrawlClient {
     }): Promise<AgentThreadResponse>;
     /**
      * Create a new browser session.
-     * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile).
+     * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile, location).
      * @returns Session id, CDP URL, live view URL, and expiration time.
      */
     browser(args?: Parameters<typeof browser>[1]): Promise<BrowserCreateResponse>;
@@ -2658,10 +2672,12 @@ declare class FirecrawlClient {
  * Configuration interface for FirecrawlApp.
  * @param apiKey - Optional API key for authentication.
  * @param apiUrl - Optional base URL of the API; defaults to 'https://api.firecrawl.dev'.
+ * @param origin - Optional attribution tag stamped into request bodies.
  */
 interface FirecrawlAppConfig {
     apiKey?: string | null;
     apiUrl?: string | null;
+    origin?: string;
 }
 /**
  * Metadata for a Firecrawl document.
@@ -3258,6 +3274,8 @@ declare class FirecrawlApp {
     apiKey: string;
     apiUrl: string;
     version: string;
+    private readonly clientOrigin?;
+    private readonly callerPackage;
     private isCloudService;
     private getVersion;
     private init;
@@ -3265,7 +3283,8 @@ declare class FirecrawlApp {
      * Initializes a new instance of the FirecrawlApp class.
      * @param config - Configuration options for the FirecrawlApp instance.
      */
-    constructor({ apiKey, apiUrl }: FirecrawlAppConfig);
+    constructor({ apiKey, apiUrl, origin }: FirecrawlAppConfig);
+    private resolveOrigin;
     /**
      * Scrapes a URL using the Firecrawl API.
      * @param url - The URL to scrape.

package/dist/index.js

@@ -1,21 +1,13 @@
 import {
-  require_package
-} from "./chunk-R4XT7PME.js";
+  version
+} from "./chunk-GD463K4D.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
 
 // src/v2/utils/getVersion.ts
 function getVersion() {
-  try {
-    if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
-      return process.env.npm_package_version;
-    }
-    const pkg = require_package();
-    return pkg?.version || "3.x.x";
-  } catch {
-    return "3.x.x";
-  }
+  return version;
 }
 
 // src/utils/apiOrigin.ts
@@ -40,11 +32,13 @@ var HttpClient = class {
   apiUrl;
   maxRetries;
   backoffFactor;
+  origin;
   constructor(options) {
     this.apiKey = options.apiKey;
     this.apiUrl = options.apiUrl.replace(/\/$/, "");
     this.maxRetries = options.maxRetries ?? 3;
     this.backoffFactor = options.backoffFactor ?? 0.5;
+    this.origin = options.origin || `js-sdk@${getVersion()}`;
     this.instance = axios.create({
       baseURL: this.apiUrl,
       timeout: options.timeoutMs ?? 3e5,
@@ -63,13 +57,16 @@ var HttpClient = class {
   getApiKey() {
     return this.apiKey;
   }
+  /** The attribution origin stamped into requests that do not set their own. */
+  getOrigin() {
+    return this.origin;
+  }
   /** The client-wide default request timeout, for callers that need to
    * extend a specific request beyond it (e.g. scrape auto-resume). */
   getTimeoutMs() {
     return this.instance.defaults.timeout ?? 3e5;
   }
   async request(config) {
-    const version = getVersion();
     config.headers = {
       ...config.headers || {}
     };
@@ -84,7 +81,7 @@ var HttpClient = class {
           const data = cfg.data ?? {};
           cfg.data = {
             ...data,
-            origin: typeof data.origin === "string" && data.origin.includes("mcp") ? data.origin : `js-sdk@${version}`
+            origin: typeof data.origin === "string" && data.origin ? data.origin : this.origin
           };
         }
         if (isFormDataBody) {
@@ -323,6 +320,30 @@ function ensureValidFormats(formats) {
     }
   }
 }
+var V1_SCRAPE_OPTION_REPLACEMENTS = {
+  pageOptions: "use scrapeOptions",
+  includeLinks: "add 'links' to scrapeOptions.formats",
+  parsePDF: "use scrapeOptions.parsers"
+};
+var V1_OPTION_REPLACEMENTS = {
+  crawl: {
+    crawlerOptions: "move its fields to the top level",
+    maxDepth: "use maxDiscoveryDepth",
+    allowBackwardLinks: "use crawlEntireDomain",
+    ignoreSitemap: "use sitemap: 'skip'",
+    ...V1_SCRAPE_OPTION_REPLACEMENTS
+  },
+  search: V1_SCRAPE_OPTION_REPLACEMENTS
+};
+function ensureNoV1Options(options, method) {
+  if (!options) return;
+  const replacements = V1_OPTION_REPLACEMENTS[method];
+  const found = Object.keys(replacements).filter((key) => options[key] != null);
+  if (found.length === 0) return;
+  throw new Error(
+    `${method}: ${found.map((key) => `${key} is a v1 option, ${replacements[key]}`).join("; ")}`
+  );
+}
 function ensureValidScrapeOptions(options) {
   if (!options) return;
   if (options.timeout != null && options.timeout <= 0) {
@@ -436,12 +457,28 @@ function ensureValidParseOptions(options) {
 
 // src/v2/utils/errorHandler.ts
 import "axios";
+function describeValidationIssues(details) {
+  if (!Array.isArray(details)) return void 0;
+  const parts = details.slice(0, 3).flatMap((issue) => {
+    if (!issue || typeof issue !== "object") return [];
+    const { path, message, keys } = issue;
+    const what = Array.isArray(keys) && keys.length > 0 ? `unrecognized key(s) ${keys.join(", ")}` : typeof message === "string" ? message : void 0;
+    if (!what) return [];
+    return Array.isArray(path) && path.length > 0 ? [`${path.join(".")}: ${what}`] : [what];
+  });
+  return parts.length > 0 ? parts.join("; ") : void 0;
+}
+function withIssues(message, details) {
+  const text = typeof message === "string" ? message : JSON.stringify(message);
+  const issues = describeValidationIssues(details);
+  return issues && !text.includes(issues) ? `${text} (${issues})` : text;
+}
 function throwForBadResponse(resp, action) {
   const status = resp.status;
   const body = resp.data || {};
   const msg = body?.error || body?.message || `Request failed (${status}) while trying to ${action}`;
   throw Object.assign(new SdkError(
-    msg,
+    withIssues(msg, body?.details),
     status,
     body?.code,
     body?.details,
@@ -456,7 +493,7 @@ function normalizeAxiosError(err, action) {
   const message = body?.error || err.message || `Request failed${status ? ` (${status})` : ""} while trying to ${action}`;
   const code = body?.code || err.code;
   throw Object.assign(new SdkError(
-    message,
+    withIssues(message, body?.details),
     status,
     code,
     body?.details ?? body,
@@ -627,10 +664,9 @@ async function parse(http, file, options) {
     throw new Error("file data cannot be empty");
   }
   if (options) ensureValidParseOptions(options);
-  const version = getVersion();
   const normalizedOptions = {
     ...options ?? {},
-    origin: typeof options?.origin === "string" && options.origin.includes("mcp") ? options.origin : options?.origin ?? `js-sdk@${version}`
+    origin: options?.origin || http.getOrigin()
   };
   const formData = new FormData();
   formData.append("options", JSON.stringify(normalizedOptions));
@@ -668,6 +704,7 @@ async function getParseFormats(http) {
 // src/v2/methods/search.ts
 function prepareSearchPayload(req) {
   if (!req.query || !req.query.trim()) throw new Error("Query cannot be empty");
+  ensureNoV1Options(req, "search");
   if (req.limit != null && req.limit <= 0)
     throw new Error("limit must be positive");
   if (req.timeout != null && req.timeout <= 0)
@@ -1035,7 +1072,9 @@ async function fetchAllPages(http, nextUrl, initial, pagination) {
       docs.push(d);
     }
     if (maxResults != null && docs.length >= maxResults) break;
-    current = payload.next ?? (Array.isArray(payload.data) ? null : payload.data?.next) ?? null;
+    const next = payload.next ?? (Array.isArray(payload.data) ? null : payload.data?.next) ?? null;
+    if (next === current) break;
+    current = next;
     pageCount += 1;
   }
   return docs;
@@ -1044,6 +1083,7 @@ async function fetchAllPages(http, nextUrl, initial, pagination) {
 // src/v2/methods/crawl.ts
 function prepareCrawlPayload(request) {
   if (!request.url || !request.url.trim()) throw new Error("URL cannot be empty");
+  ensureNoV1Options(request, "crawl");
   const data = { url: request.url.trim() };
   if (request.prompt) data.prompt = request.prompt;
   if (request.excludePaths) data.excludePaths = request.excludePaths;
@@ -1595,6 +1635,7 @@ async function browser(http, args = {}) {
   if (args.streamWebView != null) body.streamWebView = args.streamWebView;
   if (args.blockAds != null) body.blockAds = args.blockAds;
   if (args.profile != null) body.profile = args.profile;
+  if (args.location != null) body.location = args.location;
   if (args.integration != null) body.integration = args.integration;
   if (args.origin) body.origin = args.origin;
   try {
@@ -1743,8 +1784,8 @@ function appendParam(params, key, value) {
     params.append(key, String(value));
   }
 }
-function withQuery(path, params) {
-  params.append("origin", `js-sdk@${getVersion()}`);
+function withQuery(origin, path, params) {
+  params.append("origin", origin);
   const qs = params.toString();
   return qs ? `${path}?${qs}` : path;
 }
@@ -1799,7 +1840,7 @@ var ResearchClient = class {
     appendParam(params, "to", options.to);
     try {
       const res = await this.http.get(
-        withQuery(`${BASE}/papers`, params)
+        withQuery(this.http.getOrigin(), `${BASE}/papers`, params)
       );
       if (res.status !== 200) throwForBadResponse(res, "search papers");
       return res.data;
@@ -1817,7 +1858,13 @@ var ResearchClient = class {
     appendParam(params, "query", options.query);
     appendParam(params, "k", options.k);
     try {
-      const res = await this.http.get(withQuery(`${BASE}/papers/${encodeURIComponent(id)}`, params));
+      const res = await this.http.get(
+        withQuery(
+          this.http.getOrigin(),
+          `${BASE}/papers/${encodeURIComponent(id)}`,
+          params
+        )
+      );
       if (res.status !== 200) throwForBadResponse(res, "get paper");
       return res.data;
     } catch (err) {
@@ -1843,7 +1890,11 @@ var ResearchClient = class {
     appendParam(params, "anchor", options.anchor);
     try {
       const res = await this.http.get(
-        withQuery(`${BASE}/papers/${encodeURIComponent(id)}/similar`, params)
+        withQuery(
+          this.http.getOrigin(),
+          `${BASE}/papers/${encodeURIComponent(id)}/similar`,
+          params
+        )
       );
       if (res.status !== 200) throwForBadResponse(res, "find similar papers");
       return res.data;
@@ -1874,7 +1925,7 @@ var ResearchClient = class {
     appendParam(params, "k", options.k);
     try {
       const res = await this.http.get(
-        withQuery(`${BASE}/github`, params)
+        withQuery(this.http.getOrigin(), `${BASE}/github`, params)
       );
       if (res.status !== 200) throwForBadResponse(res, "search github");
       return res.data;
@@ -2004,6 +2055,67 @@ async function getMonitorCheck(http, monitorId, checkId, options) {
   }
 }
 
+// src/utils/callerOrigin.ts
+var NODE_MODULES = "/node_modules/";
+function packageOf(file) {
+  let path = file.replace(/^file:\/\//, "").replace(/\\/g, "/");
+  try {
+    path = decodeURIComponent(path);
+  } catch {
+  }
+  const at = path.lastIndexOf(NODE_MODULES);
+  if (at < 0) return null;
+  const [first, second] = path.slice(at + NODE_MODULES.length).split("/");
+  const name = first?.startsWith("@") ? second ? `${first}/${second}` : "" : first;
+  return name && !name.startsWith(".") ? name : null;
+}
+function frameFile(line) {
+  const text = line.trim().replace(/^at /, "");
+  const open = text.indexOf(" (");
+  const location = open >= 0 && text.endsWith(")") ? text.slice(open + 2, -1) : text;
+  const match = /^(.*):\d+:\d+$/.exec(location);
+  return match && !match[1].startsWith("node:") ? match[1] : null;
+}
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48).replace(/-+$/, "");
+}
+function detectCallerPackage(stack) {
+  try {
+    if (process.env.FIRECRAWL_DISABLE_CALLER_ORIGIN === "1") return null;
+    if (stack === void 0) {
+      const limit = Error.stackTraceLimit;
+      Error.stackTraceLimit = 50;
+      try {
+        stack = new Error().stack ?? "";
+      } finally {
+        Error.stackTraceLimit = limit;
+      }
+    }
+    let ownFile = null;
+    let ownPackage = null;
+    for (const line of stack.split("\n")) {
+      if (!/^\s*at /.test(line)) continue;
+      const file = frameFile(line);
+      if (!file) continue;
+      if (ownFile === null) {
+        ownFile = file;
+        ownPackage = packageOf(file);
+      }
+      if (file === ownFile) continue;
+      const name = packageOf(file);
+      if (name && name === ownPackage) continue;
+      const slug = name ? slugify(name) : "";
+      return slug && !slug.includes("playground") ? slug : null;
+    }
+  } catch {
+  }
+  return null;
+}
+function defaultOrigin(version2) {
+  const caller = detectCallerPackage();
+  return caller ? `js-sdk.${caller}@${version2}` : `js-sdk@${version2}`;
+}
+
 // src/v2/watcher.ts
 import { EventEmitter } from "events";
 var hasGlobalWebSocket = () => {
@@ -2266,7 +2378,8 @@ var FirecrawlClient = class {
       apiUrl,
       timeoutMs: opts.timeoutMs,
       maxRetries: opts.maxRetries,
-      backoffFactor: opts.backoffFactor
+      backoffFactor: opts.backoffFactor,
+      origin: opts.origin || defaultOrigin(getVersion())
     });
   }
   async scrape(url, options) {
@@ -2661,7 +2774,7 @@ var FirecrawlClient = class {
   // Browser
   /**
    * Create a new browser session.
-   * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile).
+   * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile, location).
    * @returns Session id, CDP URL, live view URL, and expiration time.
    */
   async browser(args = {}) {
@@ -2792,6 +2905,8 @@ var FirecrawlApp = class {
   apiKey;
   apiUrl;
   version = "1.25.1";
+  clientOrigin;
+  callerPackage;
   isCloudService(url) {
     return url.includes("api.firecrawl.dev");
   }
@@ -2800,7 +2915,7 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-EI4Q33HD.js");
+      const packageJson = await import("./package-WONXBIJS.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && false;
@@ -2817,15 +2932,22 @@ var FirecrawlApp = class {
    * Initializes a new instance of the FirecrawlApp class.
    * @param config - Configuration options for the FirecrawlApp instance.
    */
-  constructor({ apiKey = null, apiUrl = null }) {
+  constructor({ apiKey = null, apiUrl = null, origin }) {
     const baseUrl = apiUrl || "https://api.firecrawl.dev";
     if (this.isCloudService(baseUrl) && typeof apiKey !== "string") {
       throw new FirecrawlError("No API key provided", 401);
     }
     this.apiKey = apiKey || "";
     this.apiUrl = baseUrl;
+    this.clientOrigin = origin || void 0;
+    this.callerPackage = this.clientOrigin ? null : detectCallerPackage();
     this.init();
   }
+  resolveOrigin(params) {
+    if (typeof params?.origin === "string" && params.origin) return params.origin;
+    if (this.clientOrigin) return this.clientOrigin;
+    return this.callerPackage ? `js-sdk.${this.callerPackage}@${this.version}` : `js-sdk@${this.version}`;
+  }
   /**
    * Scrapes a URL using the Firecrawl API.
    * @param url - The URL to scrape.
@@ -2837,7 +2959,7 @@ var FirecrawlApp = class {
       "Content-Type": "application/json",
       Authorization: `Bearer ${this.apiKey}`
     };
-    let jsonData = { url, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { url, ...params, origin: this.resolveOrigin(params) };
     if (jsonData?.extract?.schema) {
       jsonData = {
         ...jsonData,
@@ -2901,7 +3023,7 @@ var FirecrawlApp = class {
       lang: params?.lang ?? "en",
       country: params?.country ?? "us",
       location: params?.location,
-      origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}`,
+      origin: this.resolveOrigin(params),
       timeout: params?.timeout ?? 6e4,
       scrapeOptions: params?.scrapeOptions ?? { formats: [] }
     };
@@ -2956,7 +3078,7 @@ var FirecrawlApp = class {
    */
   async crawlUrl(url, params, pollInterval = 2, idempotencyKey) {
     const headers = this.prepareHeaders(idempotencyKey);
-    let jsonData = { url, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { url, ...params, origin: this.resolveOrigin(params) };
     try {
       const response = await this.postRequest(
         this.apiUrl + `/v1/crawl`,
@@ -2980,7 +3102,7 @@ var FirecrawlApp = class {
   }
   async asyncCrawlUrl(url, params, idempotencyKey) {
     const headers = this.prepareHeaders(idempotencyKey);
-    let jsonData = { url, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { url, ...params, origin: this.resolveOrigin(params) };
     try {
       const response = await this.postRequest(
         this.apiUrl + `/v1/crawl`,
@@ -3139,7 +3261,7 @@ var FirecrawlApp = class {
    */
   async mapUrl(url, params) {
     const headers = this.prepareHeaders();
-    let jsonData = { url, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { url, ...params, origin: this.resolveOrigin(params) };
     try {
       const response = await this.postRequest(
         this.apiUrl + `/v1/map`,
@@ -3168,7 +3290,7 @@ var FirecrawlApp = class {
    */
   async batchScrapeUrls(urls, params, pollInterval = 2, idempotencyKey, webhook, ignoreInvalidURLs, maxConcurrency) {
     const headers = this.prepareHeaders(idempotencyKey);
-    let jsonData = { urls, webhook, ignoreInvalidURLs, maxConcurrency, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { urls, webhook, ignoreInvalidURLs, maxConcurrency, ...params, origin: this.resolveOrigin(params) };
     if (jsonData?.extract?.schema) {
       jsonData = {
         ...jsonData,
@@ -3210,7 +3332,7 @@ var FirecrawlApp = class {
   }
   async asyncBatchScrapeUrls(urls, params, idempotencyKey, webhook, ignoreInvalidURLs) {
     const headers = this.prepareHeaders(idempotencyKey);
-    let jsonData = { urls, webhook, ignoreInvalidURLs, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { urls, webhook, ignoreInvalidURLs, ...params, origin: this.resolveOrigin(params) };
     try {
       const response = await this.postRequest(
         this.apiUrl + `/v1/batch/scrape`,
@@ -3354,7 +3476,7 @@ var FirecrawlApp = class {
     try {
       const response = await this.postRequest(
         this.apiUrl + `/v1/extract`,
-        { ...jsonData, schema: jsonSchema, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` },
+        { ...jsonData, schema: jsonSchema, origin: this.resolveOrigin(params) },
         headers
       );
       if (response.status === 200) {
@@ -3407,7 +3529,7 @@ var FirecrawlApp = class {
     try {
       const response = await this.postRequest(
         this.apiUrl + `/v1/extract`,
-        { ...jsonData, schema: jsonSchema, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` },
+        { ...jsonData, schema: jsonSchema, origin: this.resolveOrigin(params) },
         headers
       );
       if (response.status === 200) {
@@ -3689,7 +3811,7 @@ var FirecrawlApp = class {
    */
   async asyncDeepResearch(query, params) {
     const headers = this.prepareHeaders();
-    let jsonData = { query, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { query, ...params, origin: this.resolveOrigin(params) };
     if (jsonData?.jsonOptions?.schema) {
       jsonData = {
         ...jsonData,
@@ -3808,7 +3930,7 @@ var FirecrawlApp = class {
   async __asyncDeepResearch(topic, params) {
     const headers = this.prepareHeaders();
     try {
-      let jsonData = { topic, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+      let jsonData = { topic, ...params, origin: this.resolveOrigin(params) };
       const response = await this.postRequest(
         `${this.apiUrl}/v1/deep-research`,
         jsonData,
@@ -3908,7 +4030,7 @@ var FirecrawlApp = class {
    */
   async asyncGenerateLLMsText(url, params) {
     const headers = this.prepareHeaders();
-    let jsonData = { url, ...params, origin: typeof params?.origin === "string" && params.origin.includes("mcp") ? params.origin : `js-sdk@${this.version}` };
+    let jsonData = { url, ...params, origin: this.resolveOrigin(params) };
     try {
       const response = await this.postRequest(
         `${this.apiUrl}/v1/llmstxt`,
@@ -4176,7 +4298,8 @@ var Firecrawl = class extends FirecrawlClient {
     super(resolved);
     this._v1Opts = {
       apiKey: resolved.apiKey,
-      apiUrl: resolved.apiUrl
+      apiUrl: resolved.apiUrl,
+      origin: this.http.getOrigin()
     };
   }
   /** Access the legacy v1 client (instantiated on first access). */