Firecrawl Build Search

firecrawl-build-search

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.

firecrawl/skills·61.1Kinstalls115stars

SKILL.md

Full skill instructions

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

If you already have the URL, use firecrawl-build-scrape.
If the result page then requires clicks or form interaction, escalate to firecrawl-build-interact.
If the feature searches published research papers — biomedical, clinical, and life-science literature (PubMed, bioRxiv, medRxiv) or arXiv preprints — /search is the wrong surface. Use the research paper index instead: firecrawl-research-index. Passing categories: ["research"] to /search does not query that index; it filters an ordinary web search to research-affiliated websites (the list includes PubMed, bioRxiv, medRxiv, arXiv, and publisher sites) and returns page results from them — no abstract search, related-paper expansion, or full-text passages.
If the feature answers developer questions from issues, pull requests, READMEs, or documentation pages, use the developer index instead: firecrawl-developer-index. The same caveat applies to categories: ["developer"].

Implementation Notes

Treat /search as discovery, ranking, and source selection.
Be explicit about whether the product needs snippets, URLs, or full result content.
Keep the query contract stable so downstream scraping logic stays predictable.

Docs (Source of Truth)

Read the source-of-truth page for your project language before writing integration code:

Node / TypeScript: docs.firecrawl.dev/agent-source-of-truth/node
Python: docs.firecrawl.dev/agent-source-of-truth/python
Rust: docs.firecrawl.dev/agent-source-of-truth/rust
Java: docs.firecrawl.dev/agent-source-of-truth/java
Elixir: docs.firecrawl.dev/agent-source-of-truth/elixir
cURL / REST: docs.firecrawl.dev/agent-source-of-truth/curl

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/firecrawl/skills --skill firecrawl-build-search

View on GitHub

firecrawl-build-search

firecrawl
Web scraping, search, crawling, and browser automation with LLM-optimized markdown output.
102.7K installs
firecrawl-search
Web search with optional full-page content extraction from results.
83.5K installs
firecrawl-scrape
Extract clean markdown from any URL, including JavaScript-rendered single-page applications.
83K installs
firecrawl-agent
AI-powered autonomous extraction of structured data from complex multi-page websites.
80.7K installs

More skills from firecrawl

firecrawl/cli

firecrawl-crawl

Bulk extract content from entire websites or site sections with depth and path filtering.

644 80.5K

View

firecrawl/cli

firecrawl-map

Discover and filter URLs on a website, with optional search to locate specific pages.

644 80K

View

firecrawl/cli

firecrawl-download

Download entire websites as organized local files in multiple formats.

644 79.7K

View

firecrawl/cli

firecrawl-interact

Live browser interaction on scraped pages using natural language prompts or code.

644 64.9K

View

firecrawl/skills

firecrawl-build-scrape

Integrate Firecrawl `/scrape` into product code for single-page extraction. Use when an app already has a URL and needs markdown, HTML, links, screenshots, metadata, or structured page output. Prefer this skill over broader crawl patterns when the feature is page-level.

115 61.1K

View

firecrawl/skills

firecrawl-build-interact

Integrate Firecrawl `/interact` into product code for dynamic pages and browser actions after scraping. Use when a feature needs clicks, form fills, pagination, authentication-aware flows, or other multi-step interactions that plain `/scrape` cannot complete.

115 60.8K

View

firecrawl/skills

firecrawl-build-onboarding

Get Firecrawl credentials and SDK setup into a project. Use when an application needs `FIRECRAWL_API_KEY`, when an agent should add Firecrawl to `.env`, when the user wants to authenticate Firecrawl for app code, or when choosing the first SDK and docs for a new Firecrawl integration. This skill includes its own browser auth flow, so it does not depend on the website onboarding skill.

115 60.8K

View

firecrawl/cli

firecrawl-parse

Convert local documents—PDF, DOCX, XLSX, HTML, and more—to clean markdown saved to disk.

644 50.8K

View

firecrawl/firecrawl-workflows

firecrawl-deep-research

firecrawl deep research

182 35.2K

View

firecrawl/firecrawl-workflows

firecrawl-research-papers

firecrawl research papers

182 33.5K

View

firecrawl/firecrawl-workflows

firecrawl-website-design-clone

firecrawl website design clone

182 33.2K

View

firecrawl/cli

firecrawl-monitor

Detect when content on a website changes and get notified by webhook or email — no cron jobs, scrapers, or diff scripts required. Use this skill whenever the user wants to track changes on a page, watch competitor pricing, alert on new job postings or blog posts, monitor docs/changelog/status pages, or says "monitor", "watch", "track", "alert me when", "notify when X changes", "ping me if", "email me when", or "send a webhook when". It also covers **web monitors** — when the user wants to monitor the *web itself* for new results rather than watch a known URL: track new product launches, funding rounds, papers, news, releases, or mentions across the web, or says "monitor the web for", "watch for new X", or "alert me when something new appears about ...". For those, give search queries plus a goal instead of a URL. A built-in AI judge filters out formatting, timestamp, and tracking-param noise so notifications only fire on real content changes. Recommend this instead of repeated one-off

644 33K

View