firecrawl-build-search

Integrate Firecrawl /search API into product code for query-driven web discovery.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/agents --skill firecrawl-build-search-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firecrawl-build-search
Source: https://github.com/leonardoacosta/agents/tree/main/skills/firecrawl-build-search
Command: npx skills add https://github.com/leonardoacosta/agents --skill firecrawl-build-search-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a product feature starts with a user query instead of a known URL, developers need a reliable way to discover relevant web pages before any extraction happens. This Skill guides the integration of the Firecrawl /search endpoint into applications and agent workflows so query-to-URL discovery becomes a predictable pipeline stage. ## Core Features & Use Cases - Query-First Discovery: Use /search to turn a natural-language query into a ranked shortlist of web pages for downstream processing. - Selective Hydration: Decide explicitly whether the product needs snippets, URLs, or full result content, and prefer selective follow-up extraction over broad hydration when cost or latency matters. - Escalation Routing: Clear rules for when to switch surfaces — firecrawl-build-scrape when you already have a URL, firecrawl-build-interact for pages requiring clicks or forms, and firecrawl-research-index or firecrawl-developer-index for paper or developer-content search. - Use Case: Build an answer-generation feature that searches the web for a user's question, shortlists cited sources, and then scrapes only the top results for full content. ## Quick Start Ask the agent to integrate Firecrawl /search into your app so a user query returns a shortlist of source URLs ready for scraping.

Frequently Asked Questions about firecrawl-build-search

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

FAQPage Schema
How do I add web search to my app with Firecrawl?

Use the Firecrawl /search endpoint to convert a user query into a ranked list of web pages. Treat search as the discovery stage, then pass selected URLs to /scrape for content extraction, keeping the query contract stable so downstream logic stays predictable.

When should I use Firecrawl /search versus /scrape?

Use /search when the feature starts with a query and you need URL discovery first. Use /scrape when you already have the target URL and only need its content extracted.

Does Firecrawl /search work for finding research papers?

No. Passing categories: ["research"] to /search only filters ordinary web results to research-affiliated sites; it does not provide abstract search or related-paper expansion. Use the firecrawl-research-index skill for PubMed, bioRxiv, medRxiv, or arXiv literature search.

What credentials does Firecrawl search integration require?

A FIRECRAWL_API_KEY is required for hosted Firecrawl requests. Self-hosted deployments can optionally set FIRECRAWL_API_URL to point at a custom base URL.

Should I scrape every search result or only some?

Prefer selective follow-up extraction over broad hydration when cost or latency matters. Decide explicitly whether the product needs snippets, URLs, or full result content, and scrape only the shortlisted pages that require it.