Skip to content
cccskills
FreePublished on GitHub

firecrawl-build-search

Build web discovery into applications and agent workflows with Firecrawl search. Turn a query into candidate URLs, select useful sources, and decide whether to retrieve page content for further extraction or answers with cited sources.

OriginalShow the original 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.

See how to install

Good for

  • Finding web sources for answers with citations
  • Discovering companies, competitors, or topics
  • Creating a shortlist of pages for deeper research
  • Connecting search queries to page extraction

Files included (1)

  • SKILL.md4.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

See Also

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

firecrawl-build

FreeSummary

Build web search, page content retrieval, structured data extraction, and browser interactions into applications with Firecrawl. The skill guides endpoint selection, credentials, SDK or REST integration, and verification with a real request.

  • Adding web search to an application
  • Extracting structured data from known URLs
  • Building website clicks and form filling into a workflow
firecrawl/firecrawl192.8KUpdated Oct 18, 2026

Integrate Firecrawl browser actions into application code to retrieve content that requires clicks, form entry, or pagination. Use it for multi-step page interactions and workflows that need to preserve the browser session after scraping.

  • Retrieving content revealed by clicks
  • Working with search forms and filters
  • Collecting results across multiple pages
firecrawl/firecrawl192.8KUpdated Oct 18, 2026

Set up Firecrawl in an application, from browser authentication and API key configuration to choosing an SDK, a library for calling the service. Add the first request and verify that the integration works.

  • Adding Firecrawl to a new application
  • Saving an API key in project configuration
  • Choosing an SDK for the project language
firecrawl/firecrawl192.8KUpdated Oct 18, 2026

Integrate single-page extraction into an application using Firecrawl scrape. Retrieve Markdown, HTML, links, screenshots, metadata, or structured data from a known URL, and configure how recently cached content may be reused.

  • Preparing known web pages for summarization
  • Enriching records from company or product pages
  • Extracting pricing, changelogs, or documentation
firecrawl/firecrawl192.8KUpdated Oct 18, 2026

See all skills by firecrawl

Report a problem with this skill