firecrawl-qa — скилл QA живого сайта для Claude Code
Прогоняет развёрнутый сайт через Firecrawl и собирает QA-отчёт: ссылки, формы, мобильная вёрстка, консольные ошибки. Пригодится перед релизом и после деплоя.
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a claude-codeЧто делает firecrawl-qa
Скилл проверяет развёрнутый сайт и возвращает один QA-отчёт. Внутри три инструмента Firecrawl: map собирает список страниц, browser ходит по ссылкам, заполняет формы и меняет вьюпорт, scrape достаёт контент и ссылки для проверки.
Работа разбита на параллельных тестеров. Отдельные наборы есть для полного прогона, для форм, навигации, адаптива и производительности. Каждый тестер возвращает серьёзность, URL, описание, доказательство и шаги воспроизведения, потом находки дедуплицируются. На выходе оценка здоровья сайта вида x/10, список страниц, проблемы по уровням и блок Rerun Inputs, чтобы повторить прогон с тем же фокусом.
Нужен FIRECRAWL_API_KEY — без него запросы к hosted Firecrawl не уйдут, и проверка не начнётся. Ещё скилл не пишет про баги без доказательств: что тестер не смог воспроизвести, в отчёт не попадёт. Если проверяете закрытые разделы, доступ к ним придётся дать заранее — вопрос про креды он задаёт на входе.
Какие задачи решает
- проверить ссылки и маршруты перед релизом
- прогнать формы: отправка, валидация, состояния ошибок
- поймать разъехавшуюся вёрстку на мобильном и планшете
- собрать консольные ошибки и загрузку страниц в один отчёт
- перепроверить прод сразу после выкладки
Примеры запросов агенту
- Запусти
firecrawl-qaна стейджинге, фокус — формы и валидация. - Проверь адаптив через
firecrawl-qa, фокус responsive: десктоп, планшет, мобильный. firecrawl-qaна прод после деплоя, нужен короткий отчёт по консольным ошибкам.
Как установить firecrawl-qa
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a claude-code2Вручную: положить файлы
~/.claude/skills/firecrawl-qa/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firecrawl-qa/
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a codex2Вручную: положить файлы
.agents/skills/firecrawl-qa/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a cursor2Вручную: положить файлы
.cursor/skills/firecrawl-qa/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install firecrawl/firecrawl-workflows firecrawl-qa2Вручную: положить файлы
.github/skills/firecrawl-qa/SKILL.md1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a gemini-cli2Командой платформы
gemini skills install https://github.com/firecrawl/firecrawl-workflows --path skills/firecrawl-qaВручную: положить файлы
.devin/skills/firecrawl-qa/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о firecrawl-qa
Как установить firecrawl-qa в Claude Code?
Выполните npx skills add firecrawl/firecrawl-workflows --skill firecrawl-qa -a claude-code. Файл скилла окажется в ~/.claude/skills/firecrawl-qa/SKILL.md.
Что делает firecrawl-qa?
Обходит живой сайт инструментами Firecrawl и возвращает QA-отчёт: битые ссылки, поведение форм, мобильная вёрстка, загрузка страниц, ошибки в консоли.
Что нужно для работы?
Переменная FIRECRAWL_API_KEY — обязательная, запросы идут на hosted Firecrawl. Без ключа скилл не запустит ни одного тестера.
Исходный текст
SKILL.md · ISC
---
name: firecrawl-qa
description: "Test a live website with Firecrawl browser and write up what's broken: links, forms, mobile layout, performance and console errors. Use for pre-launch checks, bug hunts or confirming a deployed site works."
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 QA
Use this to test a live site and return a unified QA report.
## Onboarding Interview
Infer the URL, QA focus, and output format from context. If the target URL is clear, proceed immediately.
Ask at most 1-3 concise questions only if blocked, such as the URL, the focus area, or credentials/constraints for protected flows.
## Firecrawl Collection Plan
Use Firecrawl map to discover pages. Use Firecrawl browser for interactions, forms, navigation, and responsive/manual checks when available. Use scrape for page content and link extraction.
## Parallel Work
If appropriate, use sub-agents or equivalent parallel task runners:
- Full: Navigation and Links, Forms and Interactions, Content and Visual, Error States.
- Forms: Form Discovery, Happy Path, Edge Cases, Validation.
- Navigation: Sitemap, Nav Testing, Link Checker, Routing.
- Responsive: Desktop, Tablet, Mobile, Interaction.
- Performance: Page Load, Asset Audit, Content Efficiency, Comparison.
Each tester should return severity, URL, description, evidence, and reproduction steps.
## Final Deliverable
```markdown
# QA Report: [Site]
## Summary
- Health score: [x/10]
- Pages tested: [count]
- Issues found: [critical/major/minor]
## Critical Issues
[C-1] URL | Description | Steps to reproduce | Expected vs actual
## Major Issues
[M-1] URL | Description | Steps to reproduce
## Minor Issues
[m-1] URL | Description
## Positive Observations
[What works well]
## Pages Tested
[URLs]
## Agent/Test Summary
[Who tested what]
## Rerun Inputs
workflow: firecrawl-qa
url: [url]
focus: [full/forms/navigation/responsive/performance]
```
## Quality Bar
- Include reproduction steps for functional issues.
- Do not report speculative bugs without evidence.
- Deduplicate findings across testers.
© firecrawl · ISC · firecrawl/firecrawl-workflows
