firecrawl-cli 0.0.1

package/README.md

@@ -0,0 +1,27 @@
+# 🔥 Firecrawl CLI
+
+Command-line interface for Firecrawl. Scrape, crawl, and extract data from any website directly from your terminal.
+
+## Installation
+
+Install Firecrawl CLI globally using npm:
+
+```bash
+npm install -g firecrawl-cli
+```
+
+## Quick Start
+
+Set your API key:
+
+```bash
+firecrawl config
+```
+
+Scrape a URL:
+
+```bash
+firecrawl https://firecrawl.dev
+```
+
+For detailed usage instructions, examples, and all available commands, visit the [CLI documentation](https://docs.firecrawl.dev/cli).

package/dist/commands/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Config command implementation
+ * Manages stored credentials and configuration
+ */
+/**
+ * Interactive configuration setup
+ * Asks for API URL and API key
+ */
+export declare function configure(): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2C/C"}

package/dist/commands/config.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Config command implementation
+ * Manages stored credentials and configuration
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure = configure;
+const readline = __importStar(require("readline"));
+const credentials_1 = require("../utils/credentials");
+const config_1 = require("../utils/config");
+const DEFAULT_API_URL = 'https://api.firecrawl.dev';
+/**
+ * Prompt for input (for secure API key entry)
+ */
+function promptInput(question, defaultValue) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const promptText = defaultValue ? `${question} [${defaultValue}]: ` : `${question} `;
+    return new Promise((resolve) => {
+        rl.question(promptText, (answer) => {
+            rl.close();
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+/**
+ * Interactive configuration setup
+ * Asks for API URL and API key
+ */
+async function configure() {
+    console.log('Firecrawl Configuration Setup\n');
+    // Prompt for API URL with default
+    let url = await promptInput('Enter API URL', DEFAULT_API_URL);
+    // Ensure URL doesn't end with trailing slash
+    url = url.replace(/\/$/, '');
+    // Prompt for API key
+    const key = await promptInput('Enter your Firecrawl API key: ');
+    if (!key || key.trim().length === 0) {
+        console.error('Error: API key cannot be empty');
+        process.exit(1);
+    }
+    if (!url || url.trim().length === 0) {
+        console.error('Error: API URL cannot be empty');
+        process.exit(1);
+    }
+    // Normalize URL (remove trailing slash)
+    const normalizedUrl = url.trim().replace(/\/$/, '');
+    try {
+        (0, credentials_1.saveCredentials)({
+            apiKey: key.trim(),
+            apiUrl: normalizedUrl
+        });
+        console.log('\n✓ Configuration saved successfully');
+        console.log(`  API URL: ${normalizedUrl}`);
+        console.log(`  Stored in: ${(0, credentials_1.getConfigDirectoryPath)()}`);
+        // Update global config
+        (0, config_1.updateConfig)({
+            apiKey: key.trim(),
+            apiUrl: normalizedUrl
+        });
+    }
+    catch (error) {
+        console.error('Error saving configuration:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BH,8BA2CC;AAxED,mDAAqC;AACrC,sDAA+E;AAC/E,4CAA+C;AAE/C,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAEpD;;GAEG;AACH,SAAS,WAAW,CAAC,QAAgB,EAAE,YAAqB;IAC1D,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;IAErF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YACjC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,SAAS;IAC7B,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE/C,kCAAkC;IAClC,IAAI,GAAG,GAAG,MAAM,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAE9D,6CAA6C;IAC7C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE7B,qBAAqB;IACrB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,gCAAgC,CAAC,CAAC;IAEhE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,wCAAwC;IACxC,MAAM,aAAa,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,IAAA,6BAAe,EAAC;YACd,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE;YAClB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAA,oCAAsB,GAAE,EAAE,CAAC,CAAC;QAExD,uBAAuB;QACvB,IAAA,qBAAY,EAAC;YACX,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE;YAClB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACvG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/scrape.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scrape command implementation
+ */
+import type { ScrapeOptions, ScrapeResult } from '../types/scrape';
+/**
+ * Execute the scrape command
+ */
+export declare function executeScrape(options: ScrapeOptions): Promise<ScrapeResult>;
+/**
+ * Handle scrape command output
+ */
+export declare function handleScrapeCommand(options: ScrapeOptions): Promise<void>;
+//# sourceMappingURL=scrape.d.ts.map

package/dist/commands/scrape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/commands/scrape.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKnE;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoEjF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E"}

package/dist/commands/scrape.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Scrape command implementation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeScrape = executeScrape;
+exports.handleScrapeCommand = handleScrapeCommand;
+const client_1 = require("../utils/client");
+const config_1 = require("../utils/config");
+const output_1 = require("../utils/output");
+/**
+ * Execute the scrape command
+ */
+async function executeScrape(options) {
+    try {
+        // Update global config if API key is provided via options
+        if (options.apiKey) {
+            (0, config_1.updateConfig)({ apiKey: options.apiKey });
+        }
+        // Get client instance (uses global config)
+        const app = (0, client_1.getClient)();
+        // Build scrape options
+        const formats = [];
+        if (options.format) {
+            formats.push(options.format);
+        }
+        if (options.screenshot) {
+            // Add screenshot format if not already included
+            if (!formats.includes('screenshot')) {
+                formats.push('screenshot');
+            }
+        }
+        // If no formats specified, default to markdown
+        if (formats.length === 0) {
+            formats.push('markdown');
+        }
+        const scrapeParams = {
+            formats,
+        };
+        if (options.onlyMainContent !== undefined) {
+            scrapeParams.onlyMainContent = options.onlyMainContent;
+        }
+        if (options.waitFor !== undefined) {
+            scrapeParams.waitFor = options.waitFor;
+        }
+        if (options.includeTags && options.includeTags.length > 0) {
+            scrapeParams.includeTags = options.includeTags;
+        }
+        if (options.excludeTags && options.excludeTags.length > 0) {
+            scrapeParams.excludeTags = options.excludeTags;
+        }
+        // Execute scrape
+        const result = await app.scrape(options.url, scrapeParams);
+        return {
+            success: true,
+            data: result,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error occurred',
+        };
+    }
+}
+/**
+ * Handle scrape command output
+ */
+async function handleScrapeCommand(options) {
+    const result = await executeScrape(options);
+    (0, output_1.handleScrapeOutput)(result, options.format, options.output, options.pretty);
+}
+//# sourceMappingURL=scrape.js.map

package/dist/commands/scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/commands/scrape.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,sCAoEC;AAKD,kDAGC;AAnFD,4CAA4C;AAC5C,4CAA+C;AAC/C,4CAAqD;AAErD;;GAEG;AACI,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,IAAI,CAAC;QACH,0DAA0D;QAC1D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAA,qBAAY,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,2CAA2C;QAC3C,MAAM,GAAG,GAAG,IAAA,kBAAS,GAAE,CAAC;QAExB,uBAAuB;QACvB,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,gDAAgD;YAChD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,+CAA+C;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,YAAY,GAMd;YACF,OAAO;SACR,CAAC;QAEF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC1C,YAAY,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QACzD,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,YAAY,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACjD,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,YAAY,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACjD,CAAC;QAED,iBAAiB;QACjB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;SACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB,CAAC,OAAsB;IAC9D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAA,2BAAkB,EAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Firecrawl CLI
+ * Entry point for the CLI application
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Firecrawl CLI
+ * Entry point for the CLI application
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const scrape_1 = require("./commands/scrape");
+const config_1 = require("./utils/config");
+const config_2 = require("./commands/config");
+const url_1 = require("./utils/url");
+const options_1 = require("./utils/options");
+// Initialize global configuration from environment variables
+(0, config_1.initializeConfig)();
+const program = new commander_1.Command();
+program
+    .name('firecrawl')
+    .description('CLI tool for Firecrawl web scraping')
+    .version('1.0.0')
+    .option('-k, --api-key <key>', 'Firecrawl API key (or set FIRECRAWL_API_KEY env var, or use "firecrawl config")')
+    .allowUnknownOption() // Allow unknown options when URL is passed directly
+    .hook('preAction', (thisCommand, actionCommand) => {
+    // Update global config if API key is provided via global option
+    const globalOptions = thisCommand.opts();
+    if (globalOptions.apiKey) {
+        (0, config_1.updateConfig)({ apiKey: globalOptions.apiKey });
+    }
+});
+/**
+ * Create and configure the scrape command
+ */
+function createScrapeCommand() {
+    const scrapeCmd = new commander_1.Command('scrape')
+        .description('Scrape a URL using Firecrawl')
+        .argument('[url]', 'URL to scrape')
+        .option('-u, --url <url>', 'URL to scrape (alternative to positional argument)')
+        .option('-H, --html', 'Output raw HTML (shortcut for --format html)')
+        .option('-f, --format <format>', 'Output format: markdown, html, rawHtml, links, images, screenshot, summary, changeTracking, json, attributes, branding', 'markdown')
+        .option('--only-main-content', 'Include only main content', false)
+        .option('--wait-for <ms>', 'Wait time before scraping in milliseconds', parseInt)
+        .option('--screenshot', 'Take a screenshot', false)
+        .option('--include-tags <tags>', 'Comma-separated list of tags to include')
+        .option('--exclude-tags <tags>', 'Comma-separated list of tags to exclude')
+        .option('-k, --api-key <key>', 'Firecrawl API key (overrides global --api-key)')
+        .option('-o, --output <path>', 'Output file path (default: stdout)')
+        .option('--pretty', 'Pretty print JSON output', false)
+        .action(async (positionalUrl, options) => {
+        // Use positional URL if provided, otherwise use --url option
+        const url = positionalUrl || options.url;
+        if (!url) {
+            console.error('Error: URL is required. Provide it as argument or use --url option.');
+            process.exit(1);
+        }
+        // Handle --html shortcut flag
+        const format = options.html ? 'html' : options.format;
+        const scrapeOptions = (0, options_1.parseScrapeOptions)({ ...options, url, format });
+        await (0, scrape_1.handleScrapeCommand)(scrapeOptions);
+    });
+    return scrapeCmd;
+}
+// Add scrape command to main program
+program.addCommand(createScrapeCommand());
+program
+    .command('config')
+    .description('Configure API URL and API key (interactive)')
+    .action(async () => {
+    await (0, config_2.configure)();
+});
+// Parse arguments
+const args = process.argv.slice(2);
+// Check if first argument is a URL (and not a command)
+if (args.length > 0 && !args[0].startsWith('-') && (0, url_1.isUrl)(args[0])) {
+    // Treat as scrape command with URL - reuse commander's parsing
+    const url = (0, url_1.normalizeUrl)(args[0]);
+    // Modify argv to include scrape command with URL as positional argument
+    // This allows commander to parse it normally with all hooks and options
+    const modifiedArgv = [process.argv[0], process.argv[1], 'scrape', url, ...args.slice(1)];
+    // Parse using the main program (which includes hooks and global options)
+    program.parseAsync(modifiedArgv).catch((error) => {
+        console.error('Error:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    });
+}
+else {
+    // Normal command parsing
+    program.parse();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types/scrape.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Types and interfaces for the scrape command
+ */
+export type ScrapeFormat = 'markdown' | 'html' | 'rawHtml' | 'links' | 'images' | 'screenshot' | 'summary' | 'changeTracking' | 'json' | 'attributes' | 'branding';
+export interface ScrapeOptions {
+    /** URL to scrape */
+    url: string;
+    /** Output format (markdown, html, etc.) */
+    format?: ScrapeFormat;
+    /** Include only main content */
+    onlyMainContent?: boolean;
+    /** Wait time before scraping (ms) */
+    waitFor?: number;
+    /** Take screenshot */
+    screenshot?: boolean;
+    /** Include tags */
+    includeTags?: string[];
+    /** Exclude tags */
+    excludeTags?: string[];
+    /** API key for Firecrawl */
+    apiKey?: string;
+    /** Output file path */
+    output?: string;
+    /** Pretty print JSON output */
+    pretty?: boolean;
+}
+export interface ScrapeResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+//# sourceMappingURL=scrape.d.ts.map

package/dist/types/scrape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/types/scrape.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,MAAM,GACN,SAAS,GACT,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,gBAAgB,GAChB,MAAM,GACN,YAAY,GACZ,UAAU,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/scrape.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types and interfaces for the scrape command
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=scrape.js.map

package/dist/types/scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/types/scrape.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Firecrawl client utility
+ * Provides a singleton client instance initialized with global configuration
+ */
+import Firecrawl from '@mendable/firecrawl-js';
+import type { FirecrawlClientOptions } from '@mendable/firecrawl-js';
+import { type GlobalConfig } from './config';
+/**
+ * Get or create the Firecrawl client instance
+ * Uses global configuration if available, otherwise creates with provided options
+ */
+export declare function getClient(options?: Partial<FirecrawlClientOptions>): Firecrawl;
+/**
+ * Initialize the client with configuration
+ * This should be called early in the application lifecycle
+ */
+export declare function initializeClient(config?: Partial<GlobalConfig>): Firecrawl;
+/**
+ * Reset the client instance (useful for testing)
+ */
+export declare function resetClient(): void;
+//# sourceMappingURL=client.d.ts.map

package/dist/utils/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,wBAAwB,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,SAAS,CA2C9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAS1E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/utils/client.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Firecrawl client utility
+ * Provides a singleton client instance initialized with global configuration
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClient = getClient;
+exports.initializeClient = initializeClient;
+exports.resetClient = resetClient;
+const firecrawl_js_1 = __importDefault(require("@mendable/firecrawl-js"));
+const config_1 = require("./config");
+let clientInstance = null;
+/**
+ * Get or create the Firecrawl client instance
+ * Uses global configuration if available, otherwise creates with provided options
+ */
+function getClient(options) {
+    // Helper to convert null to undefined and ensure we have a string or undefined
+    const normalizeApiKey = (value) => value === null || value === undefined ? undefined : value;
+    // If options provided, create a new instance (useful for command-specific overrides)
+    if (options) {
+        const config = (0, config_1.getConfig)();
+        const apiKey = normalizeApiKey(options.apiKey) ?? config.apiKey;
+        const apiUrl = normalizeApiKey(options.apiUrl) ?? config.apiUrl;
+        // Normalize apiKey for validation (convert null to undefined)
+        const normalizedApiKey = apiKey === null ? undefined : apiKey;
+        (0, config_1.validateConfig)(normalizedApiKey);
+        const clientOptions = {
+            apiKey: normalizedApiKey || undefined,
+            apiUrl: apiUrl === null ? undefined : apiUrl,
+            timeoutMs: options.timeoutMs ?? config.timeoutMs,
+            maxRetries: options.maxRetries ?? config.maxRetries,
+            backoffFactor: options.backoffFactor ?? config.backoffFactor,
+        };
+        return new firecrawl_js_1.default(clientOptions);
+    }
+    // Return singleton instance or create one
+    if (!clientInstance) {
+        const config = (0, config_1.getConfig)();
+        (0, config_1.validateConfig)(config.apiKey);
+        const clientOptions = {
+            apiKey: config.apiKey || undefined,
+            apiUrl: config.apiUrl || undefined,
+            timeoutMs: config.timeoutMs,
+            maxRetries: config.maxRetries,
+            backoffFactor: config.backoffFactor,
+        };
+        clientInstance = new firecrawl_js_1.default(clientOptions);
+    }
+    return clientInstance;
+}
+/**
+ * Initialize the client with configuration
+ * This should be called early in the application lifecycle
+ */
+function initializeClient(config) {
+    if (config) {
+        const { initializeConfig } = require('./config');
+        initializeConfig(config);
+    }
+    // Reset instance to force recreation with new config
+    clientInstance = null;
+    return getClient();
+}
+/**
+ * Reset the client instance (useful for testing)
+ */
+function resetClient() {
+    clientInstance = null;
+}
+//# sourceMappingURL=client.js.map

package/dist/utils/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAYH,8BA2CC;AAMD,4CASC;AAKD,kCAEC;AA3ED,0EAA+C;AAE/C,qCAAwE;AAExE,IAAI,cAAc,GAAqB,IAAI,CAAC;AAE5C;;;GAGG;AACH,SAAgB,SAAS,CAAC,OAAyC;IACjE,+EAA+E;IAC/E,MAAM,eAAe,GAAG,CAAC,KAAgC,EAAsB,EAAE,CAC/E,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAE5D,qFAAqF;IACrF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC;QAChE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC;QAEhE,8DAA8D;QAC9D,MAAM,gBAAgB,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9D,IAAA,uBAAc,EAAC,gBAAgB,CAAC,CAAC;QAEjC,MAAM,aAAa,GAA2B;YAC5C,MAAM,EAAE,gBAAgB,IAAI,SAAS;YACrC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC5C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS;YAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;YACnD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa;SAC7D,CAAC;QAEF,OAAO,IAAI,sBAAS,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;QAC3B,IAAA,uBAAc,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9B,MAAM,aAAa,GAA2B;YAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;QAEF,cAAc,GAAG,IAAI,sBAAS,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,MAA8B;IAC7D,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACjD,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,qDAAqD;IACrD,cAAc,GAAG,IAAI,CAAC;IACtB,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Global configuration system
+ */
+export interface GlobalConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    backoffFactor?: number;
+}
+/**
+ * Initialize global configuration
+ * Loads from: provided config > environment variables > OS credential storage
+ * @param config Configuration options
+ */
+export declare function initializeConfig(config?: Partial<GlobalConfig>): void;
+/**
+ * Get the current global configuration
+ */
+export declare function getConfig(): GlobalConfig;
+/**
+ * Update global configuration (merges with existing)
+ */
+export declare function updateConfig(config: Partial<GlobalConfig>): void;
+/**
+ * Get API key from global config or provided value
+ * Priority: provided key > global config > env var > stored credentials
+ */
+export declare function getApiKey(providedKey?: string): string | undefined;
+/**
+ * Validate that required configuration is present
+ */
+export declare function validateConfig(apiKey?: string): void;
+/**
+ * Reset global configuration (useful for testing)
+ */
+export declare function resetConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,IAAI,CAWzE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAExC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAKhE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAOpD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/utils/config.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Global configuration system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeConfig = initializeConfig;
+exports.getConfig = getConfig;
+exports.updateConfig = updateConfig;
+exports.getApiKey = getApiKey;
+exports.validateConfig = validateConfig;
+exports.resetConfig = resetConfig;
+const credentials_1 = require("./credentials");
+/**
+ * Global configuration instance
+ */
+let globalConfig = {};
+/**
+ * Initialize global configuration
+ * Loads from: provided config > environment variables > OS credential storage
+ * @param config Configuration options
+ */
+function initializeConfig(config = {}) {
+    // Priority: provided config > env vars > stored credentials
+    const storedCredentials = (0, credentials_1.loadCredentials)();
+    globalConfig = {
+        apiKey: config.apiKey || process.env.FIRECRAWL_API_KEY || storedCredentials?.apiKey,
+        apiUrl: config.apiUrl || process.env.FIRECRAWL_API_URL || storedCredentials?.apiUrl,
+        timeoutMs: config.timeoutMs,
+        maxRetries: config.maxRetries,
+        backoffFactor: config.backoffFactor,
+    };
+}
+/**
+ * Get the current global configuration
+ */
+function getConfig() {
+    return { ...globalConfig };
+}
+/**
+ * Update global configuration (merges with existing)
+ */
+function updateConfig(config) {
+    globalConfig = {
+        ...globalConfig,
+        ...config,
+    };
+}
+/**
+ * Get API key from global config or provided value
+ * Priority: provided key > global config > env var > stored credentials
+ */
+function getApiKey(providedKey) {
+    if (providedKey)
+        return providedKey;
+    if (globalConfig.apiKey)
+        return globalConfig.apiKey;
+    if (process.env.FIRECRAWL_API_KEY)
+        return process.env.FIRECRAWL_API_KEY;
+    // Fallback to stored credentials if not already loaded
+    const storedCredentials = (0, credentials_1.loadCredentials)();
+    return storedCredentials?.apiKey;
+}
+/**
+ * Validate that required configuration is present
+ */
+function validateConfig(apiKey) {
+    const key = getApiKey(apiKey);
+    if (!key) {
+        throw new Error('API key is required. Set FIRECRAWL_API_KEY environment variable, use --api-key flag, run "firecrawl config set-api-key", or initialize config.');
+    }
+}
+/**
+ * Reset global configuration (useful for testing)
+ */
+function resetConfig() {
+    globalConfig = {};
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAsBH,4CAWC;AAKD,8BAEC;AAKD,oCAKC;AAMD,8BAQC;AAKD,wCAOC;AAKD,kCAEC;AAjFD,+CAAgD;AAUhD;;GAEG;AACH,IAAI,YAAY,GAAiB,EAAE,CAAC;AAEpC;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,SAAgC,EAAE;IACjE,4DAA4D;IAC5D,MAAM,iBAAiB,GAAG,IAAA,6BAAe,GAAE,CAAC;IAE5C,YAAY,GAAG;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,EAAE,MAAM;QACnF,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,EAAE,MAAM;QACnF,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,MAA6B;IACxD,YAAY,GAAG;QACb,GAAG,YAAY;QACf,GAAG,MAAM;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,WAAoB;IAC5C,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,YAAY,CAAC,MAAM;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC;IACpD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAExE,uDAAuD;IACvD,MAAM,iBAAiB,GAAG,IAAA,6BAAe,GAAE,CAAC;IAC5C,OAAO,iBAAiB,EAAE,MAAM,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAe;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,gJAAgJ,CACjJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,YAAY,GAAG,EAAE,CAAC;AACpB,CAAC"}

package/dist/utils/credentials.d.ts

@@ -0,0 +1,25 @@
+/**
+ * OS-level credential storage utility
+ * Stores credentials in platform-specific application data directories
+ */
+export interface StoredCredentials {
+    apiKey?: string;
+    apiUrl?: string;
+}
+/**
+ * Load credentials from OS storage
+ */
+export declare function loadCredentials(): StoredCredentials | null;
+/**
+ * Save credentials to OS storage
+ */
+export declare function saveCredentials(credentials: StoredCredentials): void;
+/**
+ * Delete stored credentials
+ */
+export declare function deleteCredentials(): void;
+/**
+ * Get the config directory path (for informational purposes)
+ */
+export declare function getConfigDirectoryPath(): string;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/utils/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+CD;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,GAAG,IAAI,CAc1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAwBpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CASxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/utils/credentials.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * OS-level credential storage utility
+ * Stores credentials in platform-specific application data directories
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCredentials = loadCredentials;
+exports.saveCredentials = saveCredentials;
+exports.deleteCredentials = deleteCredentials;
+exports.getConfigDirectoryPath = getConfigDirectoryPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Get the platform-specific config directory
+ */
+function getConfigDir() {
+    const homeDir = os.homedir();
+    const platform = os.platform();
+    switch (platform) {
+        case 'darwin': // macOS
+            return path.join(homeDir, 'Library', 'Application Support', 'firecrawl-cli');
+        case 'win32': // Windows
+            return path.join(homeDir, 'AppData', 'Roaming', 'firecrawl-cli');
+        default: // Linux and others
+            return path.join(homeDir, '.config', 'firecrawl-cli');
+    }
+}
+/**
+ * Get the credentials file path
+ */
+function getCredentialsPath() {
+    return path.join(getConfigDir(), 'credentials.json');
+}
+/**
+ * Ensure the config directory exists
+ */
+function ensureConfigDir() {
+    const configDir = getConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true, mode: 0o700 }); // rwx------
+    }
+}
+/**
+ * Set file permissions to be readable/writable only by the owner
+ */
+function setSecurePermissions(filePath) {
+    try {
+        fs.chmodSync(filePath, 0o600); // rw-------
+    }
+    catch (error) {
+        // Ignore errors on Windows or if file doesn't exist
+    }
+}
+/**
+ * Load credentials from OS storage
+ */
+function loadCredentials() {
+    try {
+        const credentialsPath = getCredentialsPath();
+        if (!fs.existsSync(credentialsPath)) {
+            return null;
+        }
+        const data = fs.readFileSync(credentialsPath, 'utf-8');
+        const credentials = JSON.parse(data);
+        return credentials;
+    }
+    catch (error) {
+        // If file is corrupted or unreadable, return null
+        return null;
+    }
+}
+/**
+ * Save credentials to OS storage
+ */
+function saveCredentials(credentials) {
+    try {
+        ensureConfigDir();
+        const credentialsPath = getCredentialsPath();
+        // Read existing credentials and merge
+        const existing = loadCredentials();
+        const merged = {
+            ...existing,
+            ...credentials,
+        };
+        // Write to file
+        fs.writeFileSync(credentialsPath, JSON.stringify(merged, null, 2), 'utf-8');
+        // Set secure permissions
+        setSecurePermissions(credentialsPath);
+    }
+    catch (error) {
+        throw new Error(`Failed to save credentials: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Delete stored credentials
+ */
+function deleteCredentials() {
+    try {
+        const credentialsPath = getCredentialsPath();
+        if (fs.existsSync(credentialsPath)) {
+            fs.unlinkSync(credentialsPath);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to delete credentials: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Get the config directory path (for informational purposes)
+ */
+function getConfigDirectoryPath() {
+    return getConfigDir();
+}
+//# sourceMappingURL=credentials.js.map

package/dist/utils/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"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"}

package/dist/utils/options.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Option parsing utilities
+ */
+import type { ScrapeOptions } from '../types/scrape';
+/**
+ * Convert commander options to ScrapeOptions
+ */
+export declare function parseScrapeOptions(options: any): ScrapeOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/utils/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/utils/options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,aAAa,CAa9D"}

package/dist/utils/options.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Option parsing utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseScrapeOptions = parseScrapeOptions;
+/**
+ * Convert commander options to ScrapeOptions
+ */
+function parseScrapeOptions(options) {
+    return {
+        url: options.url,
+        format: options.format,
+        onlyMainContent: options.onlyMainContent,
+        waitFor: options.waitFor,
+        screenshot: options.screenshot,
+        includeTags: options.includeTags ? options.includeTags.split(',').map((t) => t.trim()) : undefined,
+        excludeTags: options.excludeTags ? options.excludeTags.split(',').map((t) => t.trim()) : undefined,
+        apiKey: options.apiKey,
+        output: options.output,
+        pretty: options.pretty,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/utils/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/utils/options.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,gDAaC;AAhBD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAAY;IAC7C,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC1G,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC1G,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Output utilities for CLI
+ */
+import type { ScrapeResult } from '../types/scrape';
+import type { ScrapeFormat } from '../types/scrape';
+/**
+ * Write output to file or stdout
+ */
+export declare function writeOutput(content: string, outputPath?: string, silent?: boolean): void;
+/**
+ * Handle scrape result output
+ * For text formats (html, markdown, etc.), outputs raw content directly
+ * For complex formats, outputs JSON
+ */
+export declare function handleScrapeOutput(result: ScrapeResult, format?: ScrapeFormat, outputPath?: string, pretty?: boolean): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAiDpD;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,GAAE,OAAe,GACtB,IAAI,CAmBN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,GAAE,OAAe,GACtB,IAAI,CA0CN"}

package/dist/utils/output.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Output utilities for CLI
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeOutput = writeOutput;
+exports.handleScrapeOutput = handleScrapeOutput;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Extract content from Firecrawl Document based on format
+ */
+function extractContent(data, format) {
+    if (!data)
+        return null;
+    // If format is specified, try to extract that specific content
+    if (format) {
+        // Handle html/rawHtml formats - extract HTML content directly
+        if (format === 'html' || format === 'rawHtml') {
+            return data.html || data.rawHtml || data[format] || null;
+        }
+        // Handle markdown format
+        if (format === 'markdown') {
+            return data.markdown || data[format] || null;
+        }
+        // Handle links format
+        if (format === 'links') {
+            return data.links || data[format] || null;
+        }
+        // Handle images format
+        if (format === 'images') {
+            return data.images || data[format] || null;
+        }
+        // Handle summary format
+        if (format === 'summary') {
+            return data.summary || data[format] || null;
+        }
+    }
+    // Fallback: try common content fields
+    if (typeof data === 'string') {
+        return data;
+    }
+    // If it's an object, try to find string content
+    if (typeof data === 'object') {
+        return data.html || data.markdown || data.rawHtml || data.content || null;
+    }
+    return null;
+}
+/**
+ * Write output to file or stdout
+ */
+function writeOutput(content, outputPath, silent = false) {
+    if (outputPath) {
+        const dir = path.dirname(outputPath);
+        if (dir && !fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(outputPath, content, 'utf-8');
+        if (!silent) {
+            // Always use stderr for file confirmation messages
+            console.error(`Output written to: ${outputPath}`);
+        }
+    }
+    else {
+        // Use process.stdout.write for raw output (like curl)
+        // Ensure content ends with newline for proper piping
+        if (!content.endsWith('\n')) {
+            content += '\n';
+        }
+        process.stdout.write(content);
+    }
+}
+/**
+ * Handle scrape result output
+ * For text formats (html, markdown, etc.), outputs raw content directly
+ * For complex formats, outputs JSON
+ */
+function handleScrapeOutput(result, format, outputPath, pretty = false) {
+    if (!result.success) {
+        // Always use stderr for errors to allow piping
+        console.error('Error:', result.error);
+        process.exit(1);
+    }
+    if (!result.data) {
+        return;
+    }
+    // Text formats that should output raw content (curl-like)
+    const rawTextFormats = ['html', 'rawHtml', 'markdown', 'links', 'images', 'summary'];
+    const shouldOutputRaw = format && rawTextFormats.includes(format);
+    if (shouldOutputRaw) {
+        // Extract and output raw content
+        const content = extractContent(result.data, format);
+        if (content !== null) {
+            writeOutput(content, outputPath, !!outputPath);
+            return;
+        }
+    }
+    // For JSON format or complex formats (branding, json, etc.), output clean JSON
+    // Always stringify the entire data object to ensure valid JSON
+    let jsonContent;
+    try {
+        jsonContent = pretty
+            ? JSON.stringify(result.data, null, 2)
+            : JSON.stringify(result.data);
+    }
+    catch (error) {
+        // If stringification fails, try to create a minimal error response
+        jsonContent = JSON.stringify({
+            error: 'Failed to serialize response',
+            message: error instanceof Error ? error.message : 'Unknown error'
+        });
+    }
+    // Ensure clean JSON output (no extra newlines or text before JSON)
+    // Output directly to stdout without any prefix
+    writeOutput(jsonContent, outputPath, !!outputPath);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"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"}

package/dist/utils/url.d.ts

@@ -0,0 +1,12 @@
+/**
+ * URL utility functions
+ */
+/**
+ * Check if a string looks like a URL (with or without protocol)
+ */
+export declare function isUrl(str: string): boolean;
+/**
+ * Normalize URL by adding https:// if missing
+ */
+export declare function normalizeUrl(url: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAoB1C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/utils/url.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * URL utility functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUrl = isUrl;
+exports.normalizeUrl = normalizeUrl;
+/**
+ * Check if a string looks like a URL (with or without protocol)
+ */
+function isUrl(str) {
+    // If it has a protocol, validate it
+    if (/^https?:\/\//i.test(str)) {
+        try {
+            const url = new URL(str);
+            return url.protocol === 'http:' || url.protocol === 'https:';
+        }
+        catch {
+            return true; // Assume valid if it starts with http:// or https://
+        }
+    }
+    // Check if it looks like a domain (has dots and valid characters)
+    // Exclude common commands and flags
+    if (str.includes('.') && !str.startsWith('-') && !str.includes(' ')) {
+        // Basic domain validation: contains at least one dot and valid characters
+        const domainPattern = /^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*\.[a-zA-Z]{2,}(\/.*)?$/;
+        return domainPattern.test(str);
+    }
+    return false;
+}
+/**
+ * Normalize URL by adding https:// if missing
+ */
+function normalizeUrl(url) {
+    if (/^https?:\/\//i.test(url)) {
+        return url;
+    }
+    return `https://${url}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,sBAoBC;AAKD,oCAKC;AAjCD;;GAEG;AACH,SAAgB,KAAK,CAAC,GAAW;IAC/B,oCAAoC;IACpC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,qDAAqD;QACpE,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,oCAAoC;IACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,0EAA0E;QAC1E,MAAM,aAAa,GAAG,oHAAoH,CAAC;QAC3I,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,WAAW,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "firecrawl-cli",
+  "version": "0.0.1",
+  "description": "Command-line interface for Firecrawl. Scrape, crawl, and extract data from any website directly from your terminal.",
+  "main": "dist/index.js",
+  "bin": {
+    "firecrawl": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "firecrawl",
+    "cli",
+    "web-scraping",
+    "crawler",
+    "scraper",
+    "data-extraction",
+    "llm",
+    "markdown"
+  ],
+  "author": "Firecrawl",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/firecrawl/firecrawl-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/firecrawl/firecrawl-cli/issues"
+  },
+  "homepage": "https://docs.firecrawl.dev/cli",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "packageManager": "pnpm@10.12.1",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@mendable/firecrawl-js": "^4.10.0",
+    "commander": "^14.0.2"
+  }
+}