{"name":"firecrawl-build-search","url":"https://github.com/firecrawl/skills/tree/main/skills/firecrawl-build-search","install":"npx skills add firecrawl/skills --skill firecrawl-build-search","sdk":"firecrawl","key":"firecrawl/firecrawl-build-search","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.","hasContent":true,"content":"---\nname: firecrawl-build-search\ndescription: 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.\nlicense: ISC\nmetadata:\n  author: firecrawl\n  version: \"0.1.0\"\n  homepage: https://www.firecrawl.dev\n  source: https://github.com/firecrawl/skills\ninputs:\n  - name: FIRECRAWL_API_KEY\n    description: Firecrawl API key for hosted Firecrawl requests.\n    required: true\n  - name: FIRECRAWL_API_URL\n    description: Optional base URL for self-hosted Firecrawl deployments.\n    required: false\n---\n\n# Firecrawl Build Search\n\nUse this when the application starts with a query, not a URL.\n\n## Use This When\n\n- the user asks a question and the product must discover sources first\n- the feature needs current web results\n- you want to turn a search query into a shortlist of pages for later scraping\n\n## Default Recommendations\n\n- Use `/search` first when URL discovery is part of the product behavior.\n- Keep search and extraction conceptually separate unless scraping search results is clearly required.\n- Prefer selective follow-up extraction over broad hydration when cost or latency matters.\n\n## Common Product Patterns\n\n- answer generation with cited sources\n- company, competitor, or topic discovery\n- research workflows that produce a shortlist before deeper extraction\n- query-to-URL pipelines for later `/scrape` or `/interact`\n\n## Escalation Rules\n\n- If you already have the URL, use [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md).\n- If the result page then requires clicks or form interaction, escalate to [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md).\n\n## Implementation Notes\n\n- Treat `/search` as discovery, ranking, and source selection.\n- Be explicit about whether the product needs snippets, URLs, or full result content.\n- Keep the query contract stable so downstream scraping logic stays predictable.\n\n## Docs (Source of Truth)\n\nRead the source-of-truth page for your project language before writing integration code:\n\n- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)\n- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)\n- **Rust**: [docs.firecrawl.dev/agent-source-of-truth/rust](https://docs.firecrawl.dev/agent-source-of-truth/rust)\n- **Java**: [docs.firecrawl.dev/agent-source-of-truth/java](https://docs.firecrawl.dev/agent-source-of-truth/java)\n- **Elixir**: [docs.firecrawl.dev/agent-source-of-truth/elixir](https://docs.firecrawl.dev/agent-source-of-truth/elixir)\n- **cURL / REST**: [docs.firecrawl.dev/agent-source-of-truth/curl](https://docs.firecrawl.dev/agent-source-of-truth/curl)\n\n## See Also\n\n- [firecrawl-build](../firecrawl-build/SKILL.md)\n- [firecrawl-build-scrape](../firecrawl-build-scrape/SKILL.md)\n- [firecrawl-build-interact](../firecrawl-build-interact/SKILL.md)\n","contentSource":"https://raw.githubusercontent.com/firecrawl/skills/main/skills/firecrawl-build-search/SKILL.md","contentFetchedAt":"2026-07-28T23:15:39.201Z"}