[[부록13_Firecrawl_회원가입_및_API_키_발급_가이드|부록 13]]. Firecrawl 회원가입 및 API 키 발급 가이드
[!abstract] Firecrawl 회원가입, API 키 발급, n8n Credential 등록, 테스트 호출까지 안내합니다. 이 가이드를 따라하면 n8n 워크플로에서 웹페이지를 클린 마크다운으로 자동 수집할 수 있게 되죠.
n8n에서 Firecrawl 노드를 사용하려면 먼저 Firecrawl 웹사이트에서 회원가입을 하고 API 키를 발급받아야 합니다. Firecrawl은 웹페이지를 클린 마크다운으로 변환해주는 API 서비스로, n8n 워크플로에서 웹 데이터를 수집할 때 매우 유용합니다.
이 부록은 다음 내용을 다룹니다.
- Firecrawl이란 무엇인가?
- Firecrawl vs HTTP Request vs Puppeteer 비교
- 무료 티어 안내
- 회원가입 및 API 키 발급
- n8n Credential 등록
- Firecrawl 노드 사용 시 참고 정보
[!tip] 7.1.2 경쟁사 블로그 모니터링 실습에서 오셨나요? 7.1.2 섹션의 워크플로 실습을 위해 이 가이드를 보고 계신다면, 아래 항목을 순서대로 모두 완료한 뒤 돌아가세요.
순서 완료할 항목 비고 1 Firecrawl 회원가입 Google/GitHub 계정으로 간편 가입 2 API 키 발급 Dashboard에서 즉시 확인 가능 3 n8n Credential 등록 Firecrawl API 노드에서 설정 4 테스트 호출 Scrape 동작 확인 4단계까지 완료하고 스크래핑 결과가 정상 출력되면 준비 끝입니다. [[Day28_07.1.2_Firecrawl과_Text_Manipulation_실전_활용]]으로 돌아가세요.
Firecrawl이란?
Firecrawl은 웹페이지 URL을 입력하면 LLM이 바로 활용할 수 있는 클린 마크다운으로 변환해주는 웹 스크래핑 API 서비스입니다. 내비게이션 메뉴, 광고, 푸터 등 불필요한 요소를 자동으로 제거하고, 본문 콘텐츠만 깔끔하게 추출합니다.
| 항목 | 내용 |
|---|---|
| 핵심 기능 | 웹페이지 → 클린 마크다운 변환 |
| 비용 | 무료 티어 제공 (월 500 크레딧) |
| 인증 방식 | API Key (HTTP 헤더) |
| 가입 조건 | Google 또는 GitHub 계정 |
| n8n 노드 | @mendable/n8n-nodes-firecrawl (커뮤니티 노드, GitHub) |
💡 왜 Firecrawl을 사용할까요? n8n의 HTTP Request 노드로도 웹페이지를 가져올 수 있지만, 가져온 결과는 HTML 태그가 가득한 원시 코드입니다. 이것을 사람이나 AI가 읽을 수 있는 형태로 정리하려면 복잡한 파싱 작업이 필요합니다. Firecrawl은 이 과정을 API 호출 한 번으로 해결합니다.
Firecrawl vs HTTP Request vs Puppeteer
웹에서 데이터를 가져오는 세 가지 방법을 비교해 봅시다.
| 구분 | HTTP Request | Puppeteer | Firecrawl |
|---|---|---|---|
| 유형 | 빌트인 노드 | 커뮤니티 노드 | 커뮤니티 노드 |
| 출력 형식 | 원시 HTML | HTML / PDF / 스크린샷 | ==클린 마크다운== |
| JavaScript 렌더링 | X | O | O |
| 추가 설치 | 없음 | Chromium 브라우저 필요 | 없음 (API 호출) |
| 설정 난이도 | 쉬움 | 어려움 (Docker 설정 필요) | ==쉬움 (API 키만 필요)== |
| 비용 | 무료 | 무료 | 무료 티어 (월 500회) |
| 적합한 상황 | API 응답 수신, 간단한 페이지 | PDF 생성, 스크린샷 캡처 | ==웹 콘텐츠 수집, AI용 데이터 준비== |
📌 핵심 학습: Firecrawl의 가장 큰 장점은 별도 소프트웨어 설치 없이 API 호출만으로 클린 마크다운을 얻을 수 있다는 점입니다. Puppeteer는 Chromium 브라우저를 설치해야 하고 Docker 환경에서 추가 설정이 필요하지만, Firecrawl은 API 키 하나로 바로 사용할 수 있습니다.
무료 티어 안내
Firecrawl은 무료(Free) 플랜을 제공하며, 신용카드 등록 없이 바로 사용할 수 있습니다.
| 항목 | Free 플랜 | Hobby 플랜 | Standard 플랜 |
|---|---|---|---|
| 월 크레딧 | 500 | 3,000 | 100,000 |
| 비용 | $0 | $16/월 | $83/월 |
| 동시 스크래핑 | 2 | 10 | 50 |
| 속도 | 기본 | 기본 | 우선 처리 |
💡 크레딧이란? 1 크레딧 = 1회 스크래핑(Scrape) 호출입니다. 월 500 크레딧이면 매일 약 16페이지를 스크래핑할 수 있습니다. 이 책의 실습에서는 URL 3개만 사용하므로 무료 티어로 충분합니다.
회원가입
- 웹 브라우저에서 https://www.firecrawl.dev 에 접속합니다.
- 우측 상단의 Log in 버튼을 클릭합니다.
- Google 계정 또는 GitHub 계정으로 간편 가입합니다.
- 별도의 이메일 인증 과정이 없어 즉시 가입이 완료됩니다.
- 가입 후 자동으로 Dashboard 화면으로 이동합니다.
![[그림부록13-1.png]] [그림부록13-1] Firecrawl 메인 페이지 — 우측 상단 Log in 클릭
![[그림부록13-2.png]] [그림부록13-2] 로그인 화면 — Google 또는 GitHub 계정으로 간편 가입
API 키 발급
Dashboard에 접속하면 API 키를 바로 확인할 수 있습니다.
- 가입 후 자동으로 이동되는 Dashboard 화면에서 좌측 메뉴를 확인합니다.
- 좌측 메뉴에서 API Keys (또는 Overview 페이지 상단)를 클릭합니다.
- 기본으로 생성된 API 키가 표시됩니다. Copy 버튼을 클릭하여 복사합니다.
- 복사한 API 키를 안전한 곳에 저장합니다.
![[그림부록13-3.png]] [그림부록13-3] Firecrawl Dashboard Overview 화면
![[그림부록13-4.png]] [그림부록13-4] API Keys 페이지 — API Key 확인 및 Copy 버튼 클릭
⚠️ 주의: API 키는 비밀번호와 같습니다. 외부에 공유하거나 코드에 직접 넣지 마세요. n8n의 Credential에 안전하게 저장하여 사용합니다.
API 키 형식은 fc- 접두사로 시작합니다. 예: fc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
n8n Credential 등록
발급받은 API 키를 n8n에 등록하여, Firecrawl 노드에서 바로 사용할 수 있도록 설정합니다.
⚠️ 사전 확인: Firecrawl 커뮤니티 노드(
@mendable/n8n-nodes-firecrawl)가 설치되어 있어야 합니다. 설치 방법은 [[Day27_07.1.1_커뮤니티_노드_설치와_관리]]의 STEP 3을 참고하세요.
- n8n 캔버스에서 새 워크플로를 생성합니다.
Tab키를 눌러 노드 검색창을 열고 **"Firecrawl"**을 검색합니다.- Firecrawl 노드를 캔버스에 배치하고 더블클릭합니다.
- 설정 패널 상단의 Credential 영역에서 Create New Credential을 클릭합니다.
- API Key 입력란에 방금 복사한 Firecrawl API 키를 붙여넣습니다.
- Save 버튼을 클릭합니다.
![[그림부록13-5.png]] [그림부록13-5] n8n 노드 검색창에서 "Firecrawl" 검색
![[그림부록13-6.png]] [그림부록13-6] Firecrawl Credential 등록 — API Key 입력 및 Save
💡 팁: Credential 이름을
Firecrawl API (Free)처럼 플랜 정보를 포함하여 저장하면, 나중에 여러 Credential을 구분하기 편합니다.
Firecrawl 노드 사용 시 참고 정보
주요 Operation과 응답 구조
n8n의 Firecrawl 노드에서 자주 사용하는 Operation과 그 결과의 핵심 필드를 정리하면 다음과 같습니다.
| Operation | 용도 | 핵심 응답 필드 | n8n 표현식 접근 방법 |
|---|---|---|---|
| Scrape | 단일 URL → 클린 마크다운 변환 | markdown (본문 텍스트), metadata (제목·설명) | {{ $json.markdown }} |
| Crawl | 도메인 전체 크롤링 | 페이지 배열 (각 페이지마다 markdown + metadata) | {{ $json.data[0].markdown }} |
| Map | 사이트의 모든 URL 목록만 추출 | links 배열 | {{ $json.links }} |
📌 Scrape 결과의
markdown필드: 불필요한 내비게이션·광고·푸터가 제거된 본문 텍스트만 포함합니다. AI 노드에 바로 전달하거나 텍스트 처리 워크플로에 그대로 활용할 수 있습니다.
Scrape 호출 예시 설정
| 설정 항목 | 값 |
|---|---|
| Operation | Scrape |
| URL | https://blog.n8n.io/ |
![[그림부록13-7.png]] [그림부록13-7] Manual Trigger → Firecrawl Scrape 노드 연결 예시
정리하며
이 부록의 핵심을 정리하면 다음과 같습니다.
- Firecrawl은 웹페이지 → 클린 마크다운 변환 API: HTTP Request처럼 원시 HTML을 다루지 않아도 되고, Puppeteer처럼 Chromium을 설치할 필요도 없습니다.
- 무료 티어는 월 500 크레딧: 1회 Scrape = 1 크레딧이므로 매일 약 16페이지 처리 가능. 책의 실습에는 충분합니다.
- API 키는
fc-접두사: Dashboard에서 즉시 확인 가능. n8n Credential에 등록해 외부 노출을 막으세요. - 커뮤니티 노드 설치 필수:
@mendable/n8n-nodes-firecrawl을 먼저 설치한 뒤 노드를 사용할 수 있습니다. 설치 방법은 [[Day27_07.1.1_커뮤니티_노드_설치와_관리|7.1.1 커뮤니티 노드 설치와 관리]] 참고. - Scrape 결과는
markdown필드:{{ $json.markdown }}으로 접근하면 광고·푸터 등이 제거된 본문 텍스트를 바로 사용할 수 있습니다.
설정 체크리스트
- Firecrawl 웹사이트 회원가입 완료 (Google 또는 GitHub 계정)
- API 키 발급 및 안전한 곳에 저장 (
fc-접두사) - n8n에 Firecrawl 커뮤니티 노드 설치
- n8n Credential에 API 키 등록 (
Save후 정상 저장 확인)
자주 하는 실수와 해결법
| 증상 | 원인 | 해결법 |
|---|---|---|
| Firecrawl 노드가 검색되지 않음 | 커뮤니티 노드 미설치 | Settings → Community Nodes에서 @mendable/n8n-nodes-firecrawl 설치 |
401 Unauthorized | API 키가 잘못됨 | Firecrawl Dashboard에서 API 키를 다시 복사하여 Credential 수정 |
429 Too Many Requests | 무료 티어 동시 호출 제한 초과 | 잠시 후 다시 시도 (Free 플랜: 동시 2건 제한) |
402 Payment Required | 월 크레딧 소진 | Dashboard에서 사용량 확인, 다음 달까지 대기 또는 플랜 업그레이드 |
| 스크래핑 결과가 비어있음 | 해당 사이트가 봇 차단 중 | 다른 URL로 테스트, 또는 Firecrawl의 JavaScript 렌더링 옵션 활용 |
Credential 저장 후 Invalid 표시 | API 키 앞뒤 공백 포함 | API 키 복사 시 공백이 포함되지 않았는지 확인 |
💡 다음 단계: 카카오톡으로 메시지를 자동 전송하고 싶다면 카카오 개발자 콘솔에서 OAuth 설정이 필요합니다. 다음으로 [[부록14_카카오톡_나에게_보내기_연동_가이드|부록 14. 카카오톡 나에게 보내기 연동 가이드]]를 참고하세요.
