Agent skill · firecrawl
firecrawl-search
Web search with full page content. Use when no URL is known: finding sources, articles, or news. For papers use firecrawl-research-index; for library, API, error, or bug questions use firecrawl-developer-index.
What it needs
About 3k tokens when loaded.
What this skill does
firecrawl search Web search with optional content scraping. Returns search results as JSON, optionally with full page content. Quick start Run firecrawl search --help for the full option list. --categories developer weighs the developer index beside ordinary web results in this same call (no passage control, no index filters). --categories research is a website filter, not the paper index. Dedicated skills: firecrawl-developer-index and firecrawl-research-index. Done when: results are saved under .firecrawl/, verified non-empty, processed for the request, and one feedback event is sent within the time window (unless opted out). Tips --highlights on by default: results are query-relevant excerpts, not full-page snippets. Use --no-highlights for the original snippets. --scrape fetches full content — reuse that content instead of re-scraping result URLs. This saves credits and avoids redundant fetches. Always write results to .firecrawl/ with -o to avoid context window bloat. Use jq to extract URLs or titles: jq -r '.data.web[].url' .firecrawl/search.json Naming convention: .firecrawl/search-{query}.json or .firecrawl/search-{query}-scraped.json Send feedback after every search (refunds 1 credit) Search costs 2 credits. After you've actually used the results (or decided they were useless), send structured feedback with firecrawl search-feedback <id>. The first feedback per search refunds 1 credit and helps us improve search quality. Do this once per search, in the background, after you finish processing the results — it does not block your main task. Opt out: if FIRECRAWLNOSEARCHFEEDBACK=1 (or FIRECRAWLDISABLESEARCHFEEDBACK=1) is set, the CLI silently skips the call and never sends anything. Respect that — do not try to work around it. (Team admins can also disable this server-side; the API will return feedbackErrorCode: "TEAMOPTEDOUT" and the CLI will exit 0 silently.) Rules to know before you call this: Time window: must be sent within ~2 minutes of the search. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills firecrawl/firecrawl-search--a9af60