Firecrawl MCP Server

웹 검색·스크래핑을 도구로 노출하는 MCP 서버

npm install -g firecrawl-mcp

Firecrawl 의 검색·스크래핑·크롤링을 에이전트 도구로 노출하는 공식 MCP 서버입니다. 일반 웹 검색 외에 깃허브 이슈·머지된 PR·README·문서만 모은 코딩 에이전트용 색인을 따로 검색할 수 있습니다. 설치 없이 붙는 무료 호스팅 엔드포인트도 있습니다.

판단

이럴 때 씁니다

  • 에이전트가 최신 웹 정보를 직접 찾아야 할 때
  • 문서 사이트나 블로그를 구조화된 데이터로 긁어와야 할 때
  • 깃허브 이슈·머지된 PR·README 처럼 코딩에 필요한 소스만 좁혀 검색하고 싶을 때
  • 클릭과 이동이 필요한 페이지를 다뤄야 할 때

이럴 땐 쓰지 마세요

  • 파이프라인 안에서 대량으로 긁을 때는 MCP 보다 Crawl4AI 같은 라이브러리가 맞습니다
  • 외부 서비스에 URL 을 보낼 수 없는 환경일 때
  • 이미 가진 문서를 검색하는 것이 목적일 때

차별점

  • 일반 웹 검색과 별개로 코딩 에이전트용 색인을 따로 검색합니다.
  • 클릭과 이동 같은 페이지 조작을 도구로 노출합니다.
  • 재시도와 요청 제한이 서버에 들어 있습니다.
  • 설치 없이 붙는 호스팅 엔드포인트가 있습니다.

워크플로

  1. 01설치 없이 시험하려면 호스팅 엔드포인트를 MCP 클라이언트에 등록합니다.
  2. 02자체 키로 쓰려면 npm install -g firecrawl-mcp 로 서버를 설치합니다.
  3. 03API 키를 환경 변수로 넣고 클라이언트 설정에 서버를 등록합니다.
  4. 04에이전트에게 검색이나 스크래핑을 지시하면 정리된 텍스트가 돌아옵니다.

주요 명령

명령설명
npm install -g firecrawl-mcp서버를 전역 설치합니다.
npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude클라이언트 설정까지 한 번에 잡습니다.

함정

설치 전에 확인하세요

  • 깃허브 릴리스 페이지가 v3.2.1 에서 멈춰 있지만 npm 에는 3.24.0 이 올라와 있습니다. 버전은 npm 을 기준으로 봐야 합니다.
  • 호스팅 무료 티어는 시험용입니다. 실사용에는 자체 키가 필요합니다.
  • 자체 호스팅도 되지만 별도 Firecrawl 인스턴스를 띄워야 합니다.
  • 외부 서비스로 URL 이 나가므로 사내 주소를 넘길 때는 확인이 필요합니다.

비교

Crawl4AI 가 파이썬 코드 안에서 대량 크롤링을 제어하는 라이브러리라면, 이쪽은 에이전트가 대화 도중 쓰는 도구입니다. 파이프라인을 짜서 수천 페이지를 돌릴 것이면 전자가, 에이전트가 필요할 때 몇 페이지를 찾아보게 할 것이면 후자가 맞습니다.

최근 변경

npm 3.24.0 기준으로 코딩 에이전트용 색인 검색이 들어가 깃허브 이슈와 머지된 PR, README, 문서를 따로 찾을 수 있습니다. 페이지 조작 도구와 자율 심층 리서치도 함께 제공합니다.

공식 변경 내역