{"record":{"id":"2af51c4910607ded","repo":"FlowiseAI/Flowise","slug":"firecrawl-url-is-required-for-crawl-mode","errorCode":null,"errorMessage":"Firecrawl: URL is required for crawl mode","messagePattern":"Firecrawl: URL is required for crawl mode","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/components/nodes/documentloaders/FireCrawl/FireCrawl.ts","lineNumber":608,"sourceCode":"                markdown: result.description,\n                metadata: {\n                    title: result.title,\n                    sourceURL: result.url,\n                    description: result.description\n                }\n            }))\n        } else if (this.mode === 'scrape') {\n            if (!this.url) {\n                throw new Error('Firecrawl: URL is required for scrape mode')\n            }\n            const response = await app.scrapeUrl(this.url, this.params)\n            if (!response.success) {\n                throw new Error(`Firecrawl: Failed to scrape URL. Error: ${response.error}`)\n            }\n            firecrawlDocs = [response.data as FirecrawlDocument]\n        } else if (this.mode === 'crawl') {\n            if (!this.url) {\n                throw new Error('Firecrawl: URL is required for crawl mode')\n            }\n            const response = await app.crawlUrl(this.url, this.params)\n            if ('status' in response) {\n                if (response.status === 'failed') {\n                    throw new Error('Firecrawl: Crawl job failed')\n                }\n                firecrawlDocs = response.data || []\n            } else {\n                if (!response.success) {\n                    throw new Error(`Firecrawl: Failed to scrape URL. Error: ${response.error}`)\n                }\n                firecrawlDocs = [response.data as FirecrawlDocument]\n            }\n        } else if (this.mode === 'extract') {\n            if (!this.url) {\n                throw new Error('Firecrawl: URL is required for extract mode')\n            }\n            this.params!.urls = [this.url]","sourceCodeStart":590,"sourceCodeEnd":626,"githubUrl":"https://github.com/FlowiseAI/Flowise/blob/abe4a8601a058047b350c260676826e21dd14101/packages/components/nodes/documentloaders/FireCrawl/FireCrawl.ts#L590-L626","documentation":"Thrown by FireCrawlLoader.load() in crawl mode when no URL was supplied. Crawl requires a seed URL to begin discovering pages.","triggerScenarios":"new FireCrawlLoader({ apiKey, mode: 'crawl', url: undefined }) then .load(). Same shape as [135] but for crawl mode.","commonSituations":"URL field blank in node UI; upstream node produced no URL; template variable unresolved.","solutions":["Provide a valid absolute URL as the crawl seed.","Validate the upstream URL value before constructing the loader.","Switch to search mode if only a query is available."],"exampleFix":"// before\nnew FireCrawlLoader({ apiKey, mode: 'crawl' }).load()\n\n// after\nconst url = (inputUrl || '').trim()\nif (!url) throw new Error('Crawl mode requires a seed URL')\nnew URL(url)\nnew FireCrawlLoader({ apiKey, mode: 'crawl', url }).load()","handlingStrategy":"validation","validationCode":"const url = (params.url ?? '').trim()\nif (!url) throw new Error('crawl mode requires a seed url')\nnew URL(url)\nnew FireCrawlLoader({ ...params, mode: 'crawl', url })","typeGuard":"function hasValidUrl(p: FirecrawlLoaderParameters): p is FirecrawlLoaderParameters & { url: string } {\n  if (typeof p.url !== 'string' || !p.url.trim()) return false\n  try { new URL(p.url); return true } catch { return false }\n}","tryCatchPattern":"try { await loader.load() }\ncatch (e) { if (/URL is required for crawl mode/.test((e as Error).message)) throw new Error('Provide a seed URL for the crawl node'); throw e }","preventionTips":["Validate URL upstream.","Bind the URL field to a non-empty source.","Switch to search mode if only a query is available."],"tags":["firecrawl","validation","crawl","loader","config"],"backgroundTag":null,"analyzedSha":"abe4a8601a058047b350c260676826e21dd14101","analyzedAt":"2026-08-12T16:04:40.823Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}