firecrawl-cli 1.9.7 → 1.10.0

package/dist/commands/experimental/workflows/competitive-intel.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Workflow: Competitive Intelligence
+ *
+ * Logs into competitor dashboards using saved browser profiles, clicks through
+ * pricing tiers, feature pages, and changelogs to detect plan changes.
+ * Designed for weekly monitoring runs with structured diff output.
+ */
+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.register = register;
+const backends_1 = require("../backends");
+const shared_1 = require("../shared");
+// ─── Input gathering ────────────────────────────────────────────────────────
+async function gatherInputs(prefill) {
+    if (prefill?.competitors) {
+        return {
+            competitors: prefill.competitors,
+            focus: 'all',
+            profile: '',
+            output: 'json',
+            context: '',
+        };
+    }
+    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
+    const competitors = await input({
+        message: 'Which competitors to monitor? (URLs or names, comma-separated)',
+        validate: (0, shared_1.validateRequired)('At least one competitor'),
+    });
+    const focus = await select({
+        message: 'What should the agent focus on?',
+        choices: [
+            { name: 'Everything (pricing, features, changelog)', value: 'all' },
+            { name: 'Pricing tiers & plan changes only', value: 'pricing' },
+            { name: 'Feature pages & product updates', value: 'features' },
+            { name: 'Blog / changelog / release notes', value: 'changelog' },
+        ],
+    });
+    const profile = await input({
+        message: 'Browser profile to use for auth? (leave blank for anonymous browsing)',
+        default: '',
+    });
+    const output = await select({
+        message: 'How should the report be delivered?',
+        choices: [
+            { name: 'Print to terminal', value: 'terminal' },
+            { name: 'Save as JSON (structured diffs)', value: 'json' },
+            { name: 'Save as Markdown file', value: 'markdown' },
+        ],
+    });
+    const context = await input({
+        message: 'Any other context? (e.g., "compare to our Pro plan", "focus on API limits")',
+        default: '',
+    });
+    return { competitors, focus, profile, output, context };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const focusInstructions = {
+        all: 'Extract pricing tiers (plan names, prices, feature lists, limits), product feature pages, and recent changelog/blog entries.',
+        pricing: 'Focus exclusively on pricing pages. Extract every plan name, price, billing period, feature list, and usage limit. Note any "Contact Sales" tiers.',
+        features: 'Focus on product/feature pages. Extract feature names, descriptions, availability per plan, and any recent additions or deprecations.',
+        changelog: 'Focus on blogs, changelogs, and release notes. Extract recent product updates, new features, breaking changes, and deprecation notices.',
+    };
+    const profileBlock = opts.profile
+        ? `\n### Browser Profile\n\nUse the saved browser profile \`${opts.profile}\` to access auth-gated pages:\n\`\`\`bash\nfirecrawl browser "open <url>" --profile ${opts.profile}\n\`\`\`\nAfter the first \`open\` with \`--profile\`, subsequent browser commands don't need the flag.`
+        : '';
+    const outputInstructions = {
+        terminal: 'Print the full intelligence report to the terminal in well-formatted markdown.',
+        json: `Save the report as structured JSON to \`competitive-intel.json\` in the current directory. Tell the user the file path when done.
+
+Use this schema:
+\`\`\`json
+{
+  "generatedAt": "ISO-8601",
+  "competitors": [
+    {
+      "name": "string",
+      "url": "string",
+      "pricing": {
+        "lastChecked": "ISO-8601",
+        "tiers": [{ "name": "string", "price": "string", "period": "string", "features": ["string"], "limits": {} }]
+      },
+      "recentChanges": [{ "date": "string", "type": "pricing | feature | deprecation", "summary": "string", "details": "string", "source": "url" }],
+      "features": [{ "name": "string", "description": "string", "availableOn": ["plan names"] }],
+      "sources": ["url"]
+    }
+  ]
+}
+\`\`\``,
+        markdown: 'Save the report to a file called `competitive-intel.md` in the current directory. Tell the user the file path when done.',
+    };
+    return `You are a competitive intelligence agent powered by Firecrawl. You use a real cloud browser to visit competitor sites, navigate dashboards, and extract pricing and feature data.
+
+## STEP 1: Launch Browser and Open Live View
+
+Before anything else, launch a browser session so the user can watch:
+
+\`\`\`bash
+firecrawl browser launch-session --json
+\`\`\`
+
+Extract the \`interactiveLiveViewUrl\` from the JSON output and open it (NOT the regular \`liveViewUrl\` -- the interactive one lets the user click and interact):
+
+\`\`\`bash
+open "<interactiveLiveViewUrl>"          # macOS
+xdg-open "<interactiveLiveViewUrl>"     # Linux
+\`\`\`
+
+If the \`open\` command fails, print the URL clearly so the user can copy-paste it.
+${profileBlock}
+
+## STEP 2: Visit Each Competitor
+
+For each competitor:
+
+1. Navigate to their main site
+2. Find and visit their **pricing page** -- click through every tier, toggle annual/monthly, expand feature comparison tables
+3. Find **feature/product pages** -- click into each feature, note capabilities and limits
+4. Find **changelog / blog / release notes** -- look for recent updates in the last 30 days
+5. Take snapshots at each step to extract data
+
+### Browser commands:
+\`\`\`bash
+firecrawl browser "open <url>"
+firecrawl browser "snapshot"
+firecrawl browser "click @<ref>"
+firecrawl browser "type @<ref> <text>"
+firecrawl browser "scroll down"
+firecrawl browser "scrape"
+\`\`\`
+
+You can also use \`firecrawl scrape <url>\` for quick page grabs when browser interaction isn't needed.
+
+## Focus
+
+${focusInstructions[opts.focus]}
+
+## Output Format
+
+${outputInstructions[opts.output]}
+
+Structure your report with:
+
+### Per-Competitor Breakdown
+- Company name & URL
+- Pricing tiers (plan name, price, billing period, key features, limits)
+- Recent changes detected (with dates and source URLs)
+- Feature inventory
+
+### Cross-Competitor Comparison
+- Pricing comparison table (plans side-by-side)
+- Feature matrix
+- Key differentiators
+
+### Alerts & Insights
+- Notable pricing changes or new tiers
+- Feature gaps or opportunities
+- Market positioning shifts
+
+### Sources
+- Every URL visited with what was found
+
+---
+
+Do everything sequentially -- visit one competitor at a time. Be thorough: click toggle switches, expand accordions, scroll to load lazy content. Extract real data, not summaries of page titles.
+
+Start immediately.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('competitive-intel')
+        .description('Monitor competitor pricing, features, and changes via browser')
+        .argument('[competitors...]', 'Competitor URLs or names')
+        .option('-y, --yes', 'Auto-approve all tool permissions')
+        .action(async (competitorParts, options) => {
+        const prefillCompetitors = competitorParts.length > 0 ? competitorParts.join(' ') : undefined;
+        const inputs = await gatherInputs(prefillCompetitors ? { competitors: prefillCompetitors } : undefined);
+        const parts = [`Monitor these competitors: ${inputs.competitors}`];
+        if (inputs.context)
+            parts.push(inputs.context);
+        const userMessage = parts.join('. ') + '.';
+        const skipPermissions = true;
+        console.log(`\nLaunching ${config.displayName}...\n`);
+        (0, backends_1.launchAgent)(backend, buildSystemPrompt({
+            focus: inputs.focus,
+            profile: inputs.profile,
+            output: inputs.output,
+        }), userMessage, skipPermissions);
+    });
+}
+//# sourceMappingURL=competitive-intel.js.map

package/dist/commands/experimental/workflows/competitive-intel.js.map

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

package/dist/commands/experimental/workflows/dashboard-reporting.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow: Dashboard Reporting
+ *
+ * Uses saved browser profiles to log into analytics platforms and internal
+ * tools, navigate dashboards, extract metrics, trigger exports, and compile
+ * cross-platform reports. Supports any login-gated web dashboard.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=dashboard-reporting.d.ts.map

package/dist/commands/experimental/workflows/dashboard-reporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-reporting.d.ts","sourceRoot":"","sources":["../../../../src/commands/experimental/workflows/dashboard-reporting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAyB,MAAM,aAAa,CAAC;AA6NlE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAuCnE"}

package/dist/commands/experimental/workflows/dashboard-reporting.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Workflow: Dashboard Reporting
+ *
+ * Uses saved browser profiles to log into analytics platforms and internal
+ * tools, navigate dashboards, extract metrics, trigger exports, and compile
+ * cross-platform reports. Supports any login-gated web dashboard.
+ */
+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.register = register;
+const backends_1 = require("../backends");
+const shared_1 = require("../shared");
+// ─── Input gathering ────────────────────────────────────────────────────────
+async function gatherInputs(prefill) {
+    if (prefill?.dashboards) {
+        return {
+            dashboards: prefill.dashboards,
+            profile: '',
+            metrics: '',
+            dateRange: 'last 7 days',
+            output: 'json',
+            context: '',
+        };
+    }
+    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
+    const dashboards = await input({
+        message: 'Which dashboards to pull from? (URLs, comma-separated -- e.g., "analytics.google.com, app.mixpanel.com")',
+        validate: (0, shared_1.validateRequired)('At least one dashboard URL'),
+    });
+    const profile = await input({
+        message: 'Browser profile for auth? (required for most dashboards)',
+        default: '',
+    });
+    const metrics = await input({
+        message: 'What metrics or data to extract? (leave blank for "everything visible")',
+        default: '',
+    });
+    const dateRange = await select({
+        message: 'Date range?',
+        choices: [
+            { name: 'Last 7 days', value: 'last 7 days' },
+            { name: 'Last 30 days', value: 'last 30 days' },
+            { name: 'Last 90 days', value: 'last 90 days' },
+            { name: 'Month to date', value: 'month to date' },
+            { name: 'Year to date', value: 'year to date' },
+            { name: 'Custom (specify in context)', value: 'custom' },
+        ],
+    });
+    const output = await select({
+        message: 'Output format?',
+        choices: [
+            { name: 'JSON (structured metrics)', value: 'json' },
+            { name: 'Markdown report', value: 'markdown' },
+            { name: 'Print to terminal', value: 'terminal' },
+        ],
+    });
+    const context = await input({
+        message: 'Any other instructions? (e.g., "compare to previous period", "focus on conversion funnel")',
+        default: '',
+    });
+    return { dashboards, profile, metrics, dateRange, output, context };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const profileBlock = opts.profile
+        ? `\n### Authentication\n\nUse the saved browser profile \`${opts.profile}\` to access dashboards:\n\`\`\`bash\nfirecrawl browser "open <url>" --profile ${opts.profile}\n\`\`\`\nAfter the first \`open\` with \`--profile\`, subsequent browser commands don't need the flag.\n\nIf you encounter a login page, use the profile's saved cookies/session. If those have expired, tell the user and ask them to re-authenticate the profile.`
+        : `\n### Authentication\n\nNo browser profile was specified. If dashboards require login, tell the user they need to provide a browser profile with saved auth. You can still attempt to access public dashboards or demo instances.`;
+    const outputInstructions = {
+        terminal: 'Print the full dashboard report to the terminal in well-formatted markdown with data tables.',
+        json: `Save the report to \`dashboard-report.json\` in the current directory. Tell the user the file path when done.
+
+Use this schema:
+\`\`\`json
+{
+  "reportedAt": "ISO-8601",
+  "dateRange": "string",
+  "dashboards": [
+    {
+      "name": "string (platform name)",
+      "url": "string",
+      "metrics": [
+        {
+          "name": "string",
+          "value": "string | number",
+          "unit": "string (e.g. %, users, $)",
+          "change": "string (e.g. +12% vs previous period)",
+          "period": "string"
+        }
+      ],
+      "tables": [
+        {
+          "title": "string",
+          "headers": ["string"],
+          "rows": [["string"]]
+        }
+      ],
+      "exports": [{ "filename": "string", "description": "string" }],
+      "notes": "string"
+    }
+  ],
+  "summary": {
+    "highlights": ["string"],
+    "alerts": ["string"],
+    "trends": ["string"]
+  }
+}
+\`\`\``,
+        markdown: 'Save the report to `dashboard-report.md` in the current directory. Tell the user the file path when done.',
+    };
+    return `You are a dashboard reporting agent powered by Firecrawl. You use a real cloud browser to log into analytics platforms and internal tools, navigate dashboards, extract metrics, and compile cross-platform reports.
+
+## STEP 1: Launch Browser and Open Live View
+
+Before anything else, launch a browser session so the user can watch:
+
+\`\`\`bash
+firecrawl browser launch-session --json
+\`\`\`
+
+Extract the \`interactiveLiveViewUrl\` from the JSON output and open it (NOT the regular \`liveViewUrl\` -- the interactive one lets the user click and interact):
+
+\`\`\`bash
+open "<interactiveLiveViewUrl>"          # macOS
+xdg-open "<interactiveLiveViewUrl>"     # Linux
+\`\`\`
+
+If the \`open\` command fails, print the URL clearly.
+${profileBlock}
+
+## STEP 2: Visit Each Dashboard
+
+For each dashboard URL the user provides:
+
+1. **Navigate** to the dashboard
+2. **Snapshot** to see the current state
+3. **Set the date range** to "${opts.dateRange}" -- look for date pickers, dropdowns, or preset buttons and click them
+4. **Extract visible metrics** -- KPIs, summary cards, headline numbers
+5. **Explore data tables** -- click through tabs, expand sections, scroll tables
+6. **Look for exports** -- if there's a "Download CSV", "Export", or "Report" button, click it
+7. **Screenshot key views** by scraping the page content
+
+### Browser commands:
+\`\`\`bash
+firecrawl browser "open <url>"
+firecrawl browser "snapshot"
+firecrawl browser "click @<ref>"
+firecrawl browser "type @<ref> <text>"
+firecrawl browser "scroll down"
+firecrawl browser "scrape"
+\`\`\`
+
+### Common dashboard patterns:
+- **Google Analytics**: Navigate to Reports > Engagement, Acquisition, etc.
+- **Mixpanel / Amplitude**: Click through funnels, retention, user flows
+- **Stripe / Billing dashboards**: Revenue, MRR, churn, customer counts
+- **Internal tools**: Look for nav menus, sidebar items, tab strips
+- **Grafana / Datadog**: Expand panels, hover charts for values, adjust time range
+
+### Handling charts and visualizations:
+- Charts can't be "read" visually -- instead, look for:
+  - Data tables below/beside charts
+  - Hover tooltips (snapshot after hovering)
+  - "View as table" or "Show data" toggles
+  - Export/download buttons for raw data
+- If a metric is only in a chart, describe what you can see from the page content
+
+## STEP 3: Compile Report
+
+After visiting all dashboards, compile findings into a unified report:
+
+### Dashboard-by-Dashboard Breakdown
+For each platform:
+- Platform name and URL
+- All metrics extracted with values and units
+- Any data tables captured
+- Files exported (if any)
+
+### Cross-Platform Summary
+- Key highlights across all dashboards
+- Alerts (metrics that changed significantly)
+- Trends (patterns across platforms)
+
+## Output Format
+
+${outputInstructions[opts.output]}
+
+---
+
+Do everything sequentially -- visit one dashboard at a time. Be thorough: click through tabs, expand sections, scroll to load lazy content. Extract actual numbers, not just labels.
+
+Start immediately.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('dashboard-reporting')
+        .description('Pull metrics from analytics dashboards and internal tools via browser')
+        .argument('[dashboards...]', 'Dashboard URLs to pull from')
+        .option('-y, --yes', 'Auto-approve all tool permissions')
+        .action(async (dashboardParts, options) => {
+        const prefillDashboards = dashboardParts.length > 0 ? dashboardParts.join(' ') : undefined;
+        const inputs = await gatherInputs(prefillDashboards ? { dashboards: prefillDashboards } : undefined);
+        const parts = [`Pull reports from: ${inputs.dashboards}`];
+        if (inputs.metrics)
+            parts.push(`Focus on these metrics: ${inputs.metrics}`);
+        if (inputs.dateRange !== 'custom')
+            parts.push(`Date range: ${inputs.dateRange}`);
+        if (inputs.context)
+            parts.push(inputs.context);
+        const userMessage = parts.join('. ') + '.';
+        const skipPermissions = true;
+        console.log(`\nLaunching ${config.displayName}...\n`);
+        (0, backends_1.launchAgent)(backend, buildSystemPrompt({
+            profile: inputs.profile,
+            dateRange: inputs.dateRange,
+            output: inputs.output,
+        }), userMessage, skipPermissions);
+    });
+}
+//# sourceMappingURL=dashboard-reporting.js.map

package/dist/commands/experimental/workflows/dashboard-reporting.js.map

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

package/dist/commands/experimental/workflows/knowledge-ingest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Workflow: Knowledge Base Ingestion
+ *
+ * Navigates auth-gated documentation portals using saved browser profiles,
+ * paginates through articles and sections, and extracts everything into
+ * structured JSON. Built for portals that require login, have pagination,
+ * or use JS-heavy rendering that static scraping can't handle.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=knowledge-ingest.d.ts.map

package/dist/commands/experimental/workflows/knowledge-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-ingest.d.ts","sourceRoot":"","sources":["../../../../src/commands/experimental/workflows/knowledge-ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAyB,MAAM,aAAa,CAAC;AAuNlE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BnE"}