@openclaw/firecrawl-plugin 2026.11.1 → 2026.11.3

package/dist/.setup/{firecrawl-client-Dk_bi5M_.mjs → firecrawl-client--j4MjwgU.mjs}

@@ -1,4 +1,5 @@
 import { resolveSiteName } from "openclaw/plugin-sdk/provider-web-search";
+import { hash } from "node:crypto";
 import { asNonNegativeFiniteNumber, asPositiveFiniteNumber, parseDateStringTimestampMs, parseFiniteNumber, resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 import { ProviderHttpError, readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache, readResponseText, resolveCacheTtlMs, resolvePositiveTimeoutSeconds, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint, writeCache } from "openclaw/plugin-sdk/provider-web-fetch";
@@ -7,7 +8,7 @@ import { truncateSanitizedExternalContent, wrapExternalContent, wrapWebContent }
 import { SsrFBlockedError, isBlockedHostnameOrIp, isPrivateIpAddress, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { asBoolean, asOptionalObjectRecord, asOptionalRecord, asRecord, normalizeOptionalString, readStringField } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveReadOnlyEnvSecretRef } from "openclaw/plugin-sdk/secret-ref-readonly";
-// \0rolldown/runtime.js
+//#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -39,29 +40,19 @@ function resolveConfiguredSecret(value, path, cfg) {
 		normalizeValue: normalizeSecretInput
 	});
 }
-function resolveFirecrawlApiKey(cfg) {
-	const pluginConfig = cfg?.plugins?.entries?.firecrawl?.config;
-	const search = resolveFirecrawlSearchConfig(cfg);
-	const configuredCandidates = [{
-		value: pluginConfig?.webFetch?.apiKey,
-		path: "plugins.entries.firecrawl.config.webFetch.apiKey"
-	}, {
-		value: search?.apiKey,
-		path: "plugins.entries.firecrawl.config.webSearch.apiKey"
-	}];
-	let blockedConfiguredSecret = false;
-	for (const candidate of configuredCandidates) {
-		const resolved = resolveConfiguredSecret(candidate.value, candidate.path, cfg);
-		if (resolved.status === "available") return resolved.value;
-		if (resolved.status === "blocked") blockedConfiguredSecret = true;
-	}
-	if (blockedConfiguredSecret) return;
-	return normalizeSecretInput(process.env[FIRECRAWL_API_KEY_ENV_VAR]) || void 0;
-}
-function resolveFirecrawlBaseUrl(cfg) {
-	const search = resolveFirecrawlSearchConfig(cfg);
-	const fetch = resolveFirecrawlFetchConfig(cfg);
-	return normalizeOptionalString(search?.baseUrl) || normalizeOptionalString(fetch?.baseUrl) || normalizeSecretInput(process.env.FIRECRAWL_BASE_URL) || "https://api.firecrawl.dev";
+function resolveFirecrawlConnection(cfg, scope) {
+	const scopes = {
+		webSearch: resolveFirecrawlSearchConfig(cfg),
+		webFetch: resolveFirecrawlFetchConfig(cfg)
+	};
+	const primary = scopes[scope];
+	const selectedScope = primary?.apiKey === void 0 && !normalizeOptionalString(primary?.baseUrl) ? scope === "webSearch" ? "webFetch" : "webSearch" : scope;
+	const connection = scopes[selectedScope];
+	const resolved = resolveConfiguredSecret(connection?.apiKey, `plugins.entries.firecrawl.config.${selectedScope}.apiKey`, cfg);
+	return {
+		apiKey: resolved.status === "available" ? resolved.value : resolved.status === "blocked" ? void 0 : normalizeSecretInput(process.env[FIRECRAWL_API_KEY_ENV_VAR]) || void 0,
+		baseUrl: normalizeOptionalString(connection?.baseUrl) || normalizeSecretInput(process.env.FIRECRAWL_BASE_URL) || "https://api.firecrawl.dev"
+	};
 }
 function resolveFirecrawlOnlyMainContent(cfg, override) {
 	return asBoolean(override) ?? asBoolean(resolveFirecrawlFetchConfig(cfg)?.onlyMainContent) ?? true;
@@ -76,7 +67,8 @@ function resolveFirecrawlScrapeTimeoutSeconds(cfg, override) {
 function resolveFirecrawlSearchTimeoutSeconds(override) {
 	return resolvePositiveTimeoutSeconds(override, DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS);
 }
-// extensions/firecrawl/src/firecrawl-client.ts
+//#endregion
+//#region extensions/firecrawl/src/firecrawl-client.ts
 var firecrawl_client_exports = /* @__PURE__ */ __exportAll({
 	assertFirecrawlScrapeTargetAllowed: () => assertFirecrawlScrapeTargetAllowed,
 	parseFirecrawlScrapePayload: () => parseFirecrawlScrapePayload,
@@ -239,7 +231,8 @@ async function runFirecrawlSearch(params) {
 	params.signal?.throwIfAborted();
 	const keyless = params.access === "keyless";
 	const providerId = keyless ? "firecrawl-free" : "firecrawl";
-	const apiKey = keyless ? void 0 : resolveFirecrawlApiKey(params.cfg);
+	const connection = resolveFirecrawlConnection(params.cfg, "webSearch");
+	const apiKey = keyless ? void 0 : connection.apiKey;
 	if (!apiKey && !keyless) throw new Error("web_search (firecrawl) needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webSearch.apiKey.");
 	const count = resolveIntegerOption(params.count, DEFAULT_SEARCH_COUNT, {
 		min: 1,
@@ -255,10 +248,11 @@ async function runFirecrawlSearch(params) {
 	const tbs = normalizeOptionalString(params.tbs);
 	const location = normalizeOptionalString(params.location);
 	const country = normalizeOptionalString(params.country);
-	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
+	const baseUrl = connection.baseUrl;
 	const cacheKey = normalizeCacheKey(JSON.stringify({
 		type: "firecrawl-search",
 		provider: providerId,
+		credential: apiKey ? hash("sha256", apiKey, "hex") : void 0,
 		q: params.query,
 		count,
 		baseUrl,
@@ -391,9 +385,8 @@ function parseFirecrawlScrapePayload(params) {
 async function runFirecrawlScrape(params) {
 	params.signal?.throwIfAborted();
 	assertFirecrawlScrapeTargetAllowed(params.url);
-	const apiKey = resolveFirecrawlApiKey(params.cfg);
+	const { apiKey, baseUrl } = resolveFirecrawlConnection(params.cfg, "webFetch");
 	if (!apiKey && params.access !== "keyless") throw new Error("firecrawl_scrape needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webFetch.apiKey.");
-	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
 	const timeoutSeconds = resolveFirecrawlScrapeTimeoutSeconds(params.cfg, params.timeoutSeconds);
 	const onlyMainContent = resolveFirecrawlOnlyMainContent(params.cfg, params.onlyMainContent);
 	const maxAgeMs = resolveFirecrawlMaxAgeMs(params.cfg, params.maxAgeMs);
@@ -437,4 +430,5 @@ const testing = {
 	resolveEndpoint,
 	resolveSearchItems
 };
+//#endregion
 export { runFirecrawlScrape as n, runFirecrawlSearch as r, firecrawl_client_exports as t };

package/dist/.setup/{firecrawl-fetch-provider-EP1XFhDE.mjs → firecrawl-fetch-provider-Br32KRpR.mjs}

@@ -1,7 +1,7 @@
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-contract";
-// extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts
+//#region extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts
 function ensureRecord(target, key) {
 	const current = target[key];
 	if (current && typeof current === "object" && !Array.isArray(current)) return current;
@@ -49,8 +49,9 @@ const FIRECRAWL_WEB_FETCH_PROVIDER_SHARED = {
 		webFetch.apiKey = value;
 	}
 };
-// extensions/firecrawl/src/firecrawl-fetch-provider.ts
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-Dk_bi5M_.mjs").then((n) => n.t));
+//#endregion
+//#region extensions/firecrawl/src/firecrawl-fetch-provider.ts
+const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client--j4MjwgU.mjs").then((n) => n.t));
 function createFirecrawlWebFetchProvider() {
 	return {
 		...FIRECRAWL_WEB_FETCH_PROVIDER_SHARED,
@@ -80,4 +81,5 @@ function createFirecrawlWebFetchProvider() {
 		})
 	};
 }
+//#endregion
 export { createFirecrawlWebFetchProvider as t };

package/dist/.setup/{firecrawl-search-provider-Dg-_xx_m.mjs → firecrawl-search-provider-D_gyroLO.mjs}

@@ -2,9 +2,9 @@ import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createWebSearchProviderContractFields, enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-search-contract";
-// extensions/firecrawl/src/firecrawl-search-provider.ts
+//#region extensions/firecrawl/src/firecrawl-search-provider.ts
 const FIRECRAWL_CREDENTIAL_PATH = "plugins.entries.firecrawl.config.webSearch.apiKey";
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-Dk_bi5M_.mjs").then((n) => n.t));
+const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client--j4MjwgU.mjs").then((n) => n.t));
 const GenericFirecrawlSearchSchema = {
 	type: "object",
 	properties: {
@@ -106,4 +106,5 @@ function createFirecrawlWebSearchProvider() {
 function createFirecrawlFreeWebSearchProvider() {
 	return createFirecrawlSearchProvider(true);
 }
+//#endregion
 export { createFirecrawlWebSearchProvider as n, createFirecrawlFreeWebSearchProvider as t };

package/dist/api.js

@@ -1,5 +1,5 @@
-import { n as runFirecrawlScrape } from "./.setup/firecrawl-client-Dk_bi5M_.mjs";
-// extensions/firecrawl/api.ts
+import { n as runFirecrawlScrape } from "./.setup/firecrawl-client--j4MjwgU.mjs";
+//#region extensions/firecrawl/api.ts
 async function fetchFirecrawlContent(params) {
 	const cfg = { plugins: { entries: { firecrawl: {
 		enabled: true,
@@ -30,4 +30,5 @@ async function fetchFirecrawlContent(params) {
 		warning: result.warning
 	};
 }
+//#endregion
 export { fetchFirecrawlContent };

package/dist/index.js

@@ -1,11 +1,11 @@
-import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client-Dk_bi5M_.mjs";
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-EP1XFhDE.mjs";
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-Dg-_xx_m.mjs";
+import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client--j4MjwgU.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
 import { jsonResult, readNonNegativeIntegerParam, readPositiveIntegerParam, readStringArrayParam, readStringParam } from "openclaw/plugin-sdk/provider-web-search";
 import { Type } from "typebox";
-// extensions/firecrawl/src/firecrawl-scrape-tool.ts
+//#region extensions/firecrawl/src/firecrawl-scrape-tool.ts
 const FirecrawlScrapeToolSchema = Type.Object({
 	url: Type.String({ description: "HTTP or HTTPS URL to scrape via Firecrawl." }),
 	extractMode: optionalStringEnum(["markdown", "text"], { description: "Extraction mode (\"markdown\" or \"text\"). Default: markdown." }),
@@ -62,7 +62,8 @@ function createFirecrawlScrapeTool(api) {
 		}
 	};
 }
-// extensions/firecrawl/src/firecrawl-search-tool.ts
+//#endregion
+//#region extensions/firecrawl/src/firecrawl-search-tool.ts
 const FirecrawlSearchToolSchema = Type.Object({
 	query: Type.String({ description: "Search query string." }),
 	count: Type.Optional(Type.Integer({
@@ -113,7 +114,8 @@ function createFirecrawlSearchTool(api) {
 		}
 	};
 }
-// extensions/firecrawl/index.ts
+//#endregion
+//#region extensions/firecrawl/index.ts
 var firecrawl_default = definePluginEntry({
 	id: "firecrawl",
 	name: "Firecrawl Plugin",
@@ -126,4 +128,5 @@ var firecrawl_default = definePluginEntry({
 		api.registerTool(createFirecrawlScrapeTool(api));
 	}
 });
+//#endregion
 export { firecrawl_default as default };

package/dist/web-fetch-contract-api.js

@@ -1,2 +1,3 @@
-export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-EP1XFhDE.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
 import "./web-fetch-provider.js";
+export { createFirecrawlWebFetchProvider };

package/dist/web-fetch-provider.js

@@ -1 +1,2 @@
-export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-EP1XFhDE.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
+export { createFirecrawlWebFetchProvider };

package/dist/web-search-contract-api.js

@@ -1,2 +1,3 @@
-export { t as createFirecrawlFreeWebSearchProvider, n as createFirecrawlWebSearchProvider } from "./.setup/firecrawl-search-provider-Dg-_xx_m.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
 import "./web-search-provider.js";
+export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/dist/web-search-provider.js

@@ -1 +1,2 @@
-export { t as createFirecrawlFreeWebSearchProvider, n as createFirecrawlWebSearchProvider } from "./.setup/firecrawl-search-provider-Dg-_xx_m.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
+export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/firecrawl-plugin",
-  "version": "2026.11.1",
+  "version": "2026.11.3",
   "description": "OpenClaw Firecrawl plugin.",
   "repository": {
     "type": "git",
@@ -21,10 +21,10 @@
       "minHostVersion": ">=2026.6.8"
     },
     "compat": {
-      "pluginApi": ">=2026.11.1"
+      "pluginApi": ">=2026.11.3"
     },
     "build": {
-      "openclawVersion": "2026.11.1",
+      "openclawVersion": "2026.11.3",
       "bundledDist": false
     },
     "release": {
@@ -43,7 +43,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.11.1"
+    "openclaw": ">=2026.11.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/.source-module-urls/ad8205c790d921269d4ea28d22ab658579b9674fd00e025664fcf0b8ea32155c.json

@@ -1 +0,0 @@
-{"version":3,"entries":[{"output":"api.js","source":"extensions/firecrawl/api.ts"},{"output":"index.js","source":"extensions/firecrawl/index.ts"},{"output":"web-fetch-contract-api.js","source":"extensions/firecrawl/web-fetch-contract-api.ts"},{"output":"web-fetch-provider.js","source":"extensions/firecrawl/web-fetch-provider.ts"},{"output":"web-search-contract-api.js","source":"extensions/firecrawl/web-search-contract-api.ts"},{"output":"web-search-provider.js","source":"extensions/firecrawl/web-search-provider.ts"}],"chunks":[{"output":".setup/firecrawl-client-Dk_bi5M_.mjs","sha256":"774b38239e4f578c2149ec27ef91f46ebf99354db4e16243e6f83209aaaed717","facadeSource":null,"sources":["extensions/firecrawl/src/config.ts","extensions/firecrawl/src/firecrawl-client.ts"]},{"output":".setup/firecrawl-fetch-provider-EP1XFhDE.mjs","sha256":"81a0a868cda6386f992e84287f96e973374877e9299337698d5f1db4a23ea537","facadeSource":null,"sources":["extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts","extensions/firecrawl/src/firecrawl-fetch-provider.ts"]},{"output":".setup/firecrawl-search-provider-Dg-_xx_m.mjs","sha256":"13f6a7f2b72fa874d55f7afdb6378b76f36710c5bb52674a8b770456d2c1f4dd","facadeSource":null,"sources":["extensions/firecrawl/src/firecrawl-search-provider.ts"]},{"output":"api.js","sha256":"e28d050266697b2e5c369142ced5af70472bd93fec74a8e69897eac82f961dcc","facadeSource":"extensions/firecrawl/api.ts","sources":["extensions/firecrawl/api.ts"]},{"output":"index.js","sha256":"7391b6054e3a1882899054dac3303ff5d66cdcdf0242f0ca29949c280d6dcd31","facadeSource":"extensions/firecrawl/index.ts","sources":["extensions/firecrawl/index.ts","extensions/firecrawl/src/firecrawl-scrape-tool.ts","extensions/firecrawl/src/firecrawl-search-tool.ts"]},{"output":"web-fetch-contract-api.js","sha256":"6dd17949a8c79a884ebb5bb2003a1f970df8388242fd0f09734fd83fd577a864","facadeSource":"extensions/firecrawl/web-fetch-contract-api.ts","sources":[]},{"output":"web-fetch-provider.js","sha256":"283c5b3182c3a3f605ede1a44accdcb85f8a5409ab0356127bf7d2223d955ecf","facadeSource":"extensions/firecrawl/web-fetch-provider.ts","sources":[]},{"output":"web-search-contract-api.js","sha256":"f54c73b6596a5f879bfeb9d06f969652d4943e30d1ad7b94ec5568f6495e3e83","facadeSource":"extensions/firecrawl/web-search-contract-api.ts","sources":[]},{"output":"web-search-provider.js","sha256":"c3ad8cd2e10fe23a708f81b1b5e5b5257d17f8e59cf40e407be3812016986ce4","facadeSource":"extensions/firecrawl/web-search-provider.ts","sources":[]}],"unrenderedSources":["extensions/firecrawl/web-fetch-contract-api.ts","extensions/firecrawl/web-fetch-provider.ts","extensions/firecrawl/web-search-contract-api.ts","extensions/firecrawl/web-search-provider.ts"]}