firecrawl-cli 1.16.2 → 1.17.1

package/README.md

@@ -1,6 +1,6 @@
 # 🔥 Firecrawl CLI
 
-Command-line interface for Firecrawl. Search, scrape, and interact with the web directly from your terminal.
+Command-line interface for Firecrawl. Search, scrape, interact, crawl, map, and run agent jobs directly from your terminal.
 
 ## Installation
 
@@ -18,27 +18,30 @@ npx -y firecrawl-cli@1.16.2 init -y --browser
 - `--browser` opens the browser for Firecrawl authentication automatically
 - skills install globally to every detected AI coding agent by default
 
-### Setup Skills and MCP
+### Setup Skills, Workflows, and MCP
 
-If you are using an AI coding agent like Claude Code, you can also install the skill individually with:
+If you are using an AI coding agent like Claude Code, you can also install the skills manually:
 
 ```bash
 firecrawl setup skills
+firecrawl setup workflows
 ```
 
-This installs skills globally across all detected coding editors by default. Use `--agent <agent>` to scope it to one editor.
+These install globally across all detected coding editors by default. Use `--agent <agent>` to scope either command to one editor.
 
 ### Agent skills
 
-The init command installs both sets of Firecrawl agent skills into AI coding agents (Cursor, Claude Code, Windsurf, etc.):
+The init command installs all Firecrawl agent skill segments into AI coding agents (Cursor, Claude Code, Windsurf, etc.):
 
-- **CLI skills** — teach agents how to use the Firecrawl CLI for live web work (search, scrape, interact, map, crawl)
+- **CLI skills** — teach agents how to use the Firecrawl CLI for live web work (search, scrape, interact, map, crawl, agent)
 - **Build skills** — teach agents how to integrate Firecrawl into application code (choose endpoints, wire SDKs, set up API keys)
+- **Workflow skills** — teach agents how to produce Firecrawl-powered deliverables such as research briefs, SEO audits, QA reports, lead lists, knowledge bases, and design-system extraction
 
 To reinstall skills manually:
 
 ```bash
 firecrawl setup skills
+firecrawl setup workflows
 ```
 
 To install the Firecrawl MCP server into your editors (Cursor, Claude Code, VS Code, etc.):
@@ -700,42 +703,17 @@ firecrawl x download https://docs.firecrawl.dev --screenshot --limit 20 -y
 firecrawl x download https://docs.firecrawl.dev --include-paths "/features,/sdks" -y
 ```
 
-### AI Workflows
+### Workflow Skills
 
-Launch pre-built AI workflows that combine Firecrawl with your coding agent. One command spins up an interactive session with the right system prompt, tools, and instructions.
+The old experimental AI workflow commands have moved to the NPX-installable
+[`firecrawl/firecrawl-workflows`](https://github.com/firecrawl/firecrawl-workflows)
+skills package. Workflow skills infer from the user's request first and only ask
+short clarifying questions when required inputs are missing. Install them with:
 
 ```bash
-# Claude Code (available now)
-firecrawl x claude competitor-analysis https://firecrawl.dev
-firecrawl x claude deep-research "RAG pipeline data ingestion tools"
-firecrawl x claude lead-research "Vercel"
-firecrawl x claude seo-audit https://example.com
-firecrawl x claude qa https://myapp.com
-firecrawl x claude demo https://resend.com
-firecrawl x claude shop "best mechanical keyboard for developers"
-
-# Natural language (no workflow name)
-firecrawl x claude "scrape the firecrawl docs and summarize"
-
-# Codex and OpenCode -- coming soon
-firecrawl x codex competitor-analysis https://crawlee.dev
-firecrawl x opencode deep-research "browser automation frameworks"
+firecrawl setup workflows
 ```
 
-Add `-y` to auto-approve tool permissions.
-
-See the full documentation: **[Experimental Workflows ->](src/commands/experimental/README.md)**
-
-#### Prerequisites
-
-Each backend requires its CLI to be installed separately:
-
-| Backend  | Install                                               |
-| -------- | ----------------------------------------------------- |
-| Claude   | `npm install -g @anthropic-ai/claude-code`            |
-| Codex    | `npm install -g @openai/codex`                        |
-| OpenCode | [opencode.ai/docs/cli](https://opencode.ai/docs/cli/) |
-
 ---
 
 ## Documentation

package/dist/__tests__/commands/init.test.js

@@ -15,7 +15,7 @@ vitest_1.vi.mock('child_process', () => ({
     (0, vitest_1.afterEach)(() => {
         vitest_1.vi.restoreAllMocks();
     });
-    (0, vitest_1.it)('installs skills from both repos globally across all detected agents in non-interactive mode', async () => {
+    (0, vitest_1.it)('installs skills from all repos globally across all detected agents in non-interactive mode', async () => {
         await (0, init_1.handleInitCommand)({
             yes: true,
             skipInstall: true,
@@ -23,8 +23,9 @@ vitest_1.vi.mock('child_process', () => ({
         });
         (0, vitest_1.expect)(child_process_1.execSync).toHaveBeenCalledWith('npx -y skills add firecrawl/cli --full-depth --global --all --yes', vitest_1.expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] }));
         (0, vitest_1.expect)(child_process_1.execSync).toHaveBeenCalledWith('npx -y skills add firecrawl/skills --full-depth --global --all --yes', vitest_1.expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] }));
+        (0, vitest_1.expect)(child_process_1.execSync).toHaveBeenCalledWith('npx -y skills add firecrawl/firecrawl-workflows --full-depth --global --all --yes', vitest_1.expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] }));
     });
-    (0, vitest_1.it)('scopes non-interactive skills install to one agent across both repos when provided', async () => {
+    (0, vitest_1.it)('scopes non-interactive skills install to one agent across all repos when provided', async () => {
         await (0, init_1.handleInitCommand)({
             yes: true,
             skipInstall: true,
@@ -33,6 +34,7 @@ vitest_1.vi.mock('child_process', () => ({
         });
         (0, vitest_1.expect)(child_process_1.execSync).toHaveBeenCalledWith('npx -y skills add firecrawl/cli --full-depth --global --yes --agent cursor', vitest_1.expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] }));
         (0, vitest_1.expect)(child_process_1.execSync).toHaveBeenCalledWith('npx -y skills add firecrawl/skills --full-depth --global --yes --agent cursor', vitest_1.expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] }));
+        (0, vitest_1.expect)(child_process_1.execSync).toHaveBeenCalledWith('npx -y skills add firecrawl/firecrawl-workflows --full-depth --global --yes --agent cursor', vitest_1.expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'] }));
     });
 });
 //# sourceMappingURL=init.test.js.map

package/dist/__tests__/commands/init.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.test.js","sourceRoot":"","sources":["../../../src/__tests__/commands/init.test.ts"],"names":[],"mappings":";;AAAA,mCAAyE;AACzE,iDAAyC;AACzC,8CAAwD;AAExD,WAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,QAAQ,EAAE,WAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,WAAE,CAAC,aAAa,EAAE,CAAC;QACnB,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtD,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,WAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6FAA6F,EAAE,KAAK,IAAI,EAAE;QAC3G,MAAM,IAAA,wBAAiB,EAAC;YACtB,GAAG,EAAE,IAAI;YACT,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,mEAAmE,EACnE,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;QACF,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,sEAAsE,EACtE,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,MAAM,IAAA,wBAAiB,EAAC;YACtB,GAAG,EAAE,IAAI;YACT,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,4EAA4E,EAC5E,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;QACF,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,+EAA+E,EAC/E,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"init.test.js","sourceRoot":"","sources":["../../../src/__tests__/commands/init.test.ts"],"names":[],"mappings":";;AAAA,mCAAyE;AACzE,iDAAyC;AACzC,8CAAwD;AAExD,WAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,QAAQ,EAAE,WAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,WAAE,CAAC,aAAa,EAAE,CAAC;QACnB,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtD,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,WAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;QAC1G,MAAM,IAAA,wBAAiB,EAAC;YACtB,GAAG,EAAE,IAAI;YACT,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,mEAAmE,EACnE,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;QACF,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,sEAAsE,EACtE,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;QACF,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,mFAAmF,EACnF,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,MAAM,IAAA,wBAAiB,EAAC;YACtB,GAAG,EAAE,IAAI;YACT,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,4EAA4E,EAC5E,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;QACF,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,+EAA+E,EAC/E,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;QACF,IAAA,eAAM,EAAC,wBAAQ,CAAC,CAAC,oBAAoB,CACnC,4FAA4F,EAC5F,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}