firecrawl-lead-gen Skill for Claude: What It Does and How to Install It

Makes your agent build a ranked, sourced prospect list from Firecrawl Alexandria people and company data.

Installs: 31.6K; on skills.sh
Stars: 214; on GitHub
Updated: Nov 2026; last repo commit

This skill makes your agent find people by role, seniority, company, industry, size, location or technology, and find the right contacts at companies that fit. Profile and contact fields come from Alexandria's people and company providers, and the web is used only to find sources for criteria they do not cover.

It returns a ranked table or a CSV and says how far short of your count it fell. It needs a Firecrawl API key, the Firecrawl CLI and authenticated Alexandria access, and it does not create CRM records or send outreach.

Good for

Sales and recruiting teams building prospect lists
Marketers who need target accounts that match criteria
Anyone refreshing a prospect list with only the new matches

Install firecrawl-lead-gen

Claude Code

Copy this prompt.

Install the firecrawl-lead-gen skill in Claude Code. Run this command:

/plugin marketplace add firecrawl/firecrawl-workflows
/plugin install firecrawl-workflows@firecrawl-workflows

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The plugin routes install the whole firecrawl-workflows plugin: 16 skills (counted from the skills list in its plugin.json), and the repo tree has no hooks, agents or MCP config files. The skills-only routes install just firecrawl-lead-gen. The skill drives the Firecrawl CLI and needs a Firecrawl API key. Install the Firecrawl CLI first, since the skill runs firecrawl commands: npm install -g firecrawl-cli (Firecrawl CLI docs), or npx -y firecrawl-cli@latest init -y --browser to install it, sign in and add the shared skills in one step. Then run firecrawl login or export FIRECRAWL_API_KEY. Who pays: the Firecrawl account that owns the key. Every call uses credits; a new account starts on the free plan with 1,000 credits a month and no card. Per Firecrawl's billing docs: Alexandria data tools cost the price listed on each tool, while discovery is free; search 2 credits per 10 results; scrape 1 credit per page.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Find and qualify new prospects with Firecrawl Alexandria people and company data: people by role, seniority, company, industry, size, location or technology, target accounts that match criteria, or the right contacts at companies, returned as a ranked, sourced table or CSV. Also extracts lead lists from a database or directory the user names, and refreshes a prospect list with only new matches. Use when the user wants a lead list, prospects, target accounts or the people to reach out to at companies that fit criteria. Not for enriching people or companies the user already supplied (use firecrawl-lead-research).

Sections in SKILL.md

Workflow
Output
Weekly refresh
Rules

Key facts

Author: Firecrawl (frontmatter author, and the repo owner)
License: ISC (frontmatter and the README)
Installs on skills.sh: 31,609 (Nov 2, 2026)
GitHub stars: 214 for the whole firecrawl/firecrawl-workflows repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
What it includes: 1 file: SKILL.md (bundles no scripts)
Needs: A Firecrawl API key (FIRECRAWL_API_KEY) with credits, and the Firecrawl CLI (npm install -g firecrawl-cli)
Part of: The firecrawl-workflows plugin: 16 skills in its Claude plugin.json (counted), 19 skill folders in the repo tree
Works in: AI coding agents, per the README. The repo also ships plugin manifests for Claude Code, Codex and Cursor

What it includes

Notes roles, company criteria, location, count, output format and required filters
Required filters are kept apart from preferences.
Read · Set the criteria
Lists people and company providers with firecrawl find-tools
Uses the people category, and the companies category when account criteria apply.
Runs code · Find the provider
Runs firecrawl list to see each capability's filters and response
Only filters the contract supports are passed.
Runs code · Read the contract
Runs firecrawl scrape <provider>/<capability> with JSON options and no URL
Finds companies first when company criteria apply, then people at those domains. Follows pagination and checks every item, since one item can fail while the request succeeds.
Runs code · Search
Deduplicates, ranks by fit and fills only the missing requested fields
Uses bulk capabilities where they exist.
Network · Enrich the shortlist
Uses web search and scrape for criteria only the web shows
Such as recent news or an event speaker list. Profile and contact fields are never filled from the web.
Network · Web for sources only
Starts from a database or directory you name, then enriches through Alexandria
Reads it with firecrawl scrape and uses firecrawl interact for filters and pagination. For a plain company export it points to firecrawl-company-directories.
Runs code · Directory extraction
A ranked table or CSV, then only new prospects on a rerun
A rerun also reports anyone from the old list who changed role or employer.
Write · Output and weekly refresh

From the official docs

Permissions

Medium risk

It pulls records about real people from third-party data providers through your Firecrawl account. Keep the list within the data terms you accepted and the privacy rules that apply to you.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The output is a list of real people
Rows include names, job titles, companies, LinkedIn URLs and, only when you ask, work emails. Handle the file as personal data (our advice). github.com
Provider data terms need an admin to accept them
On THIRD_PARTY_DATA_TERMS_REQUIRED the agent shows you the dashboard link and the provider name. An organization admin accepts the terms, then you tell it to continue. github.com
A weekly refresh compares against your old list
On a rerun it reads your previous list to return only new prospects and role changes, so keep the file where the agent can find it. github.com
It spends your Firecrawl credits
Every call is billed in credits to the account behind the key. Per Firecrawl's billing docs: Alexandria data tools cost the price listed on each tool, while discovery is free; search 2 credits per 10 results; scrape 1 credit per page. A free account has 1,000 credits a month, so a large run can use it up. docs.firecrawl.dev

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode is documented in SKILL.md. Use version control for files it writes.
Talks to	Firecrawl hosted service and its Alexandria data providers. Web pages and directories you name or that it finds for sources
Sign-in and keys	SKILL.md declares FIRECRAWL_API_KEY as a required input. The README says Alexandria access requires an authenticated Firecrawl account. Neither says where credentials are kept.
Scopes	Runs Firecrawl find-tools, list, scrape, search and interact commands with your API key Reads people and company records from Alexandria providers Can write a CSV of prospects Spends credits on the Firecrawl account that owns your API key

Questions

What does the firecrawl-lead-gen skill do?

It makes your agent build a qualified prospect list from Alexandria's people and company data. You get a ranked table or CSV with a fit reason and sources for each row.

How do I install it in Claude Code or Codex?

Use the install box at the top of this page. Each client has a plugin route and skills CLI commands. The README says Alexandria access requires an authenticated Firecrawl account, Install the Firecrawl CLI first (npm install -g firecrawl-cli, per its docs), then run firecrawl login or set FIRECRAWL_API_KEY.

Who pays for it?

You do, through the Firecrawl account that owns your API key. Firecrawl bills in credits, and a new account starts on the free plan with 1,000 credits a month and no card. Per its billing docs: Alexandria data tools cost the price listed on each tool, while discovery is free; search 2 credits per 10 results; scrape 1 credit per page. Check your balance with firecrawl credit-usage.

Will it find email addresses?

Only work emails, only if you ask, and only a real address a provider returned. The rules say never to invent or pattern-guess an email, and not to request personal emails or phone numbers.

firecrawl-lead-gen vs firecrawl-lead-research?

Lead-gen finds new prospects. Lead-research enriches people and companies you already supplied, and the lead-gen description sends that job there.

Does it send outreach or add leads to my CRM?

No. SKILL.md says not to create CRM records or send outreach, and not to bypass CAPTCHAs or access controls.

Is it safe to install?

It is a single SKILL.md file and bundles no scripts. When it runs, your agent queries people data through Firecrawl with your account and writes a CSV if asked. Check the data terms the provider asks you to accept, and keep the list within the privacy rules that apply to you.

Information

updated Nov 2, 2026

Repository: firecrawl/firecrawl-workflows
Folder: skills/firecrawl-lead-gen

firecrawl/firecrawl-workflows skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8

firecrawl-lead-gen SKILL.md · github.com
firecrawl-workflows README · github.com
firecrawl-workflows plugin.json · github.com
firecrawl-workflows marketplace.json · github.com
firecrawl-workflows Codex plugin.json · github.com
Firecrawl CLI docs · docs.firecrawl.dev
Firecrawl billing and credits · docs.firecrawl.dev
firecrawl/cli README · github.com