firecrawl/cli

Firecrawl CLI and agent skills: web search, scraping, crawling and browser interaction from your terminal or any coding agent. Firecrawl is the most complete web data API for AI agents.

🔥 Firecrawl CLI – 무엇인가

Firecrawl CLI는 터미널에서 직접 Firecrawl 플랫폼과 상호 작용할 수 있는 명령줄 도구입니다. Firecrawl은 AI 기반 웹 스크래핑, 검색 및 연구 서비스로, 다음 기능을 수행할 수 있습니다:

웹 페이지 크롤링 및 스크래핑 (JavaScript 렌더링 사이트 포함)
하이라이트된 스니펫을 사용한 웹 검색
전문화된 개발자 코드 인덱스 및 방대한 연구 논문 인덱스 쿼리
SEO 감사, 잠재 고객 목록 생성 또는 지식 베이스 구축과 같은 상위 수준의 '에이전트 작업' 실행

이 CLI는 이러한 모든 기능을 간단한 명령(scrape, search, developer, research 등)으로 통합하며, 지원되는 AI 코딩 에이전트(Claude Code, Cursor, OpenHands 등)가 Firecrawl을 자동으로 사용하는 방법을 가르치는 스킬을 설치할 수 있습니다.

빠른 시작 및 설치

# npm을 통한 전역 설치
npm install -g firecrawl-cli

# CLI 설치, 로그인 및 감지된 모든 AI 코딩 에디터에 스킬을 등록하는 한 줄 명령
npx -y firecrawl-cli@latest init -y --browser

-y – 비대화형으로 설정을 실행합니다.
--browser – OAuth 스타일 로그인을 위한 브라우저 창을 엽니다.
스킬은 --agent로 범위를 지정하지 않는 한 감지된 모든 '하니스'(Claude Code, Cursor 등)에 자동으로 추가됩니다.

핵심 명령

명령	기능	일반적인 옵션
`scrape <url>`	페이지에서 콘텐츠를 가져옵니다. 기본적으로 Markdown을 반환하지만 원시 HTML, JSON, 이미지, 스크린샷 또는 AI 생성 요약을 출력할 수도 있습니다.	`--format <list>`, `--html`, `--summary`, `--only-main-content`, `--screenshot`, `--output <file>`
`search "query"`	웹 검색(Google 스타일)을 실행합니다. 선택적으로 하이라이트를 포함하거나 반환된 페이지를 한 단계로 스크래핑할 수 있습니다.	`--limit`, `--sources web
`developer "query"`	Developer Index를 검색합니다. 공개 저장소, GitHub 이슈, PR, README 및 문서의 큐레이션된 컬렉션입니다. 프로그래밍 질문 답변에 이상적입니다.	`--limit`, `--json`, `--pretty`
`research …`	Research Paper Index(약 4,300만 개의 초록, 주로 생물의학 및 arXiv)를 쿼리합니다. 의미론적 검색, 논문 검사, 인용 그래프 확장 및 특정 구절 읽기를 지원합니다.	하위 명령: `search-papers`, `inspect-paper`, `related-papers`, `read-paper`, `search-github`
`login`	OAuth 로그인을 위해 브라우저를 열거나 `--api-key`를 통해 API 키를 허용합니다.
`setup …`	AI 코딩 에이전트에 스킬(CLI 기본 요소, 빌드 SDK 도우미, 워크플로우 레시피)을 설치하거나 에디터 내에서 MCP(Multi-Client Provider) 서버를 구성합니다.

스킬 및 에이전트 통합

Firecrawl은 AI 코딩 에이전트에 다음 방법을 가르치는 스킬(firecrawl/skills) 카탈로그를 제공합니다:

실시간 웹 작업을 위해 CLI 사용하기.
즉시 사용 가능한 결과물(SEO 감사, 잠재 고객 목록, 연구 요약 등) 생성하기.

일괄 설치:

firecrawl setup core      # 기본 스크래핑/검색/크롤링 기본 요소
firecrawl setup build    # SDK 스타일 통합 도우미
firecrawl setup workflows# 엔드투엔드 레시피

단일 하니스를 대상으로 지정:

firecrawl setup core --agent codex

setup defaults 명령을 사용하면 Firecrawl을 특정 에이전트의 기본 웹 공급자로 설정하여 에이전트의 기본 fetch 구현을 재정의할 수 있습니다.

인증 및 자체 호스팅

첫 실행 시 로그인(브라우저 또는 수동 API 키)을 요청합니다.
환경 변수 FIRECRAWL_API_KEY를 설정할 수도 있습니다.
자체 호스팅 인스턴스의 경우 --api-url <url>(또는 FIRECRAWL_API_URL)을 제공하십시오. 사용자 지정 URL을 사용하면 CLI가 인증을 건너뛰어 키 없이 로컬 개발이 가능합니다.

워크플로우 예시

Markdown으로 일회성 스크래핑

firecrawl https://example.com -o page.md

검색 후 상위 5개 결과를 JSON으로 자동 스크래핑

firecrawl search "AI agents" --scrape --scrape-formats markdown,links --json -o results.json

CRISPR에 관한 생물의학 논문을 찾고 특정 주장 읽기

firecrawl research search-papers "CRISPR base editing" --limit 10
firecrawl research read-paper doi:10.1016/j.neunet.2025.108095 \
    --question "What was the sample size?"

Cursor 에디터에만 Firecrawl 스킬 추가

firecrawl init --agent cursor
firecrawl setup skills --agent cursor

대상 사용자

개발자: 자체 크롤러를 작성하지 않고도 안정적인 웹 스크래핑이나 검색이 필요한 애플리케이션을 구축하는 분.
AI 에이전트(Claude Code, Cursor, OpenHands 등): 실시간 웹 데이터를 가져오기 위한 플러그인이 필요한 에이전트.
연구원: 수백만 개의 논문 초록에 빠르게 의미론적으로 접근하려는 분.
제품 팀: 워크플로우 스킬을 통해 SEO 감사, 잠재 고객 생성 또는 지식 베이스 구축을 자동화하려는 팀.

결론

Firecrawl CLI는 강력한 AI 기반 웹 데이터 서비스를 위한 터미널 친화적인 얇은 래퍼입니다. 인증을 처리하고 풍부한 출력 형식을 제공하며, 재사용 가능한 '스킬'로 AI 코딩 에이전트를 확장할 수 있어 에이전트가 사용자 지정 코드 없이도 실시간 웹 콘텐츠를 가져오고, 스크래핑하고, 추론할 수 있게 합니다.