# Firecrawl Web Search

Add query-based web search with optional page content using Firecrawl search.

- Repository: https://github.com/firecrawl/firecrawl (197658 stars)
- Category: Engineering
- License: ISC
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add firecrawl/firecrawl --skill firecrawl-build-search -g -a claude-code -y`
Codex: `npx skills add firecrawl/firecrawl --skill firecrawl-build-search -g -a codex -y`
Cursor: `npx skills add firecrawl/firecrawl --skill firecrawl-build-search -g -a cursor -y`
Gemini CLI: `npx skills add firecrawl/firecrawl --skill firecrawl-build-search -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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 of **web pages** before deeper extraction
- query-to-URL pipelines for later `/scrape` or `/interact`

Note that "research workflow" here means discovering web pages. If the product is
searching **published papers**, that is a different surface, see the escalation
rules below.

## Escalation Rules

The rest: https://github.com/firecrawl/firecrawl/blob/HEAD/skills/firecrawl-build-search/SKILL.md