firecrawl-search▌
firecrawl/cli · updated Apr 8, 2026
Web search with optional full-page content extraction from results.
- ›Returns real search results as JSON with optional --scrape flag to fetch complete page markdown for each result, avoiding redundant fetches
- ›Supports filtering by source type (web, images, news), category (GitHub, research, PDF), time range (past hour/day/week/month/year), location, and country
- ›Use --limit to control result count and --scrape-formats to customize output formats when extracting full content
- ›Part of
firecrawl search
Web search with optional content scraping. Returns search results as JSON, optionally with full page content.
When to use
- You don't have a specific URL yet
- You need to find pages, answer questions, or discover sources
- First step in the workflow escalation pattern: search → scrape → map → crawl → interact
Quick start
# Basic search
firecrawl search "your query" -o .firecrawl/result.json --json
# Search and scrape full page content from results
firecrawl search "your query" --scrape -o .firecrawl/scraped.json --json
# News from the past day
firecrawl search "your query" --sources news --tbs qdr:d -o .firecrawl/news.json --json
Options
| Option | Description |
|---|---|
--limit <n> |
Max number of results |
--sources <web,images,news> |
Source types to search |
--categories <github,research,pdf> |
Filter by category |
--tbs <qdr:h|d|w|m|y> |
Time-based search filter |
--location |
Location for search results |
--country <code> |
Country code for search |
--scrape |
Also scrape full page content for each result |
--scrape-formats |
Formats when scraping (default: markdown) |
-o, --output <path> |
Output file path |
--json |
Output as JSON |
Tips
--scrapefetches full content — don't re-scrape URLs from search results. This saves credits and avoids redundant fetches.- Always write results to
.firecrawl/with-oto avoid context window bloat. - Use
jqto extract URLs or titles:jq -r '.data.web[].url' .firecrawl/search.json - Naming convention:
.firecrawl/search-{query}.jsonor.firecrawl/search-{query}-scraped.json
See also
- firecrawl-scrape — scrape a specific URL
- firecrawl-map — discover URLs within a site
- firecrawl-crawl — bulk extract from a site
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.4★★★★★46 reviews- ★★★★★Diego Lopez· Dec 24, 2024
Useful defaults in firecrawl-search — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Kiara Nasser· Dec 12, 2024
Solid pick for teams standardizing on skills: firecrawl-search is focused, and the summary matches what you get after install.
- ★★★★★Jin Okafor· Dec 12, 2024
We added firecrawl-search from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Maya Wang· Nov 7, 2024
Registry listing for firecrawl-search matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Diego Diallo· Nov 3, 2024
firecrawl-search has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Amina Ndlovu· Nov 3, 2024
firecrawl-search reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Jin Gupta· Oct 26, 2024
Useful defaults in firecrawl-search — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Camila Bhatia· Oct 22, 2024
firecrawl-search fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Min Chen· Oct 22, 2024
firecrawl-search is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Yuki Zhang· Sep 17, 2024
firecrawl-search is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
showing 1-10 of 46