firecrawl 4.46.0 → 4.48.0

package/README.md

@@ -1,6 +1,6 @@
 # Firecrawl Node SDK
 
-The Firecrawl Node SDK is a library that lets you easily search, scrape, and interact with the web for AI agents — returning clean Markdown or structured data your agents can ship with. It provides a simple and intuitive interface for the Firecrawl API.
+The Firecrawl Node SDK is the JavaScript client for the Firecrawl API, the context API for AI agents. Search, scrape, parse, crawl, map, and interact with the web, and get back clean Markdown or structured data your agents can ship with.
 
 ## Installation
 
@@ -13,7 +13,7 @@ npm install firecrawl
 ## Usage
 
 1. Get an API key from [firecrawl.dev](https://firecrawl.dev)
-2. Set the API key as an environment variable named `FIRECRAWL_API_KEY` or pass it as a parameter to the `FirecrawlApp` class.
+2. Set the API key as an environment variable named `FIRECRAWL_API_KEY` or pass it as the `apiKey` option to the `Firecrawl` class.
 
 Here's an example of how to use the SDK with error handling:
 
@@ -37,6 +37,16 @@ const crawlResponse = await app.crawl('https://firecrawl.dev', {
 console.log(crawlResponse);
 ```
 
+### Request origin
+
+Requests carry an `origin` tag that identifies the client. Pass the `origin` option to set it. Set `origin` on a single call to override it for that call, except for `app.research` methods, which always use the client origin.
+
+```js
+const app = new Firecrawl({ apiKey: 'fc-YOUR_API_KEY', origin: 'js-sdk.my-wrapper@1.0.0' });
+```
+
+By default the tag is `js-sdk@<version>`. When the client is created by code inside an installed package (a wrapper library), the default is `js-sdk.<package>@<version>` instead, for example `js-sdk.scope-name@<version>`. Application code, REPLs and bundled files without `node_modules` in their path keep the plain default. Detection runs once when the client is created and sends only the package name, lowercased and sanitized into a slug. Set `FIRECRAWL_DISABLE_CALLER_ORIGIN=1` to always use the plain default.
+
 ### Scraping a URL
 
 To scrape a single URL with error handling, use the `scrape` method. It takes the URL as a parameter and returns the scraped data.
@@ -126,7 +136,7 @@ const crawlResponse = await app.crawl('https://firecrawl.dev', {
 To start an asynchronous crawl, use `startCrawl`. It returns a job ID you can poll with `getCrawlStatus`.
 
 ```js
-const start = await app.startCrawl('https://mendable.ai', {
+const start = await app.startCrawl('https://firecrawl.dev', {
   excludePaths: ['blog/*'],
   limit: 5,
 });
@@ -137,7 +147,7 @@ const start = await app.startCrawl('https://mendable.ai', {
 To check the status of a crawl job with error handling, use the `getCrawlStatus` method. It takes the job ID as a parameter and returns the current status.
 
 ```js
-const status = await app.getCrawlStatus(id);
+const status = await app.getCrawlStatus(start.id);
 ```
 
 ### Extracting structured data from URLs
@@ -323,7 +333,7 @@ await app.stopInteraction(scrapeJobId);
 To receive real‑time updates, start a crawl and attach a watcher.
 
 ```js
-const start = await app.startCrawl('https://mendable.ai', { excludePaths: ['blog/*'], limit: 5 });
+const start = await app.startCrawl('https://firecrawl.dev', { excludePaths: ['blog/*'], limit: 5 });
 const watch = app.watcher(start.id, { kind: 'crawl', pollInterval: 2 });
 
 watch.on('document', (doc) => {
@@ -346,7 +356,7 @@ await watch.start();
 To batch scrape multiple URLs with error handling, use the `batchScrape` method.
 
 ```js
-const batchScrapeResponse = await app.batchScrape(['https://firecrawl.dev', 'https://mendable.ai'], {
+const batchScrapeResponse = await app.batchScrape(['https://firecrawl.dev', 'https://docs.firecrawl.dev'], {
   formats: ['markdown', 'html'],
 });
 ```
@@ -357,7 +367,7 @@ const batchScrapeResponse = await app.batchScrape(['https://firecrawl.dev', 'htt
 To start an asynchronous batch scrape, use `startBatchScrape` and poll with `getBatchScrapeStatus`.
 
 ```js
-const asyncBatchScrapeResult = await app.startBatchScrape(['https://firecrawl.dev', 'https://mendable.ai'], {
+const asyncBatchScrapeResult = await app.startBatchScrape(['https://firecrawl.dev', 'https://docs.firecrawl.dev'], {
   formats: ['markdown', 'html'],
 });
 ```
@@ -367,7 +377,7 @@ const asyncBatchScrapeResult = await app.startBatchScrape(['https://firecrawl.de
 To use batch scrape with real‑time updates, start the job and watch it using the watcher.
 
 ```js
-const start = await app.startBatchScrape(['https://firecrawl.dev', 'https://mendable.ai'], { formats: ['markdown', 'html'] });
+const start = await app.startBatchScrape(['https://firecrawl.dev', 'https://docs.firecrawl.dev'], { formats: ['markdown', 'html'] });
 const watch = app.watcher(start.id, { kind: 'batch', pollInterval: 2 });
 
 watch.on('document', (doc) => {

package/dist/chunk-GD463K4D.js

@@ -0,0 +1,114 @@
+// package.json
+var name = "@mendable/firecrawl-js";
+var version = "4.48.0";
+var description = "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts";
+var main = "dist/index.js";
+var types = "dist/index.d.ts";
+var exports = {
+  "./package.json": "./package.json",
+  ".": {
+    import: "./dist/index.js",
+    default: "./dist/index.cjs"
+  }
+};
+var type = "module";
+var scripts = {
+  build: "tsup",
+  "build-and-publish": "pnpm run build && pnpm publish --access public",
+  "publish-beta": "pnpm run build && pnpm publish --access public --tag beta",
+  test: "vitest run --reporter=verbose src/__tests__/e2e/v2",
+  "test:unit": "vitest run --reporter=verbose src/__tests__/unit"
+};
+var repository = {
+  type: "git",
+  url: "git+https://github.com/firecrawl/firecrawl.git"
+};
+var author = "Mendable.ai";
+var license = "MIT";
+var dependencies = {
+  axios: "1.20.0",
+  firecrawl: "4.30.1",
+  "typescript-event-target": "^1.1.1",
+  zod: "^3.23.8",
+  "zod-to-json-schema": "^3.23.0"
+};
+var bugs = {
+  url: "https://github.com/firecrawl/firecrawl/issues"
+};
+var homepage = "https://github.com/firecrawl/firecrawl#readme";
+var devDependencies = {
+  "@types/dotenv": "^8.2.0",
+  "@types/node": "^20.12.12",
+  "@types/uuid": "^9.0.8",
+  dotenv: "^16.4.5",
+  tsup: "^8.5.0",
+  typescript: "^5.4.5",
+  uuid: "^14.0.0",
+  vitest: "^4.1.11"
+};
+var keywords = [
+  "firecrawl",
+  "mendable",
+  "crawler",
+  "web",
+  "scraper",
+  "api",
+  "sdk",
+  "web-search",
+  "literature-search",
+  "research",
+  "scientific-papers",
+  "academic-search",
+  "biomedical",
+  "life-sciences",
+  "pubmed",
+  "biorxiv",
+  "medrxiv",
+  "arxiv",
+  "preprints",
+  "citations",
+  "bioinformatics"
+];
+var engines = {
+  node: ">=22.0.0"
+};
+var package_default = {
+  name,
+  version,
+  description,
+  main,
+  types,
+  exports,
+  type,
+  scripts,
+  repository,
+  author,
+  license,
+  dependencies,
+  bugs,
+  homepage,
+  devDependencies,
+  keywords,
+  engines
+};
+
+export {
+  name,
+  version,
+  description,
+  main,
+  types,
+  exports,
+  type,
+  scripts,
+  repository,
+  author,
+  license,
+  dependencies,
+  bugs,
+  homepage,
+  devDependencies,
+  keywords,
+  engines,
+  package_default
+};

package/dist/index.cjs

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.46.0",
+      version: "4.48.0",
       description: "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -134,16 +134,9 @@ module.exports = __toCommonJS(index_exports);
 var import_axios = __toESM(require("axios"), 1);
 
 // src/v2/utils/getVersion.ts
+var import_package = __toESM(require_package(), 1);
 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 import_package.version;
 }
 
 // src/utils/apiOrigin.ts
@@ -168,11 +161,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 = import_axios.default.create({
       baseURL: this.apiUrl,
       timeout: options.timeoutMs ?? 3e5,
@@ -191,13 +186,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 || {}
     };
@@ -212,7 +210,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) {
@@ -451,6 +449,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) {
@@ -564,12 +586,28 @@ function ensureValidParseOptions(options) {
 
 // src/v2/utils/errorHandler.ts
 var import_axios2 = require("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,
@@ -584,7 +622,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,
@@ -755,10 +793,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));
@@ -796,6 +833,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)
@@ -1163,7 +1201,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;
@@ -1172,6 +1212,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;
@@ -1723,6 +1764,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 {
@@ -1871,8 +1913,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;
 }
@@ -1927,7 +1969,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;
@@ -1945,7 +1987,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) {
@@ -1971,7 +2019,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;
@@ -2002,7 +2054,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;
@@ -2132,6 +2184,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
 var import_events = require("events");
 var hasGlobalWebSocket = () => {
@@ -2394,7 +2507,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) {
@@ -2789,7 +2903,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 = {}) {
@@ -2920,6 +3034,8 @@ var FirecrawlApp = class {
   apiKey;
   apiUrl;
   version = "1.25.1";
+  clientOrigin;
+  callerPackage;
   isCloudService(url) {
     return url.includes("api.firecrawl.dev");
   }
@@ -2945,15 +3061,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.
@@ -2965,7 +3088,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,
@@ -3029,7 +3152,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: [] }
     };
@@ -3084,7 +3207,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`,
@@ -3108,7 +3231,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`,
@@ -3267,7 +3390,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`,
@@ -3296,7 +3419,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,
@@ -3338,7 +3461,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`,
@@ -3482,7 +3605,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) {
@@ -3535,7 +3658,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) {
@@ -3817,7 +3940,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,
@@ -3936,7 +4059,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,
@@ -4036,7 +4159,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`,
@@ -4304,7 +4427,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). */