firecrawl-search

Searches the web and scrapes full page content into JSON files via the Firecrawl CLI.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/firstsun-dev/skills --skill firecrawl-search-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: firecrawl-search
Source: https://github.com/firstsun-dev/skills/tree/main/plugins/agent-toolkit/skills/firecrawl-search
Command: npx skills add https://github.com/firstsun-dev/skills --skill firecrawl-search-firstsun-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding sources, articles, or news when no URL is known usually requires manual searching and copy-pasting page content. This Skill runs web searches through the Firecrawl CLI, optionally scrapes full page content from results, and saves everything as structured JSON files for downstream processing. ## Core Features & Use Cases - Web search with JSON output: Run queries and save results to .firecrawl/ files, with query-relevant highlights enabled by default. - Optional full-page scraping: Add --scrape to fetch complete page content from search results in one call, avoiding redundant fetches. - News and category filtering: Restrict results to news sources with time windows (--sources news --tbs qdr:d) or blend in developer-index results via --categories developer. - Use Case: You need recent articles about a library release. Run a search with the news source filter, save results to .firecrawl/news.json, then extract URLs with jq for citation in your report. ## Quick Start Ask the agent to search the web for your query with firecrawl and save the results, optionally with full page content, to a JSON file under .firecrawl/.

Frequently Asked Questions about firecrawl-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the web and get full page content with Firecrawl?▼

Run firecrawl search with your query and add the --scrape flag to fetch full page content from results. Save output with -o to a JSON file under .firecrawl/ so you can reuse the scraped content without re-fetching URLs.

How do I filter Firecrawl search results to recent news?▼

Use --sources news combined with --tbs qdr:d to restrict results to news from the past day. Other time filters are available through the --tbs parameter; run firecrawl search --help for the full option list.

When should I use firecrawl-search instead of firecrawl-scrape?▼

Use firecrawl-search when no URL is known and you need to discover sources, articles, or news. Use firecrawl-scrape when you already have a specific URL to extract content from, and firecrawl-map or firecrawl-crawl for site-wide discovery.

Does firecrawl search support developer or research content?▼

The --categories developer flag weighs the developer index alongside ordinary web results in the same call. For papers, use the dedicated firecrawl-research-index skill, since --categories research is only a website filter, not the paper index.

Why did my firecrawl search produce no output file?▼

Zero-result searches write no output file, so the file may be missing or left over from an earlier search. Verify the file exists and contains non-empty results with jq before reading its search id or sending feedback.