자료실

부록13_Firecrawl_회원가입_및_API_키_발급_가이드

튜토리얼

부록13_Firecrawl_회원가입_및_API_키_발급_가이드

부록13: Firecrawl 회원가입 및 API 키 발급 가이드 — 회원가입·API 키 발급·n8n Credential 등록·테스트 호출

2026. 05. 07.

[[부록13_Firecrawl_회원가입_및_API_키_발급_가이드|부록 13]]. Firecrawl 회원가입 및 API 키 발급 가이드

📋 개요Firecrawl 회원가입, API 키 발급, n8n Credential 등록, 테스트 호출까지 안내합니다. 이 가이드를 따라하면 n8n 워크플로에서 웹페이지를 클린 마크다운으로 자동 수집할 수 있게 되죠.

n8n에서 Firecrawl 노드를 사용하려면 먼저 Firecrawl 웹사이트에서 회원가입을 하고 API 키를 발급받아야 합니다. Firecrawl은 웹페이지를 클린 마크다운으로 변환해주는 API 서비스로, n8n 워크플로에서 웹 데이터를 수집할 때 매우 유용합니다.

이 부록은 다음 내용을 다룹니다.

  • Firecrawl이란 무엇인가?
  • Firecrawl vs HTTP Request vs Puppeteer 비교
  • 무료 티어 안내
  • 회원가입 및 API 키 발급
  • n8n Credential 등록
  • Firecrawl 노드 사용 시 참고 정보

💡 7.2.1 경쟁사 블로그 모니터링 실습에서 오셨나요?7.2.1 섹션의 워크플로 실습을 위해 이 가이드를 보고 계신다면, 아래 항목을 순서대로 모두 완료한 뒤 돌아가세요.

순서완료할 항목비고
1Firecrawl 회원가입Google/GitHub 계정으로 간편 가입
2API 키 발급Dashboard에서 즉시 확인 가능
3n8n Credential 등록Firecrawl API 노드에서 설정
4테스트 호출Scrape 동작 확인

4단계까지 완료하고 스크래핑 결과가 정상 출력되면 준비 끝입니다. [[Day28_07.2.1_실전_Firecrawl_Search로_AI_트렌드_리서치_자동화]]으로 돌아가세요.

Firecrawl이란?

Firecrawl은 웹페이지 URL을 입력하면 LLM이 바로 활용할 수 있는 클린 마크다운으로 변환해주는 웹 스크래핑 API 서비스입니다. 내비게이션 메뉴, 광고, 푸터 등 불필요한 요소를 자동으로 제거하고, 본문 콘텐츠만 깔끔하게 추출합니다.

항목내용
핵심 기능웹페이지 → 클린 마크다운 변환
비용무료 티어 제공 (월 1,000 크레딧)
인증 방식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 RequestPuppeteerFirecrawl
유형빌트인 노드커뮤니티 노드커뮤니티 노드
출력 형식원시 HTMLHTML / PDF / 스크린샷==클린 마크다운==
JavaScript 렌더링XOO
추가 설치없음Chromium 브라우저 필요없음 (API 호출)
설정 난이도쉬움어려움 (Docker 설정 필요)==쉬움 (API 키만 필요)==
비용무료무료무료 티어 (월 1,000회)
적합한 상황API 응답 수신, 간단한 페이지PDF 생성, 스크린샷 캡처==웹 콘텐츠 수집, AI용 데이터 준비==

📌 핵심 학습: Firecrawl의 가장 큰 장점은 별도 소프트웨어 설치 없이 API 호출만으로 클린 마크다운을 얻을 수 있다는 점입니다. Puppeteer는 Chromium 브라우저를 설치해야 하고 Docker 환경에서 추가 설정이 필요하지만, Firecrawl은 API 키 하나로 바로 사용할 수 있습니다.

무료 티어 안내

Firecrawl은 무료(Free) 플랜을 제공하며, 신용카드 등록 없이 바로 사용할 수 있습니다.

항목Free 플랜Hobby 플랜Standard 플랜
월 크레딧1,0005,000100,000
비용$0$16/월$83/월
동시 스크래핑21050
속도기본기본우선 처리

💡 크레딧이란? 1 크레딧 = 1회 스크래핑(Scrape) 호출입니다. 월 1,000 크레딧이면 매일 약 33페이지를 스크래핑할 수 있습니다. 이 책의 실습에서는 URL 3개만 사용하므로 무료 티어로 충분합니다.

회원가입

  1. 웹 브라우저에서 https://www.firecrawl.dev 에 접속합니다.
  2. 우측 상단의 Log in(Sign up) 버튼을 클릭합니다.
  3. Google 계정 또는 GitHub 계정으로 간편 가입합니다.
    • 별도의 이메일 인증 과정이 없어 즉시 가입이 완료됩니다.
  4. 가입 후 자동으로 Dashboard 화면으로 이동합니다.

[그림부록13-1] Firecrawl 메인 페이지 — 우측 상단 Log in 클릭

API 키 발급

Dashboard에 접속하면 API 키를 바로 확인할 수 있습니다.

  1. 가입 후 자동으로 이동되는 Dashboard 화면에서 좌측 메뉴를 확인합니다.
  2. 좌측 메뉴에서 API Keys (또는 Overview 페이지 상단)를 클릭합니다.
  3. 기본으로 생성된 API 키가 표시됩니다. Copy 버튼을 클릭하여 복사합니다.
  4. 복사한 API 키를 안전한 곳에 저장합니다.

⚠️ 주의: API 키는 비밀번호와 같습니다. 외부에 공유하거나 코드에 직접 넣지 마세요. n8n의 Credential에 안전하게 저장하여 사용합니다.

API 키 형식은 fc- 접두사로 시작합니다. 예: fc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

n8n Credential 등록

발급받은 API 키를 n8n에 등록하여, Firecrawl 노드에서 바로 사용할 수 있도록 설정합니다.

⚠️ 사전 확인: Firecrawl 커뮤니티 노드(@mendable/n8n-nodes-firecrawl)가 설치되어 있어야 합니다. 설치 방법은 [[Day27_07.1.1_커뮤니티_노드_설치와_관리]]의 STEP 3을 참고하세요.

  1. n8n 캔버스에서 새 워크플로를 생성합니다.
  2. N 키를 눌러 노드 검색창을 열고 **"Firecrawl"**을 검색합니다.
  3. Firecrawl 노드를 캔버스에 배치하고 더블클릭합니다.
  4. 설정 패널 상단의 Credential 영역에서 Create New Credential을 클릭합니다.
  5. API Key 입력란에 방금 복사한 Firecrawl API 키를 붙여넣습니다.
  6. 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 호출 예시 설정

설정 항목값
OperationScrape
URLhttps://blog.n8n.io/

정리하며

이 부록의 핵심을 정리하면 다음과 같습니다.

  1. Firecrawl은 웹페이지 → 클린 마크다운 변환 API: HTTP Request처럼 원시 HTML을 다루지 않아도 되고, Puppeteer처럼 Chromium을 설치할 필요도 없습니다.
  2. 무료 티어는 월 1,000 크레딧: 1회 Scrape = 1 크레딧이므로 매일 약 33페이지 처리 가능. 책의 실습에는 충분합니다.
  3. API 키는 fc- 접두사: Dashboard에서 즉시 확인 가능. n8n Credential에 등록해 외부 노출을 막으세요.
  4. 커뮤니티 노드 설치 필수: @mendable/n8n-nodes-firecrawl을 먼저 설치한 뒤 노드를 사용할 수 있습니다. 설치 방법은 [[Day27_07.1.1_커뮤니티_노드_설치와_관리|7.1.1 커뮤니티 노드 설치와 관리]] 참고.
  5. Scrape 결과는 markdown 필드: {{ $json.markdown }}으로 접근하면 광고·푸터 등이 제거된 본문 텍스트를 바로 사용할 수 있습니다.

설정 체크리스트

  • Firecrawl 웹사이트 회원가입 완료 (Google 또는 GitHub 계정)

  • API 키 발급 및 안전한 곳에 저장 (fc- 접두사)

  • n8n에 Firecrawl 커뮤니티 노드 설치

  • n8n Credential에 API 키 등록 (Save 후 정상 저장 확인)

자주 하는 실수와 해결법

증상원인해결법
Firecrawl 노드가 검색되지 않음커뮤니티 노드 미설치Settings → Community Nodes에서 @mendable/n8n-nodes-firecrawl 설치
401 UnauthorizedAPI 키가 잘못됨Firecrawl Dashboard에서 API 키를 다시 복사하여 Credential 수정
429 Too Many Requests무료 티어 동시 호출 제한 초과잠시 후 다시 시도 (Free 플랜: 동시 2건 제한)
402 Payment Required월 크레딧 소진Dashboard에서 사용량 확인, 다음 달까지 대기 또는 플랜 업그레이드
스크래핑 결과가 비어있음해당 사이트가 봇 차단 중다른 URL로 테스트, 또는 Firecrawl의 JavaScript 렌더링 옵션 활용
Credential 저장 후 Invalid 표시API 키 앞뒤 공백 포함API 키 복사 시 공백이 포함되지 않았는지 확인

💡 다음 단계: 카카오톡으로 메시지를 자동 전송하고 싶다면 카카오 개발자 콘솔에서 OAuth 설정이 필요합니다. 다음으로 [[부록14_카카오톡_나에게_보내기_연동_가이드|부록 14. 카카오톡 나에게 보내기 연동 가이드]]를 참고하세요.

이 자료가 도움이 되셨다면

댓글

댓글을 작성하려면 로그인이 필요합니다.

로그인하기

아직 댓글이 없습니다. 첫 번째 질문을 남겨보세요.