All skills
firecrawl avatar

/firecrawl-deep-research

@18c0185
by firecrawlfirecrawl/firecrawl-workflows175 stars
38

Produce an intensive, cited analytical report: executive summary, multi-angle findings, contrarian views, open questions, and full sources. Use only when the user needs rigorous synthesis of a complex topic (scientific, technical, policy, or market-analytical) that cannot be answered with a short search, and wants a formal written report, not a recommendation list. Do not use for product picks, top-N lists, quick lookups, or routine "find out about X" tasks. If the request does not clearly need this kind of report, do not use this skill. Do not use for a literature review over published papers. This skill collects evidence from the open web. A request for the literature on a biomedical, clinical, life-science, or other scientific topic β€” papers, studies, trials, preprints β€” belongs to firecrawl-research-papers, which queries Firecrawl's paper index (PubMed, bioRxiv, medRxiv, arXiv) instead of searching websites.

Use this Skill: https://skilld.dev/gh/firecrawl/firecrawl-workflows/firecrawl-deep-research

This session only. Nothing lands on disk.

SKILL.md

β‰ˆ239 tokens always: the name and description. β‰ˆ1.1k when used: this file.

Firecrawl Deep Research

Use this only for report-scale research: a rigorous, cited synthesis the user explicitly wants delivered as a formal written report. If the request is a product pick, a top-N list, a quick lookup, or anything answerable with a short search, stop; do not use this skill, let the request be handled the standard way.

This skill gathers its evidence from the open web. If the evidence base is the published literature β€” a literature review, or a biomedical, clinical, or other scientific topic where the answer lives in papers β€” use firecrawl-research-papers instead; it queries Firecrawl's paper index rather than searching websites.

Onboarding Interview

Infer the topic and output format from context. Before starting, unless already specified, always ask one short question to define the scope:

"How long do you want this research task to run?"

Map the answer to a depth tier in the Collection Plan below:

  • A few minutes β†’ Quick
  • ~10-15 minutes β†’ Thorough
  • Longer / no limit β†’ Exhaustive

If the topic itself is unclear, you may ask at most 1-2 additional concise questions (topic, or a critical angle/source constraint). Otherwise proceed once the runtime is set.

Firecrawl Collection Plan

Use Firecrawl search and scrape through the CLI or equivalent tool surface. Match depth to the runtime the user chose during onboarding.

  • Quick (~a few minutes): search 3-5 queries and scrape 5-10 high-quality sources.
  • Thorough (~10-15 minutes): search 5-10 queries from different angles and scrape 15-25 sources.
  • Exhaustive (longer): search 10+ queries and scrape 25+ sources, including primary sources, research papers, expert views, and contrarian sources.

Avoid re-scraping URLs already returned with full content from a search-with-scrape result.

When Published Papers Are The Evidence

Search and scrape reach web pages. They do not query Firecrawl's research paper index, which holds paper abstracts with full text reachable per paper β€” largely biomedical and life-science literature from PubMed, bioRxiv, and medRxiv, plus arXiv preprints in CS, physics, and math.

Hand off to firecrawl-research-papers when the report's evidence base is the published literature β€” a biomedical, clinical, drug, gene, disease, epidemiology, or public-health topic, or any request phrased as a literature review, systematic review, or survey of studies. That skill uses firecrawl_research_* (MCP) / firecrawl research (CLI) to search abstracts, expand to related papers, and verify claims inside a paper body β€” none of which plain search and scrape can do.

If the report needs both β€” the literature and market, policy, or news context β€” run the paper work through that skill and keep the web collection above for the rest, then synthesize here.

Note that passing categories: ["research"] to Firecrawl search does not query the paper index either. It filters an ordinary web search to research-affiliated websites β€” the list includes PubMed, bioRxiv, medRxiv, arXiv, and publisher sites β€” and returns their web pages, not the paper records behind them.

Parallel Work

If appropriate, use sub-agents or equivalent parallel task runners by research angle:

  • overview and definitions
  • technical or implementation details
  • market and industry context
  • contrarian views, risks, and limitations
  • primary sources and official docs

Each researcher should return claims, source URLs, source quality notes, and uncertainty.

Final Deliverable

Default structure:

# Deep Research: [Topic]

## Executive Summary
[2-3 paragraphs]

## Key Findings
[Numbered findings with source links]

## Detailed Analysis
[Themes, evidence, and synthesis]

## Contrarian Views And Risks
[Counterarguments, limitations, failure modes]

## Open Questions
[What remains uncertain]

## Sources
[Every URL used with a one-line note]

## Rerun Inputs
workflow: firecrawl-deep-research
topic: [topic]
depth: [quick/thorough/exhaustive]
output: [markdown/json/brief]

Quality Bar

  • Cite sources for factual claims.
  • Prefer primary sources when available.
  • Flag uncertainty and conflicting evidence.
  • Synthesize instead of listing scrape summaries.

Source: SKILL.md on GitHub

1 warning17d3 checks Β· Risk SAFE
  • Gen Agent Trust Hub17d

    The skill is a legitimate research workflow designed by Firecrawl to generate cited analytical reports. It is safe for its intended purpose; however, it has an inherent surface for indirect prompt injection because it retrieves and processes untrusted content from the open web.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: MEDIUM Β· 1 issue

Signed by skilld at 18c0185. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Steadyupdated 2 months ago
Other metadata
metadata
{
  "author": "firecrawl",
  "version": "0.1.0",
  "homepage": "https://www.firecrawl.dev",
  "source": "https://github.com/firecrawl/firecrawl-workflows"
}
inputs
[
  {
    "name": "FIRECRAWL_API_KEY",
    "description": "Firecrawl API key for hosted Firecrawl requests.",
    "required": true
  }
]

README badge

README badge for firecrawl/firecrawl-workflows/firecrawl-deep-research