Description
Web search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "search for", "find me", "look up", "what are people saying about", or "find articles about". Returns real search results with optional full-page markdown — not just snippets. Provides capabilities beyond default agent web search tools.
SKILL.md
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
More skills from the firecrawl-codex-plugin repository
View all 8 skillsfirecrawl
search and scrape web content
Jun 30CLIFirecrawlSearchWeb Scrapingfirecrawl-agent
extract structured data from websites
Jun 30AutomationData AnalysisFirecrawlWeb Scrapingfirecrawl-crawl
bulk extract content from websites
Jun 30Data EngineeringFirecrawlWeb Scrapingfirecrawl-interact
interact with scraped web pages
Jun 30AutomationBrowser AutomationFirecrawlWeb Scrapingfirecrawl-map
map website URLs and site structure
Jun 30CLIFirecrawlSearchWeb Scrapingfirecrawl-parse
extract and convert files to markdown
Jun 30Data CleaningDOCXFirecrawlHTML +1
More from Firecrawl
View publishercompetitor-analysis
analyze competitors across features and pricing
web-agent
Apr 17Competitive IntelligenceFirecrawlResearchdeep-research
conduct multi-source deep research
web-agent
Apr 17FirecrawlKnowledge ManagementResearche-commerce
extract product data from e-commerce sites
web-agent
May 15E-commerceFirecrawlWeb Scrapingfinancial-research
pull financial data for public companies
web-agent
May 15FinanceFirecrawlResearchSEC Filingspricing-tracker
track and compare vendor pricing tiers
web-agent
Apr 17Competitive IntelligenceFirecrawlResearchSaaSstructured-extraction
extract structured data from websites
web-agent
May 15Data EngineeringFirecrawlWeb Scraping