@hybridlabor-api/aos 4.0.2 → 4.1.0

package/.agents/skills/firecrawl-agent/SKILL.md

@@ -1,58 +0,0 @@
----
-name: firecrawl-agent
-description: |
-  AI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, product listings, directory entries, or any data as JSON with a schema. Triggers on "extract structured data", "get all the products", "pull pricing info", "extract as JSON", or when the user provides a JSON schema for website data. More powerful than simple scraping for multi-page structured extraction.
-category: library
-allowed-tools:
-  - Bash(firecrawl *)
-  - Bash(npx firecrawl *)
----
-
-# firecrawl agent
-
-AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
-
-## When to use
-
-- You need structured data from complex multi-page sites
-- Manual scraping would require navigating many pages
-- You want the AI to figure out where the data lives
-
-## Quick start
-
-```bash
-# Extract structured data
-firecrawl agent "extract all pricing tiers" --wait -o .firecrawl/pricing.json
-
-# With a JSON schema for structured output
-firecrawl agent "extract products" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait -o .firecrawl/products.json
-
-# Focus on specific pages
-firecrawl agent "get feature list" --urls "<url>" --wait -o .firecrawl/features.json
-```
-
-## Options
-
-| Option                 | Description                               |
-| ---------------------- | ----------------------------------------- |
-| `--urls <urls>`        | Starting URLs for the agent               |
-| `--model <model>`      | Model to use: spark-1-mini or spark-1-pro |
-| `--schema <json>`      | JSON schema for structured output         |
-| `--schema-file <path>` | Path to JSON schema file                  |
-| `--max-credits <n>`    | Credit limit for this agent run           |
-| `--wait`               | Wait for agent to complete                |
-| `--pretty`             | Pretty print JSON output                  |
-| `-o, --output <path>`  | Output file path                          |
-
-## Tips
-
-- Always use `--wait` to get results inline. Without it, returns a job ID.
-- Use `--schema` for predictable, structured output — otherwise the agent returns freeform data.
-- Agent runs consume more credits than simple scrapes. Use `--max-credits` to cap spending.
-- For simple single-page extraction, prefer `scrape` — it's faster and cheaper.
-
-## See also
-
-- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — simpler single-page extraction
-- [firecrawl-interact](../firecrawl-interact/SKILL.md) — scrape + interact for manual page interaction (more control)
-- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extraction without AI

package/.agents/skills/firecrawl-build/SKILL.md

@@ -1,39 +0,0 @@
----
-name: firecrawl-build
-description: >-
-  Integrate Firecrawl into product code for web scraping, crawling, searching, and interaction.
-  Use this skill when an application needs to access web data, extract content, or automate web interactions.
-category: library
-allowed-tools:
-  - Bash(firecrawl *)
-  - Bash(npx firecrawl *)
----
-# Firecrawl Build
-
-This skill enables the integration of Firecrawl into product code for web scraping, crawling, searching, and interaction.
-
-## Usage
-
-To use this skill, ensure you have the Firecrawl CLI installed and authenticated. You can then use the following commands to integrate Firecrawl into your application:
-
-*   `firecrawl scrape <URL>`: Extract content from a specified URL.
-*   `firecrawl crawl <URL>`: Crawl an entire website or a specific section.
-*   `firecrawl search <query>`: Search the web for specific content.
-*   `firecrawl interact <URL>`: Interact with a webpage, such as clicking buttons or filling out forms.
-
-## Examples
-
-*   "Scrape the content from https://example.com"
-    `firecrawl scrape https://example.com --format markdown`
-*   "Crawl the /docs section of example.com"
-    `firecrawl crawl https://example.com --include-paths /docs --wait -o docs.json`
-*   "Search for recent news on AI"
-    `firecrawl search "recent news on AI" --limit 5`
-*   "Interact with the login form on https://example.com/login"
-    `firecrawl interact https://example.com/login --prompt "Fill in the email field with user@example.com and click the login button"`
-
-## See Also
-
-*   [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md)
-*   [firecrawl-build-search](../firecrawl-build-search/SKILL.md)
-*   [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md)

package/.agents/skills/firecrawl-build-interact/SKILL.md

@@ -1,68 +0,0 @@
----
-name: firecrawl-build-interact
-description: Integrate Firecrawl `/interact` into product code for dynamic pages and browser actions after scraping. Use when a feature needs clicks, form fills, pagination, authentication-aware flows, or other multi-step interactions that plain `/scrape` cannot complete.
-category: library
-license: ISC
-metadata:
-  author: firecrawl
-  version: "0.1.0"
-  homepage: https://www.firecrawl.dev
-  source: https://github.com/firecrawl/skills
-inputs:
-  - name: FIRECRAWL_API_KEY
-    description: Firecrawl API key for hosted Firecrawl requests.
-    required: true
-  - name: FIRECRAWL_API_URL
-    description: Optional base URL for self-hosted Firecrawl deployments.
-    required: false
----
-
-# Firecrawl Build Interact
-
-Use this when `/scrape` is not enough because the feature needs to act on the page.
-
-## Use This When
-
-- content appears only after clicks, typing, or navigation
-- the feature needs forms, pagination, filters, or multi-step flows
-- the product must stay in the same browser context after scraping
-
-## Default Recommendations
-
-- Start with `/scrape`, then escalate to `/interact`.
-- Keep `/interact` scoped to the smallest browser workflow that unlocks the data.
-- Use persistent profiles only when the feature truly needs authenticated state across sessions.
-
-## Common Product Patterns
-
-- search forms and faceted filters
-- paginated result sets
-- login-gated dashboards or tools
-- flows where the page must be explored before extraction is complete
-
-## Implementation Notes
-
-- `/interact` is the right tool when the page must be manipulated, not just read.
-- Keep prompts or action code specific to the product flow.
-- If the use case is fully open-ended browser automation, evaluate whether a browser sandbox is a better product fit.
-
-## Escalation Rules
-
-- If the page can be read directly, stay on [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md).
-
-## Docs (Source of Truth)
-
-Read the source-of-truth page for your project language before writing integration code:
-
-- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)
-- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)
-- **Rust**: [docs.firecrawl.dev/agent-source-of-truth/rust](https://docs.firecrawl.dev/agent-source-of-truth/rust)
-- **Java**: [docs.firecrawl.dev/agent-source-of-truth/java](https://docs.firecrawl.dev/agent-source-of-truth/java)
-- **Elixir**: [docs.firecrawl.dev/agent-source-of-truth/elixir](https://docs.firecrawl.dev/agent-source-of-truth/elixir)
-- **cURL / REST**: [docs.firecrawl.dev/agent-source-of-truth/curl](https://docs.firecrawl.dev/agent-source-of-truth/curl)
-
-## See Also
-
-- [firecrawl-build](../firecrawl-build/SKILL.md)
-- [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md)
-- [firecrawl-build-search](../firecrawl-build-search/SKILL.md)

package/.agents/skills/firecrawl-build-onboarding/SKILL.md

@@ -1,103 +0,0 @@
----
-name: firecrawl-build-onboarding
-description: Get Firecrawl credentials and SDK setup into a project. Use when an application needs `FIRECRAWL_API_KEY`, when an agent should add Firecrawl to `.env`, when the user wants to authenticate Firecrawl for app code, or when choosing the first SDK and docs for a new Firecrawl integration. This skill includes its own browser auth flow, so it does not depend on the website onboarding skill.
-category: library
-license: ISC
-metadata:
-  author: firecrawl
-  version: "0.1.0"
-  homepage: https://www.firecrawl.dev
-  source: https://github.com/firecrawl/skills
-inputs:
-  - name: FIRECRAWL_API_KEY
-    description: Firecrawl API key used for hosted Firecrawl API requests.
-    required: true
-  - name: FIRECRAWL_API_URL
-    description: Optional base URL for self-hosted Firecrawl deployments.
-    required: false
-references:
-  - references/auth-flow.md
-  - references/sdk-installation.md
-  - references/project-setup.md
----
-
-# Firecrawl Build Onboarding
-
-Use this skill for the application-integration path from Firecrawl's onboarding flow.
-
-## Install
-
-If you haven't installed yet, one command sets up both the CLI tools
-(for live web work) and the build skills (for app integration):
-
-```bash
-npx -y firecrawl-cli@latest init --all --browser
-```
-
-This installs the Firecrawl CLI, the CLI skills, and these build skills
-together. It also opens browser auth so the human can sign in or create
-an account. No separate `npx skills add` step is needed.
-
-## Use This When
-
-- a project needs `FIRECRAWL_API_KEY`
-- the user wants Firecrawl wired into `.env`
-- you are adding Firecrawl to an app for the first time
-- you need to choose the first SDK or REST path
-
-If the human still needs to sign up, sign in, or authorize access in the browser, use the auth flow reference in this skill.
-
-## Quick Start
-
-If the user already has an API key, place it in `.env`:
-
-```dotenv
-FIRECRAWL_API_KEY=fc-...
-```
-
-If the project is self-hosted, also set:
-
-```dotenv
-FIRECRAWL_API_URL=https://your-firecrawl-instance.example.com
-```
-
-Then decide which integration path applies:
-
-- **Fresh project** -> choose the target stack, install the SDK, add the first Firecrawl call, and run a smoke test
-- **Existing project** -> inspect the repo first, then integrate Firecrawl where the project already handles third-party APIs and env vars
-
-## What Do You Need?
-
-| Task | Reference |
-|---|---|
-| **Run the browser auth flow and save `FIRECRAWL_API_KEY`** | [references/auth-flow.md](references/auth-flow.md) |
-| **Install the right SDK** | [references/sdk-installation.md](references/sdk-installation.md) |
-| **Put credentials into `.env` or project config** | [references/project-setup.md](references/project-setup.md) |
-| **Choose the right endpoint after setup** | [firecrawl-build](../firecrawl-build/SKILL.md) |
-| **Need live web tooling during this task** | The CLI skills are already installed from the same command |
-| **Start implementation from a known URL** | [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md) |
-| **Start implementation from a query** | [firecrawl-build-search](../firecrawl-build-search/SKILL.md) |
-
-## Docs (Source of Truth)
-
-Read the source-of-truth page for your project language for SDK usage, schemas, and examples:
-
-- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)
-- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)
-- **Rust**: [docs.firecrawl.dev/agent-source-of-truth/rust](https://docs.firecrawl.dev/agent-source-of-truth/rust)
-- **Java**: [docs.firecrawl.dev/agent-source-of-truth/java](https://docs.firecrawl.dev/agent-source-of-truth/java)
-- **Elixir**: [docs.firecrawl.dev/agent-source-of-truth/elixir](https://docs.firecrawl.dev/agent-source-of-truth/elixir)
-- **cURL / REST**: [docs.firecrawl.dev/agent-source-of-truth/curl](https://docs.firecrawl.dev/agent-source-of-truth/curl)
-
-## After Setup
-
-Once the key is present:
-
-1. decide whether this is a fresh project or an existing codebase
-2. ask what Firecrawl should do in the product
-3. pick the narrowest endpoint that matches that behavior
-4. read the source-of-truth page for the project language before writing code
-5. add the SDK or REST call in code
-6. run a smoke test that proves one real Firecrawl request succeeds
-7. use the endpoint-specific skills in this repo for implementation guidance
-8. if you also need live web tooling during the current task, the CLI skills are already installed — use `firecrawl/cli`

package/.agents/skills/firecrawl-build-onboarding/references/auth-flow.md

@@ -1,39 +0,0 @@
-# Auth Flow
-
-Use this browser flow when the user does not already have a Firecrawl API key.
-
-## Step 1: Generate auth parameters
-
-```bash
-SESSION_ID=$(openssl rand -hex 32)
-CODE_VERIFIER=$(openssl rand -base64 32 | tr '+/' '-_' | tr -d '=\n' | head -c 43)
-CODE_CHALLENGE=$(printf '%s' "$CODE_VERIFIER" | openssl dgst -sha256 -binary | openssl base64 -A | tr '+/' '-_' | tr -d '=')
-```
-
-## Step 2: Ask the user to open this URL
-
-```text
-https://www.firecrawl.dev/cli-auth?code_challenge=$CODE_CHALLENGE&source=coding-agent#session_id=$SESSION_ID
-```
-
-The user completes the browser authorization flow. If successful, the API key becomes available through the polling endpoint.
-
-## Step 3: Poll for completion
-
-```http
-POST https://www.firecrawl.dev/api/auth/cli/status
-Content-Type: application/json
-
-{"session_id":"$SESSION_ID","code_verifier":"$CODE_VERIFIER"}
-```
-
-Responses:
-
-- `{"status":"pending"}` - continue polling
-- `{"status":"complete","apiKey":"fc-...","teamName":"..."}`
-
-## Step 4: Save the key
-
-```bash
-echo "FIRECRAWL_API_KEY=fc-..." >> .env
-```

package/.agents/skills/firecrawl-build-onboarding/references/project-setup.md

@@ -1,20 +0,0 @@
-# Project Setup
-
-For hosted Firecrawl, add this to `.env`:
-
-```dotenv
-FIRECRAWL_API_KEY=fc-...
-```
-
-For self-hosted Firecrawl, add:
-
-```dotenv
-FIRECRAWL_API_KEY=fc-...
-FIRECRAWL_API_URL=https://your-firecrawl-instance.example.com
-```
-
-Project setup guidance:
-
-- Keep the key in environment variables or the platform secret manager.
-- Do not hardcode credentials in source files.
-- If the app has separate environments, mirror the key setup across development, preview, and production as needed.

package/.agents/skills/firecrawl-build-onboarding/references/sdk-installation.md

@@ -1,17 +0,0 @@
-# SDK Installation
-
-Install the SDK that matches the project stack after `FIRECRAWL_API_KEY` is available.
-
-## JavaScript / TypeScript
-
-```bash
-npm install @mendable/firecrawl-js
-```
-
-## Python
-
-```bash
-pip install firecrawl-py
-```
-
-If the project already has a preferred HTTP client abstraction, direct REST calls are also fine.

package/.agents/skills/firecrawl-build-scrape/SKILL.md

@@ -1,69 +0,0 @@
----
-name: firecrawl-build-scrape
-description: Integrate Firecrawl `/scrape` into product code for single-page extraction. Use when an app already has a URL and needs markdown, HTML, links, screenshots, metadata, or structured page output. Prefer this skill over broader crawl patterns when the feature is page-level.
-category: library
-license: ISC
-metadata:
-  author: firecrawl
-  version: "0.1.0"
-  homepage: https://www.firecrawl.dev
-  source: https://github.com/firecrawl/skills
-inputs:
-  - name: FIRECRAWL_API_KEY
-    description: Firecrawl API key for hosted Firecrawl requests.
-    required: true
-  - name: FIRECRAWL_API_URL
-    description: Optional base URL for self-hosted Firecrawl deployments.
-    required: false
----
-
-# Firecrawl Build Scrape
-
-Use this when the application already has the URL and needs content from one page.
-
-## Use This When
-
-- the feature starts from a known URL
-- you need page content for retrieval, summarization, enrichment, or monitoring
-- you want the default extraction primitive before considering `/interact`
-
-## Default Recommendations
-
-- Return `markdown` unless the feature truly needs another format.
-- Use `onlyMainContent` for article-like pages where nav and chrome add noise.
-- Add waits or other rendering options only when the page needs them.
-
-## Common Product Patterns
-
-- knowledge ingestion from known URLs
-- enrichment from a company, product, or docs page
-- pricing, changelog, and documentation extraction
-- page-level quality checks or monitoring
-
-## Escalation Rules
-
-- If you do not have the URL yet, start with [firecrawl-build-search](../firecrawl-build-search/SKILL.md).
-- If content requires clicks, typing, or multi-step navigation, escalate to [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md).
-
-## Implementation Notes
-
-- Keep the integration narrow: one feature, one URL, one extraction contract.
-- Treat `/scrape` as the default primitive for downstream LLM or indexing pipelines.
-- Request richer formats only when the consumer needs them, such as links, screenshots, or branding data.
-
-## Docs (Source of Truth)
-
-Read the source-of-truth page for your project language before writing integration code:
-
-- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)
-- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)
-- **Rust**: [docs.firecrawl.dev/agent-source-of-truth/rust](https://docs.firecrawl.dev/agent-source-of-truth/rust)
-- **Java**: [docs.firecrawl.dev/agent-source-of-truth/java](https://docs.firecrawl.dev/agent-source-of-truth/java)
-- **Elixir**: [docs.firecrawl.dev/agent-source-of-truth/elixir](https://docs.firecrawl.dev/agent-source-of-truth/elixir)
-- **cURL / REST**: [docs.firecrawl.dev/agent-source-of-truth/curl](https://docs.firecrawl.dev/agent-source-of-truth/curl)
-
-## See Also
-
-- [firecrawl-build](../firecrawl-build/SKILL.md)
-- [firecrawl-build-search](../firecrawl-build-search/SKILL.md)
-- [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md)

package/.agents/skills/firecrawl-build-search/SKILL.md

@@ -1,69 +0,0 @@
----
-name: firecrawl-build-search
-description: Integrate Firecrawl `/search` into product code and agent workflows. Use when an app needs discovery before extraction, when the feature starts with a query instead of a URL, or when the system should search the web and optionally hydrate result content.
-category: library
-license: ISC
-metadata:
-  author: firecrawl
-  version: "0.1.0"
-  homepage: https://www.firecrawl.dev
-  source: https://github.com/firecrawl/skills
-inputs:
-  - name: FIRECRAWL_API_KEY
-    description: Firecrawl API key for hosted Firecrawl requests.
-    required: true
-  - name: FIRECRAWL_API_URL
-    description: Optional base URL for self-hosted Firecrawl deployments.
-    required: false
----
-
-# Firecrawl Build Search
-
-Use this when the application starts with a query, not a URL.
-
-## Use This When
-
-- the user asks a question and the product must discover sources first
-- the feature needs current web results
-- you want to turn a search query into a shortlist of pages for later scraping
-
-## Default Recommendations
-
-- Use `/search` first when URL discovery is part of the product behavior.
-- Keep search and extraction conceptually separate unless scraping search results is clearly required.
-- Prefer selective follow-up extraction over broad hydration when cost or latency matters.
-
-## Common Product Patterns
-
-- answer generation with cited sources
-- company, competitor, or topic discovery
-- research workflows that produce a shortlist before deeper extraction
-- query-to-URL pipelines for later `/scrape` or `/interact`
-
-## Escalation Rules
-
-- If you already have the URL, use [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md).
-- If the result page then requires clicks or form interaction, escalate to [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md).
-
-## Implementation Notes
-
-- Treat `/search` as discovery, ranking, and source selection.
-- Be explicit about whether the product needs snippets, URLs, or full result content.
-- Keep the query contract stable so downstream scraping logic stays predictable.
-
-## Docs (Source of Truth)
-
-Read the source-of-truth page for your project language before writing integration code:
-
-- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)
-- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)
-- **Rust**: [docs.firecrawl.dev/agent-source-of-truth/rust](https://docs.firecrawl.dev/agent-source-of-truth/rust)
-- **Java**: [docs.firecrawl.dev/agent-source-of-truth/java](https://docs.firecrawl.dev/agent-source-of-truth/java)
-- **Elixir**: [docs.firecrawl.dev/agent-source-of-truth/elixir](https://docs.firecrawl.dev/agent-source-of-truth/elixir)
-- **cURL / REST**: [docs.firecrawl.dev/agent-source-of-truth/curl](https://docs.firecrawl.dev/agent-source-of-truth/curl)
-
-## See Also
-
-- [firecrawl-build](../firecrawl-build/SKILL.md)
-- [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md)
-- [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md)

package/.agents/skills/firecrawl-crawl/SKILL.md

@@ -1,59 +0,0 @@
----
-name: firecrawl-crawl
-description: |
-  Bulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scrape multiple pages following links, or says "crawl", "get all the pages", "extract everything under /docs", "bulk extract", or needs content from many pages on the same site. Handles depth limits, path filtering, and concurrent extraction.
-category: library
-allowed-tools:
-  - Bash(firecrawl *)
-  - Bash(npx firecrawl *)
----
-
-# firecrawl crawl
-
-Bulk extract content from a website. Crawls pages following links up to a depth/limit.
-
-## When to use
-
-- You need content from many pages on a site (e.g., all `/docs/`)
-- You want to extract an entire site section
-- Step 4 in the [workflow escalation pattern](firecrawl-cli): search → scrape → map → **crawl** → interact
-
-## Quick start
-
-```bash
-# Crawl a docs section
-firecrawl crawl "<url>" --include-paths /docs --limit 50 --wait -o .firecrawl/crawl.json
-
-# Full crawl with depth limit
-firecrawl crawl "<url>" --max-depth 3 --wait --progress -o .firecrawl/crawl.json
-
-# Check status of a running crawl
-firecrawl crawl <job-id>
-```
-
-## Options
-
-| Option                    | Description                                 |
-| ------------------------- | ------------------------------------------- |
-| `--wait`                  | Wait for crawl to complete before returning |
-| `--progress`              | Show progress while waiting                 |
-| `--limit <n>`             | Max pages to crawl                          |
-| `--max-depth <n>`         | Max link depth to follow                    |
-| `--include-paths <paths>` | Only crawl URLs matching these paths        |
-| `--exclude-paths <paths>` | Skip URLs matching these paths              |
-| `--delay <ms>`            | Delay between requests                      |
-| `--max-concurrency <n>`   | Max parallel crawl workers                  |
-| `--pretty`                | Pretty print JSON output                    |
-| `-o, --output <path>`     | Output file path                            |
-
-## Tips
-
-- Always use `--wait` when you need the results immediately. Without it, crawl returns a job ID for async polling.
-- Use `--include-paths` to scope the crawl — don't crawl an entire site when you only need one section.
-- Crawl consumes credits per page. Check `firecrawl credit-usage` before large crawls.
-
-## See also
-
-- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape individual pages
-- [firecrawl-map](../firecrawl-map/SKILL.md) — discover URLs before deciding to crawl
-- [firecrawl-download](../firecrawl-download/SKILL.md) — download site to local files (uses map + scrape)

package/.agents/skills/firecrawl-download/SKILL.md

@@ -1,70 +0,0 @@
----
-name: firecrawl-download
-description: |
-  Download an entire website as local files — markdown, screenshots, or multiple formats per page. Use this skill when the user wants to save a site locally, download documentation for offline use, bulk-save pages as files, or says "download the site", "save as local files", "offline copy", "download all the docs", or "save for reference". Combines site mapping and scraping into organized local directories.
-category: library
-allowed-tools:
-  - Bash(firecrawl *)
-  - Bash(npx firecrawl *)
----
-
-# firecrawl download
-
-> **Experimental.** Convenience command that combines `map` + `scrape` to save an entire site as local files.
-
-Maps the site first to discover pages, then scrapes each one into nested directories under `.firecrawl/`. All scrape options work with download. Always pass `-y` to skip the confirmation prompt.
-
-## When to use
-
-- You want to save an entire site (or section) to local files
-- You need offline access to documentation or content
-- Bulk content extraction with organized file structure
-
-## Quick start
-
-```bash
-# Interactive wizard (picks format, screenshots, paths for you)
-firecrawl download https://docs.example.com
-
-# With screenshots
-firecrawl download https://docs.example.com --screenshot --limit 20 -y
-
-# Multiple formats (each saved as its own file per page)
-firecrawl download https://docs.example.com --format markdown,links --screenshot --limit 20 -y
-# Creates per page: index.md + links.txt + screenshot.png
-
-# Filter to specific sections
-firecrawl download https://docs.example.com --include-paths "/features,/sdks"
-
-# Skip translations
-firecrawl download https://docs.example.com --exclude-paths "/zh,/ja,/fr,/es,/pt-BR"
-
-# Full combo
-firecrawl download https://docs.example.com \
-  --include-paths "/features,/sdks" \
-  --exclude-paths "/zh,/ja" \
-  --only-main-content \
-  --screenshot \
-  -y
-```
-
-## Download options
-
-| Option                    | Description                                              |
-| ------------------------- | -------------------------------------------------------- |
-| `--limit <n>`             | Max pages to download                                    |
-| `--search <query>`        | Filter URLs by search query                              |
-| `--include-paths <paths>` | Only download matching paths                             |
-| `--exclude-paths <paths>` | Skip matching paths                                      |
-| `--allow-subdomains`      | Include subdomain pages                                  |
-| `-y`                      | Skip confirmation prompt (always use in automated flows) |
-
-## Scrape options (all work with download)
-
-`-f <formats>`, `-H`, `-S`, `--screenshot`, `--full-page-screenshot`, `--only-main-content`, `--include-tags`, `--exclude-tags`, `--wait-for`, `--max-age`, `--country`, `--languages`
-
-## See also
-
-- [firecrawl-map](../firecrawl-map/SKILL.md) — just discover URLs without downloading
-- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape individual pages
-- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract as JSON (not local files)