From 04576c1b11d18904e3398b59623b2712b7907011 Mon Sep 17 00:00:00 2001 From: Max Loffgren Date: Tue, 23 Jun 2026 10:54:11 -0700 Subject: [PATCH] docs(skill): note keyless free tier fallback in CLI skill The installed CLI skill stated agents must authenticate first, which does not match the code: search, scrape, and interact already work without an API key. Add a keyless free-tier fallback note while keeping browser login and API key as the preferred setup. --- skills/firecrawl-cli/SKILL.md | 4 +++- skills/firecrawl-cli/rules/install.md | 2 ++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/skills/firecrawl-cli/SKILL.md b/skills/firecrawl-cli/SKILL.md index 70472cb00..5494c1e3c 100644 --- a/skills/firecrawl-cli/SKILL.md +++ b/skills/firecrawl-cli/SKILL.md @@ -17,7 +17,7 @@ If the task is to integrate Firecrawl into an application, add `FIRECRAWL_API_KE ## Prerequisites -Must be installed and authenticated. Check with `firecrawl --status`. +Must be installed. Check with `firecrawl --status`. ``` 🔥 firecrawl cli v1.8.0 @@ -30,6 +30,8 @@ Must be installed and authenticated. Check with `firecrawl --status`. - **Concurrency**: Max parallel jobs. Run parallel operations up to this limit. - **Credits**: Remaining API credits. Each operation consumes credits. +Authenticating gives the best results. Prefer a free account via `firecrawl init --browser` (browser login) or a `FIRECRAWL_API_KEY` whenever the human can sign up. If you cannot obtain a key and the human cannot sign up, you can still search, scrape, and interact without an API key on the keyless free tier (rate-limited). See [agent onboarding](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for the full set of onboarding paths. + If not ready, see [rules/install.md](rules/install.md). For output handling guidelines, see [rules/security.md](rules/security.md). Before doing real work, verify the setup with one small request: diff --git a/skills/firecrawl-cli/rules/install.md b/skills/firecrawl-cli/rules/install.md index 7ca31e00e..9c7eef11c 100644 --- a/skills/firecrawl-cli/rules/install.md +++ b/skills/firecrawl-cli/rules/install.md @@ -74,6 +74,8 @@ Ask the user how they'd like to authenticate: 1. **Login with browser (Recommended)** - Run `firecrawl login --browser` 2. **Enter API key manually** - Run `firecrawl login --api-key ""` with a key from firecrawl.dev +If you cannot obtain a key and the user cannot sign up, search, scrape, and interact still work without an API key on the keyless free tier (rate-limited). Browser login or an API key remains preferred for the best results. See [agent onboarding](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for the full set of onboarding paths. + ### Command not found If `firecrawl` is not found after installation: