firecrawl-knowledge-ingest — скилл для Claude Code: парсинг
Скилл для сохранения сайтов документации, справочников и баз знаний в markdown или JSON. Работает с динамическим контентом, авторизацией и пагинацией — нужен API-ключ Firecrawl.
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a claude-codeЧто делает firecrawl-knowledge-ingest
Скилл использует браузер Firecrawl для навигации по порталам и извлечения содержимого. Он понимает боковые меню, следует ссылкам пагинации, ждёт загрузки JavaScript и обрабатывает скрытый контент — всё то, что обычный парсер пропустит. На выходе получаешь структурированный JSON или markdown с метаданными: заголовки, разделы, даты обновления, ссылки на исходники.
Для работы нужен API-ключ Firecrawl. Скилл автоматически определяет нужна ли авторизация и какой формат вывода предпочесть. На входе — URL портала, на выходе — папка с файлами или единый документ с полной структурой. Скилл отслеживает прогресс парсинга и фиксирует ошибки доступа.
Презервирует код, таблицы и форматирование, удаляет навигационный шум. Подходит для миграции справок между сервисами, резервной копии документации или переноса контента в knowledge-base агента.
Какие задачи решает
- Выгрузить документацию сайта в локальные файлы для оффлайна
- Собрать справку со всеми разделами, включая скрытый контент
- Нормализовать структуру портала в JSON для загрузки в агента
- Распарсить docs с авторизацией и динамическим контентом
- Перенести контент справки в другой формат или хранилище
Примеры запросов агенту
- Спарси документацию нашего API c firecrawl-knowledge-ingest и сохрани в markdown
- Извлеки всю справку со страницы help.example.com, включая коллапсы и вкладки
- Загрузи базу знаний из портала в JSON для загрузки в контекст агента
Как установить firecrawl-knowledge-ingest
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a claude-code2Вручную: положить файлы
~/.claude/skills/firecrawl-knowledge-ingest/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firecrawl-knowledge-ingest/
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a codex2Вручную: положить файлы
.agents/skills/firecrawl-knowledge-ingest/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a cursor2Вручную: положить файлы
.cursor/skills/firecrawl-knowledge-ingest/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install firecrawl/firecrawl-workflows firecrawl-knowledge-ingest2Вручную: положить файлы
.github/skills/firecrawl-knowledge-ingest/SKILL.md1Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a gemini-cli2Командой платформы
gemini skills install https://github.com/firecrawl/firecrawl-workflows --path skills/firecrawl-knowledge-ingestВручную: положить файлы
.devin/skills/firecrawl-knowledge-ingest/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о firecrawl-knowledge-ingest
Как установить firecrawl-knowledge-ingest в Claude Code?
Выполни npx skills add firecrawl/firecrawl-workflows --skill firecrawl-knowledge-ingest -a claude-code, затем открой ~/.claude/skills/firecrawl-knowledge-ingest/SKILL.md. Скилл готов к использованию.
Что нужно для работы firecrawl-knowledge-ingest?
API-ключ Firecrawl — скилл требует его как обязательный параметр. Ключ используется для обращения к браузеру Firecrawl.
firecrawl-knowledge-ingest работает с авторизацией?
Да, скилл поддерживает парсинг защищённых портальных. Он определяет нужна ли авторизация и соблюдает границы доступа.
Исходный текст
SKILL.md · ISC
---
name: firecrawl-knowledge-ingest
description: "Export documentation portals, help centers and API reference sites into local markdown or JSON with Firecrawl browser, including pages that render with JavaScript, hide content behind collapsible navigation or paginate. Use when the user wants a docs site, help center or support knowledge base saved as files, even without an explicit request to scrape."
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 Knowledge Ingest
Use this when a docs portal needs browser navigation, auth, pagination, or JS rendering.
## Onboarding Interview
Infer the portal URL, output format, auth needs, and page limit from context. If the portal is clear, proceed immediately.
Ask at most 1-3 concise questions only if blocked, such as the portal URL, whether authentication is required, or the desired output format.
## Firecrawl Collection Plan
Use Firecrawl browser to:
- open the portal and inspect navigation
- identify sections, categories, sidebar links, and article URLs
- follow sidebar navigation, next links, pagination, load-more controls, or search
- scrape article content as markdown
- extract metadata such as title, section, last updated date, author, and tags
Try Firecrawl map as a supplement for public URLs, but use browser navigation for auth-gated or JS-heavy content.
## Final Deliverable
```markdown
# Knowledge Ingest: [Portal]
## Summary
[Pages extracted, sections covered, limitations]
## Output
[JSON/markdown/merged file path or content]
## Sections
[Section names and article counts]
## Failed Or Restricted Pages
[Any access/loading issues]
## Sources
[URLs extracted]
## Rerun Inputs
workflow: firecrawl-knowledge-ingest
url: [portal url]
format: [json/markdown/merged]
max_pages: [number]
```
## JSON Shape
Use `source`, `url`, `extractedAt`, `totalArticles`, and `sections[]` with article `title`, `url`, `section`, `content`, and `metadata`.
## Quality Bar
- Preserve code examples, tables, and formatting.
- Strip nav chrome, headers, and footers.
- Track extraction progress and page failures.
- Respect authentication boundaries.
© firecrawl · ISC · firecrawl/firecrawl-workflows