Install
npx -y firecrawl-cli@latest init -y --browser누구에게 맞나
이 가이드는 로컬 터미널에서 웹 검색, 스크레이핑, 페이지 상호작용, 사이트 크롤링, 사이트맵, 또는 에이전트 작업을 직접 실행해야 하는 사람을 위한 것입니다. 공식 문서는 이를 명령줄 입구이자, 감지된 코딩 에디터에 넣을 수 있는 에이전트 스킬로 함께 적습니다.
공개 페이지를 먼저 본 뒤 코드를 바꿀지 결정하는 일이고, 스크레이핑 서비스를 직접 먼저 만들지 않는다면 이 경로가 더 맞습니다. 공식 설명은 논문과 개발자 자료 검색도 가능하다고 합니다. 그래픽 화면에서 몇 번만 클릭하고 싶고 터미널 명령을 실행할 수 없는 사람에게는 맞지 않습니다. 권장 경로는 명령줄 도구를 설치하고, 로그인을 마친 뒤, 감지된 에디터에 스킬을 씁니다.
공식 저장소는
https://github.com/firecrawl/cli
해당 페이지의 현재 표기만 따르세요. 그 페이지에 없는 설치기나 스킬 디렉터리로 바꾸지 마세요.
3분 만에 첫 시도
공식 권장 경로 하나만 따릅니다.
전제: 터미널에서 npx를 실행할 수 있고, Firecrawl 접근 방법이 이미 준비되어 있어야 합니다. 공식 안내에서는 FIRECRAWL_API_KEY 환경 변수를 설정할 수도 있으며, init에 --browser를 붙이면 브라우저 로그인을 씁니다. 실행 전에 로그인할 계정이 본인 계정인지 확인하고, 기본값이 임시 디렉터리가 아니라 감지된 모든 코딩 에디터에 쓴다는 점을 보세요.
설치 위치: 스킬은 기본적으로 감지된 에디터에 전역으로 들어갑니다. 하나만 대상으로 하려면 공식 표기는 --agent <agent>를 추가하는 것입니다.
복사한 뒤 실행:
npx -y firecrawl-cli@latest init -y --browser
성공 신호: 명령이 정상 종료되고, 이 기기에서 firecrawl을 호출할 수 있으며, 감지된 에디터에 새 스킬이 나타납니다. 아직 사이트 전체를 크롤하지 마세요. 다음으로 되돌릴 수 있는 확인을 하세요: firecrawl setup core를 실행합니다. 공식 설명에 따르면 이 묶음은 scrape, search, crawl, interact 프리미티브와 인덱스형 스킬을 제공하며, skills는 그 별칭입니다. 명령이 받아들여진 뒤, 설치된 에이전트에 읽기 전용 요청을 하세요. 예를 들어 「Firecrawl로 공개 문서 제목을 검색하고, 결과만 보여 주고, 파일은 쓰지 마」입니다. 결과가 보이면 스킬을 찾은 것입니다.
Firecrawl API에 연결하는 앱 통합 스킬이 필요할 때 firecrawl setup build를 실행하세요. 리드 확보나 심층 연구 같은 엔드투엔드 레시피가 필요할 때 firecrawl setup workflows를 실행하세요. 처음에는 core만 설치해 레시피를 한 번에 모두 쓰지 마세요.
사용 사례
사례 1: 현재 에이전트에 검색과 스크레이핑 프리미티브를 더합니다. 공식 작업은 firecrawl setup core이며, scrape, search, crawl, interact 프리미티브와 인덱스 스킬을 설치합니다. 이미 감지된 에디터에서 작업 중이고, 에이전트가 공개 페이지를 먼저 검색하거나 스크레이핑한 뒤 저장소를 바꿀지 결정하길 원할 때 맞습니다. 위의 init을 먼저 끝낸 뒤 core만 설치하세요. 성공하면 대화에서 검색 또는 스크레이핑이 한 번 일어나고 결과 요약이 보여야 합니다. 공식 자료에는 스킬 폴더 경로가 없으므로, 등장하지 않은 디렉터리를 손으로 적지 마세요.
사례 2: 단일 프리미티브가 아니라 완성된 레시피가 필요합니다. 공식 작업은 firecrawl setup workflows이며, 자료에서는 리드 확보와 심층 연구를 예로 듭니다. core가 이미 동작하고, 이제 레시피로 연구하고 싶을 때 맞습니다. init 성공을 확인한 뒤 그 명령을 실행하고, 에디터 하나에만 넣으려면 --agent <agent>를 추가하세요. 성공 신호는 해당 스킬 묶음이 대상 에디터에 나타나는 것입니다. 레시피 내부 단계는 펼쳐져 있지 않으며, 현재 자료로는 「workflows가 설치됨」만 확인할 수 있고 적히지 않은 하위 단계는 채울 수 없습니다.
사용 한계
현재 자료는 터미널 명령, 브라우저 로그인 또는 FIRECRAWL_API_KEY, 그리고 core, build, workflows 세 설치 묶음에서 끝납니다. 반드시 지원해야 하는 언어를 정하지 않았고, 「감지된 에디터」를 배타 목록으로 쓰지도 않았습니다. 기본 설치 범위에서 클라이언트 몇 개만 쓸 수 있다고 추측하지 마세요.
이 npx 초기화를 스킬 파일을 손으로만 복사할 수 있고 일반 명령줄이 없는 환경에 적용하지 마세요. 자료에는 이차 마켓 주소나 예시 비밀값도 없습니다.
init과 setup은 감지된 에디터에 스킬을 쓰며 부작용이 있습니다. 실행 전에 대상 에디터를 확인하고, 실행 후에는 스킬이 나타났는지만 보며, 허가되지 않은 사이트를 바로 통째로 크롤하지 마세요. 스크레이핑, 상호작용, 크롤링은 모두 외부 사이트에 닿으므로, 공개되어 있고 다시 열 수 있는 페이지로 먼저 확인하세요.
FIRECRAWL_API_KEY는 환경 변수 이름이며, 본문에 넣을 예시 비밀값이 아닙니다. 등장하지 않은 하위 명령, 스킬 이름, 설치 경로를 만들지 마세요. 자세한 설명은 공식 저장소를 따릅니다.
https://github.com/firecrawl/cli