@openclaw/firecrawl-plugin 2026.7.1 → 2026.7.2-beta.1

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as runFirecrawlScrape } from "./firecrawl-client-xZqyVUBg.js";
+import { n as runFirecrawlScrape } from "./firecrawl-client-CPw_AuJR.js";
 import { readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/firecrawl/api.ts
 async function fetchFirecrawlContent(params) {

package/dist/{firecrawl-client-xZqyVUBg.js → firecrawl-client-CPw_AuJR.js}

@@ -3,6 +3,8 @@ import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache
 import { normalizeSecretInput, resolveSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import { wrapExternalContent, wrapWebContent } from "openclaw/plugin-sdk/security-runtime";
 import { SsrFBlockedError, isBlockedHostnameOrIp, isPrivateIpAddress, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
+import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { canResolveEnvSecretRefInReadOnlyPath } from "openclaw/plugin-sdk/extension-shared";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -15,6 +17,8 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+const DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS = 30;
+const DEFAULT_FIRECRAWL_SCRAPE_TIMEOUT_SECONDS = 60;
 const DEFAULT_FIRECRAWL_MAX_AGE_MS = 1728e5;
 const FIRECRAWL_API_KEY_ENV_VAR = "FIRECRAWL_API_KEY";
 function resolveSearchConfig(cfg) {
@@ -123,10 +127,10 @@ function resolveFirecrawlMaxAgeMs(cfg, override) {
 	return DEFAULT_FIRECRAWL_MAX_AGE_MS;
 }
 function resolveFirecrawlScrapeTimeoutSeconds(cfg, override) {
-	return resolvePositiveTimeoutSeconds(override, resolvePositiveTimeoutSeconds(resolveFirecrawlFetchConfig(cfg)?.timeoutSeconds, 60));
+	return resolvePositiveTimeoutSeconds(override, resolvePositiveTimeoutSeconds(resolveFirecrawlFetchConfig(cfg)?.timeoutSeconds, DEFAULT_FIRECRAWL_SCRAPE_TIMEOUT_SECONDS));
 }
 function resolveFirecrawlSearchTimeoutSeconds(override) {
-	return resolvePositiveTimeoutSeconds(override, 30);
+	return resolvePositiveTimeoutSeconds(override, DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS);
 }
 //#endregion
 //#region extensions/firecrawl/src/firecrawl-client.ts
@@ -232,7 +236,7 @@ async function postFirecrawlJson(params, parse) {
 				const errorBody = await readResponseText(response, { maxBytes: 64e3 });
 				if (errorBody.text) detail = errorBody.text;
 			}
-			const safeDetail = wrapWebContent(detail.slice(0, 1e3), "web_fetch");
+			const safeDetail = wrapWebContent(truncateUtf16Safe(detail, 1e3), "web_fetch");
 			throw new Error(`${params.errorLabel} API error (${response.status}): ${safeDetail}`);
 		}
 		return await parse(response);
@@ -300,21 +304,35 @@ function buildSearchPayload(params) {
 	};
 }
 async function runFirecrawlSearch(params) {
-	const apiKey = resolveFirecrawlApiKey(params.cfg);
-	if (!apiKey) 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 = typeof params.count === "number" && Number.isFinite(params.count) ? Math.max(1, Math.min(10, Math.floor(params.count))) : DEFAULT_SEARCH_COUNT;
+	const keyless = params.access === "keyless";
+	const providerId = keyless ? "firecrawl-free" : "firecrawl";
+	const apiKey = keyless ? void 0 : resolveFirecrawlApiKey(params.cfg);
+	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 = typeof params.count === "number" && Number.isFinite(params.count) ? Math.max(1, Math.min(100, Math.floor(params.count))) : DEFAULT_SEARCH_COUNT;
 	const timeoutSeconds = resolveFirecrawlSearchTimeoutSeconds(params.timeoutSeconds);
 	const scrapeResults = params.scrapeResults === true;
 	const sources = Array.isArray(params.sources) ? params.sources.filter(Boolean) : [];
 	const categories = Array.isArray(params.categories) ? params.categories.filter(Boolean) : [];
+	const includeDomains = Array.isArray(params.includeDomains) ? params.includeDomains.filter(Boolean) : [];
+	const excludeDomains = Array.isArray(params.excludeDomains) ? params.excludeDomains.filter(Boolean) : [];
+	if (includeDomains.length > 0 && excludeDomains.length > 0) throw new Error("Firecrawl search accepts includeDomains or excludeDomains, not both.");
+	const tbs = normalizeOptionalString(params.tbs);
+	const location = normalizeOptionalString(params.location);
+	const country = normalizeOptionalString(params.country);
 	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
 	const cacheKey = normalizeCacheKey(JSON.stringify({
 		type: "firecrawl-search",
+		provider: providerId,
 		q: params.query,
 		count,
 		baseUrl,
 		sources,
 		categories,
+		includeDomains,
+		excludeDomains,
+		tbs,
+		location,
+		country,
 		scrapeResults
 	}));
 	const cached = readCache(SEARCH_CACHE, cacheKey);
@@ -328,6 +346,11 @@ async function runFirecrawlSearch(params) {
 	};
 	if (sources.length > 0) body.sources = sources;
 	if (categories.length > 0) body.categories = categories;
+	if (includeDomains.length > 0) body.includeDomains = includeDomains;
+	if (excludeDomains.length > 0) body.excludeDomains = excludeDomains;
+	if (tbs) body.tbs = tbs;
+	if (location) body.location = location;
+	if (country) body.country = country;
 	if (scrapeResults) body.scrapeOptions = { formats: ["markdown"] };
 	const start = Date.now();
 	const endpoint = await resolveEndpoint(baseUrl, "/v2/search");
@@ -348,7 +371,7 @@ async function runFirecrawlSearch(params) {
 	});
 	const result = buildSearchPayload({
 		query: params.query,
-		provider: "firecrawl",
+		provider: providerId,
 		items: resolveSearchItems(payload),
 		tookMs: Date.now() - start,
 		scrapeResults

package/dist/{firecrawl-fetch-provider-CasPevAg.js → firecrawl-fetch-provider-D6Rj8lqo.js}

@@ -4,7 +4,7 @@ import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-con
 //#region extensions/firecrawl/src/firecrawl-fetch-provider.ts
 let firecrawlClientModulePromise;
 function loadFirecrawlClientModule() {
-	firecrawlClientModulePromise ??= import("./firecrawl-client-xZqyVUBg.js").then((n) => n.t);
+	firecrawlClientModulePromise ??= import("./firecrawl-client-CPw_AuJR.js").then((n) => n.t);
 	return firecrawlClientModulePromise;
 }
 function createFirecrawlWebFetchProvider() {

package/dist/firecrawl-free-search-provider-E4DXHcwh.js

@@ -0,0 +1,71 @@
+import { buildFirecrawlFreeWebSearchProviderBase, buildFirecrawlWebSearchProviderBase } from "./web-search-shared.js";
+import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
+import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
+//#region extensions/firecrawl/src/firecrawl-search-provider.ts
+const loadFirecrawlClientModule$1 = createLazyRuntimeModule(() => import("./firecrawl-client-CPw_AuJR.js").then((n) => n.t));
+const GenericFirecrawlSearchSchema = {
+	type: "object",
+	properties: {
+		query: {
+			type: "string",
+			description: "Search query string."
+		},
+		count: {
+			type: "integer",
+			description: "Number of results to return (1-10).",
+			minimum: 1,
+			maximum: 10
+		}
+	},
+	additionalProperties: false
+};
+function createFirecrawlWebSearchProvider() {
+	return {
+		...buildFirecrawlWebSearchProviderBase(),
+		createTool: (ctx) => ({
+			description: "Search the web using Firecrawl. Returns structured results with snippets from Firecrawl Search. Use firecrawl_search for Firecrawl-specific knobs like sources or categories.",
+			parameters: GenericFirecrawlSearchSchema,
+			execute: async (args) => {
+				const { runFirecrawlSearch } = await loadFirecrawlClientModule$1();
+				return await runFirecrawlSearch({
+					cfg: ctx.config,
+					query: typeof args.query === "string" ? args.query : "",
+					count: readPositiveIntegerParam(args, "count", {
+						message: "count must be an integer from 1 to 10",
+						max: 10
+					})
+				});
+			}
+		})
+	};
+}
+//#endregion
+//#region extensions/firecrawl/src/firecrawl-free-search-provider.ts
+let firecrawlClientModulePromise;
+function loadFirecrawlClientModule() {
+	firecrawlClientModulePromise ??= import("./firecrawl-client-CPw_AuJR.js").then((n) => n.t);
+	return firecrawlClientModulePromise;
+}
+function createFirecrawlFreeWebSearchProvider() {
+	return {
+		...buildFirecrawlFreeWebSearchProviderBase(),
+		createTool: (ctx) => ({
+			description: "Search the web using Firecrawl's free hosted starter tier (no API key required). Returns structured results with snippets. Use firecrawl_search for Firecrawl-specific knobs like sources or categories.",
+			parameters: GenericFirecrawlSearchSchema,
+			execute: async (args) => {
+				const { runFirecrawlSearch } = await loadFirecrawlClientModule();
+				return await runFirecrawlSearch({
+					cfg: ctx.config,
+					query: typeof args.query === "string" ? args.query : "",
+					count: readPositiveIntegerParam(args, "count", {
+						message: "count must be an integer from 1 to 10",
+						max: 10
+					}),
+					access: "keyless"
+				});
+			}
+		})
+	};
+}
+//#endregion
+export { createFirecrawlWebSearchProvider as n, createFirecrawlFreeWebSearchProvider as t };

package/dist/index.js

@@ -1,6 +1,6 @@
-import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./firecrawl-client-xZqyVUBg.js";
-import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-CasPevAg.js";
-import { t as createFirecrawlWebSearchProvider } from "./firecrawl-search-provider-C_iN9LEC.js";
+import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./firecrawl-client-CPw_AuJR.js";
+import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-D6Rj8lqo.js";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-E4DXHcwh.js";
 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";
@@ -64,12 +64,17 @@ function createFirecrawlScrapeTool(api) {
 const FirecrawlSearchToolSchema = Type.Object({
 	query: Type.String({ description: "Search query string." }),
 	count: Type.Optional(Type.Integer({
-		description: "Number of results to return (1-10).",
+		description: "Number of results to return (1-100).",
 		minimum: 1,
-		maximum: 10
+		maximum: 100
 	})),
 	sources: Type.Optional(Type.Array(Type.String(), { description: "Optional sources list, for example [\"web\"], [\"news\"], or [\"images\"]." })),
 	categories: Type.Optional(Type.Array(Type.String(), { description: "Optional Firecrawl categories, for example [\"github\"] or [\"research\"]." })),
+	includeDomains: Type.Optional(Type.Array(Type.String(), { description: "Restrict results to these hostnames (no protocol or path). Cannot be combined with excludeDomains." })),
+	excludeDomains: Type.Optional(Type.Array(Type.String(), { description: "Exclude these hostnames from results (no protocol or path). Cannot be combined with includeDomains." })),
+	tbs: Type.Optional(Type.String({ description: "Time-based filter, for example \"qdr:d\" (day), \"qdr:w\" (week), \"qdr:m\", \"qdr:y\", or \"sbd:1\" to sort by date." })),
+	location: Type.Optional(Type.String({ description: "Geo-target location, for example \"Germany\" or \"San Francisco,California,United States\"." })),
+	country: Type.Optional(Type.String({ description: "ISO country code for geo-targeting, for example \"US\", \"DE\", or \"JP\"." })),
 	scrapeResults: Type.Optional(Type.Boolean({ description: "Include scraped result content when Firecrawl returns it." })),
 	timeoutSeconds: Type.Optional(Type.Integer({
 		description: "Timeout in seconds for the Firecrawl Search request.",
@@ -85,12 +90,17 @@ function createFirecrawlSearchTool(api) {
 		execute: async (_toolCallId, rawParams) => {
 			const query = readStringParam(rawParams, "query", { required: true });
 			const count = readPositiveIntegerParam(rawParams, "count", {
-				max: 10,
-				message: "count must be an integer from 1 to 10"
+				max: 100,
+				message: "count must be an integer from 1 to 100"
 			});
 			const timeoutSeconds = readPositiveIntegerParam(rawParams, "timeoutSeconds");
 			const sources = readStringArrayParam(rawParams, "sources");
 			const categories = readStringArrayParam(rawParams, "categories");
+			const includeDomains = readStringArrayParam(rawParams, "includeDomains");
+			const excludeDomains = readStringArrayParam(rawParams, "excludeDomains");
+			const tbs = readStringParam(rawParams, "tbs");
+			const location = readStringParam(rawParams, "location");
+			const country = readStringParam(rawParams, "country");
 			const scrapeResults = rawParams.scrapeResults === true;
 			return jsonResult(await runFirecrawlSearch({
 				cfg: api.config,
@@ -99,6 +109,11 @@ function createFirecrawlSearchTool(api) {
 				timeoutSeconds,
 				sources,
 				categories,
+				includeDomains,
+				excludeDomains,
+				tbs,
+				location,
+				country,
 				scrapeResults
 			}));
 		}
@@ -113,6 +128,7 @@ var firecrawl_default = definePluginEntry({
 	register(api) {
 		api.registerWebFetchProvider(createFirecrawlWebFetchProvider());
 		api.registerWebSearchProvider(createFirecrawlWebSearchProvider());
+		api.registerWebSearchProvider(createFirecrawlFreeWebSearchProvider());
 		api.registerTool(createFirecrawlSearchTool(api));
 		api.registerTool(createFirecrawlScrapeTool(api));
 	}

package/dist/web-fetch-provider.js

@@ -1,2 +1,2 @@
-import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-CasPevAg.js";
+import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-D6Rj8lqo.js";
 export { createFirecrawlWebFetchProvider };

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

@@ -1,4 +1,4 @@
-import { buildFirecrawlWebSearchProviderBase } from "./web-search-shared.js";
+import { buildFirecrawlFreeWebSearchProviderBase, buildFirecrawlWebSearchProviderBase } from "./web-search-shared.js";
 //#region extensions/firecrawl/web-search-contract-api.ts
 function createFirecrawlWebSearchProvider() {
 	return {
@@ -6,5 +6,11 @@ function createFirecrawlWebSearchProvider() {
 		createTool: () => null
 	};
 }
+function createFirecrawlFreeWebSearchProvider() {
+	return {
+		...buildFirecrawlFreeWebSearchProviderBase(),
+		createTool: () => null
+	};
+}
 //#endregion
-export { createFirecrawlWebSearchProvider };
+export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/dist/web-search-provider.js

@@ -1,2 +1,2 @@
-import { t as createFirecrawlWebSearchProvider } from "./firecrawl-search-provider-C_iN9LEC.js";
-export { createFirecrawlWebSearchProvider };
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-E4DXHcwh.js";
+export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/dist/web-search-shared.js

@@ -51,5 +51,27 @@ function buildFirecrawlWebSearchProviderBase() {
 		getConfiguredCredentialFallback: getConfiguredFirecrawlFetchCredentialFallback
 	};
 }
+function buildFirecrawlFreeWebSearchProviderBase() {
+	return {
+		id: "firecrawl-free",
+		label: "Firecrawl Search (Free)",
+		hint: "Free web search via Firecrawl's hosted starter tier — no API key required",
+		onboardingScopes: ["text-inference"],
+		requiresCredential: false,
+		envVars: [],
+		placeholder: "(no key needed)",
+		signupUrl: "https://www.firecrawl.dev/",
+		docsUrl: "https://docs.openclaw.ai/tools/firecrawl",
+		credentialPath: "",
+		...createWebSearchProviderContractFields({
+			credentialPath: "",
+			searchCredential: {
+				type: "scoped",
+				scopeId: "firecrawl-free"
+			},
+			selectionPluginId: "firecrawl"
+		})
+	};
+}
 //#endregion
-export { buildFirecrawlWebSearchProviderBase };
+export { buildFirecrawlFreeWebSearchProviderBase, buildFirecrawlWebSearchProviderBase };

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/firecrawl-plugin",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/firecrawl-plugin",
-      "version": "2026.7.1",
+      "version": "2026.7.2-beta.1",
       "dependencies": {
         "typebox": "1.3.3"
       }

package/openclaw.plugin.json

@@ -35,7 +35,7 @@
   },
   "contracts": {
     "webFetchProviders": ["firecrawl"],
-    "webSearchProviders": ["firecrawl"],
+    "webSearchProviders": ["firecrawl", "firecrawl-free"],
     "tools": ["firecrawl_search", "firecrawl_scrape"]
   },
   "configContracts": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/firecrawl-plugin",
-  "version": "2026.7.1",
+  "version": "2026.7.2-beta.1",
   "description": "OpenClaw Firecrawl plugin.",
   "repository": {
     "type": "git",
@@ -21,10 +21,10 @@
       "minHostVersion": ">=2026.6.8"
     },
     "compat": {
-      "pluginApi": ">=2026.7.1"
+      "pluginApi": ">=2026.7.2-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.7.1",
+      "openclawVersion": "2026.7.2-beta.1",
       "bundledDist": false
     },
     "release": {
@@ -42,7 +42,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.1"
+    "openclaw": ">=2026.7.2-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/firecrawl-search-provider-C_iN9LEC.js

@@ -1,43 +0,0 @@
-import { buildFirecrawlWebSearchProviderBase } from "./web-search-shared.js";
-import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
-import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
-//#region extensions/firecrawl/src/firecrawl-search-provider.ts
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-xZqyVUBg.js").then((n) => n.t));
-const GenericFirecrawlSearchSchema = {
-	type: "object",
-	properties: {
-		query: {
-			type: "string",
-			description: "Search query string."
-		},
-		count: {
-			type: "integer",
-			description: "Number of results to return (1-10).",
-			minimum: 1,
-			maximum: 10
-		}
-	},
-	additionalProperties: false
-};
-function createFirecrawlWebSearchProvider() {
-	return {
-		...buildFirecrawlWebSearchProviderBase(),
-		createTool: (ctx) => ({
-			description: "Search the web using Firecrawl. Returns structured results with snippets from Firecrawl Search. Use firecrawl_search for Firecrawl-specific knobs like sources or categories.",
-			parameters: GenericFirecrawlSearchSchema,
-			execute: async (args) => {
-				const { runFirecrawlSearch } = await loadFirecrawlClientModule();
-				return await runFirecrawlSearch({
-					cfg: ctx.config,
-					query: typeof args.query === "string" ? args.query : "",
-					count: readPositiveIntegerParam(args, "count", {
-						message: "count must be an integer from 1 to 10",
-						max: 10
-					})
-				});
-			}
-		})
-	};
-}
-//#endregion
-export { createFirecrawlWebSearchProvider as t };