firecrawl-deep-research — скилл для Claude Code: отчёты с источниками
Пишет аналитический отчёт по сложной теме: собирает источники по открытому вебу через Firecrawl, разбирает вопрос с разных сторон и ставит ссылку к каждому тезису.
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a claude-codeЧто делает firecrawl-deep-research
Скилл берётся за исследования масштаба отчёта. Он ищет и скрапит страницы через Firecrawl, а на выходе даёт документ с кратким резюме, ключевыми находками, разбором по темам, контраргументами, открытыми вопросами и списком источников, где у каждой ссылки есть пояснение в одну строку.
Перед стартом скилл задаёт один короткий вопрос: сколько времени отвести на задачу. Ответ превращается в режим работы. Несколько минут — 3–5 запросов и 5–10 источников. Около 10–15 минут — 5–10 запросов с разных углов и 15–25 источников. Без ограничения — 10+ запросов и 25+ источников, включая первоисточники и материалы с возражениями. Сбор можно развести по субагентам: обзор, технические детали, рыночный контекст, риски, официальная документация.
Для работы нужен ключ FIRECRAWL_API_KEY, без него запросы к Firecrawl не уходят. Второй момент важнее: если доказательная база — опубликованные статьи, скилл не тот. Он сам отправит вас в firecrawl-research-papers, который опрашивает индекс статей (PubMed, bioRxiv, medRxiv, arXiv), а не ищет по сайтам. Параметр categories: ["research"] в поиске Firecrawl до этого индекса не достаёт, он лишь фильтрует обычную веб-выдачу по научным сайтам. Это повод проверить, откуда вы ждёте факты.
Какие задачи решает
- собрать источники по теме и не потерять ссылки
- разложить сложный вопрос на несколько углов и найти возражения
- получить формальный отчёт вместо списка рекомендаций
- отделить первоисточники от пересказов в выдаче
- зафиксировать, что осталось спорным и требует проверки
Примеры запросов агенту
- Собери отчёт по регулированию open-source моделей в ЕС, времени не жалей
- Нужен разбор темы «энергопотребление дата-центров» с контраргументами и ссылками, минут на 15
- Сделай глубокое исследование рынка inference-чипов, формат markdown
Как установить firecrawl-deep-research
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a claude-code2Вручную: положить файлы
~/.claude/skills/firecrawl-deep-research/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firecrawl-deep-research/
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a codex2Вручную: положить файлы
.agents/skills/firecrawl-deep-research/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a cursor2Вручную: положить файлы
.cursor/skills/firecrawl-deep-research/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install firecrawl/firecrawl-workflows firecrawl-deep-research2Вручную: положить файлы
.github/skills/firecrawl-deep-research/SKILL.md1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a gemini-cli2Командой платформы
gemini skills install https://github.com/firecrawl/firecrawl-workflows --path skills/firecrawl-deep-researchВручную: положить файлы
.devin/skills/firecrawl-deep-research/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о firecrawl-deep-research
Как установить firecrawl-deep-research в Claude Code?
Выполните npx skills add firecrawl/firecrawl-workflows --skill firecrawl-deep-research -a claude-code. После этого файл скилла лежит в ~/.claude/skills/firecrawl-deep-research/SKILL.md.
Что делает firecrawl-deep-research?
Собирает материал по открытому вебу через Firecrawl и пишет отчёт с цитатами: резюме, находки, разбор, контраргументы и полный список источников.
Что нужно, чтобы скилл заработал?
Ключ FIRECRAWL_API_KEY для запросов к Firecrawl, поле обязательное. Поиск и скрап идут через этот сервис, своей базы у скилла нет.
Исходный текст
SKILL.md · ISC
---
name: firecrawl-deep-research
description: |
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.
license: ISC
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
---
# 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](../firecrawl-research-papers/SKILL.md) 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](../firecrawl-research-papers/SKILL.md)
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:
```markdown
# 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.
© firecrawl · ISC · firecrawl/firecrawl-workflows