Import firecrawl skills from firecrawl/skills

skills/firecrawl-agent/LICENSE.txt

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) Firecrawl
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

skills/firecrawl-agent/SKILL.md

@@ -0,0 +1,58 @@
+---
+source: https://github.com/firecrawl/skills/tree/main/skills/core/firecrawl-agent
+name: firecrawl-agent
+description: |
+  Autonomous multi-page extraction into structured JSON. Use when the user wants website data matching a schema — pricing tiers, product listings — beyond a single-page scrape.
+allowed-tools:
+  - Bash(firecrawl *)
+  - Bash(npx firecrawl-cli *)
+---
+
+# firecrawl agent
+
+AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).
+
+## Quick start
+
+```bash
+# Extract structured data
+firecrawl agent "extract all pricing tiers" --wait --json -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 --json -o .firecrawl/products.json
+
+# Focus on specific pages
+firecrawl agent "get feature list" --urls "<url>" --wait --json -o .firecrawl/features.json
+```
+
+Run `firecrawl agent --help` for the full option list.
+
+**Done when:** the output file contains valid JSON answering the request — or a job ID was intentionally returned for later polling.
+
+## Job IDs
+
+Omitting `--wait` returns a job ID. A UUID positional argument is auto-detected as a status check:
+
+```bash
+# Check once (equivalent to adding --status)
+firecrawl agent "<job-id>"
+
+# Wait on an existing job, polling every 10 seconds for up to 5 minutes
+firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300
+
+# Cancel an active job
+firecrawl agent "<job-id>" --cancel
+```
+
+## Tips
+
+- Use `--wait` for inline results; omit it only when you want a job ID to poll later (see [Job IDs](#job-ids)).
+- 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

skills/firecrawl-build-interact/LICENSE.txt

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) Firecrawl
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

skills/firecrawl-build-interact/SKILL.md

@@ -0,0 +1,68 @@
+---
+source: https://github.com/firecrawl/skills/tree/main/skills/build/firecrawl-build-interact
+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.
+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)

skills/firecrawl-build-onboarding/LICENSE.txt

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) Firecrawl
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

skills/firecrawl-build-onboarding/SKILL.md

@@ -0,0 +1,103 @@
+---
+source: https://github.com/firecrawl/skills/tree/main/skills/build/firecrawl-build-onboarding
+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.
+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`

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

@@ -0,0 +1,39 @@
+# 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
+```

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

@@ -0,0 +1,20 @@
+# 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.

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

@@ -0,0 +1,17 @@
+# 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.

skills/firecrawl-build-scrape/LICENSE.txt

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) Firecrawl
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.