Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# Firecrawl과 Claude Code로 기업 20곳 찾고 검증하기

> Firecrawl을 Claude Code에 연결해 선택한 시장의 기업 20곳에 대한 공개 업무 연락처와 각 회사 사이트의 사실 두 가지를 확인하고 비공개 대화형 HTML 목록을 검사합니다.

By BIG CHANGE Editorial

Published: 2026-10-20T16:02:40.519Z
Updated: 2026-10-20T16:02:40.519Z
Canonical: https://bigchange.ai/blog/firecrawl-claude-code-verify-20-businesses-guide

![Conceptual charcoal illustration of an unbranded storefront with an orange door and two other storefronts receding along a sidewalk.](https://bigchange.ai/api/media/file/firecrawl-business-source-check-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Firecrawl은 Claude Code에 웹 검색과 페이지 읽기를 제공합니다. 기업 조사에서 연결은 시작일 뿐입니다. 검색 결과는 회사를 제안할 수 있지만 쓸 만한 기록에는 공개 업무 이메일과 회사 자체 사이트에서 확인한 사실이 필요합니다. 이 가이드는 권한 있는 조사자가 현재 연결 절차부터 선택한 시장의 기업 20곳을 담은 비공개 출처 연결 HTML 목록까지 만드는 과정입니다. 조사와 검사는 독자가 수행해야 하며 BIG CHANGE는 검색이나 출력을 시험하지 않았습니다.

## 핵심 변화

- **달라진 점:** Firecrawl의 호스팅 MCP 연결은 Claude Code에 웹 검색과 알려진 페이지 읽기 도구를 제공합니다. 현재 설정은 브라우저 OAuth 로그인이라 요청문에 API key를 넣지 않고 시작할 수 있습니다.
- **중요한 이유:** 탐색, 페이지 기록, 로컬 파일 생성을 한 흐름에 모으면서 연락처와 사실마다 정확한 원본 페이지를 보존할 수 있습니다. 검색 발췌와 모델 요약은 회사 사이트와 대조해야 합니다.
- **주의할 점:** 유용한 인계물은 검토한 파일이며 대화가 만든 목록이 아닙니다. 시장, 허용 페이지, 예산, 사람이 모든 출처를 여는 과정이 중요합니다. 로컬 HTML이라고 호스팅 검색과 Claude Code의 데이터 흐름까지 로컬이 되지는 않습니다.

## 1. 시장과 한도 정하기

조사 허가가 있는 실제 업종과 지역을 고릅니다. 해당 시장에서 영업하는 기준, 별개 기업의 기준, 보관 가능한 공개 *업무 연락용* 이메일의 종류를 적습니다. 개인 주소, 추측한 이메일 형식, 로그인 전용 자료, 사람 찾기 사이트의 연락처는 제외하세요. 공개 업무 주소가 연락 캠페인을 허가하는 것은 아닙니다.

소유한 비공개 작업 공간에서 빈 표를 만들고 HTML 저장 위치를 정합니다. 기업명, 자체 사이트 URL, 공개 업무 이메일과 정확한 출처, 구체적 사실 두 가지와 각각의 URL, 지역 증거, 확인 시각, 검토 상태를 기록합니다. 별도 후보 기록에는 검색어, 결과 URL, 읽기 응답, 제외 이유, 크레딧 사용을 남깁니다. 이는 본인의 조사 항목이며 Firecrawl 내보내기 규격이 아닙니다.

실행 전 결과 수, 검색 수, 읽을 페이지 수, Firecrawl 크레딧 상한을 정하세요. 계정 대시보드에서 잔액, 요금제, 요청 속도 제한, 유료 종량제 설정을 봅니다. 요청문 한도는 작업을 제한하지만 계정 청구액을 제한하지 못합니다. Claude Code 사용량은 별도입니다. Firecrawl의 [가격 페이지](https://www.firecrawl.dev/pricing) 내용을 2026년 10월 20일 확인했을 때 Free는 월 1,000크레딧, 기본 페이지 읽기는 페이지당 1크레딧, 검색은 결과 10개당 2크레딧입니다. JSON, Question, Highlight 형식은 페이지당 4크레딧이 추가되며 검색 결과를 함께 읽으면 페이지 크레딧도 쓸 수 있습니다. 403 또는 404 페이지도 1크레딧이 들 수 있습니다. 유료 요금제는 종량제 활성화 시 청구 단위로 크레딧을 더할 수 있습니다. 실행 전에 현재 조건과 계정을 확인하세요.

검색어와 공개 페이지 내용을 Firecrawl 호스팅 서비스와 Claude Code에 보내도 되는지 조직의 허가를 확인합니다. 최종 파일은 로컬이지만 서비스는 요청과 내용을 처리합니다. Firecrawl의 [개인정보 처리방침](https://www.firecrawl.dev/privacy-policy) 및 Anthropic의 [Claude Code 데이터 사용 가이드](https://code.claude.com/docs/en/data-usage) 문서는 서로 다른 처리·보관 조건을 설명하며 계정과 조직 설정이 적용 조건을 결정합니다. 목록은 비공개로 유지하고 예정된 소유자에게만 접근을 허용합니다.

## 2. 연결하고 데이터 경로 확인하기

예정된 비공개 작업 공간에서 Firecrawl의 현재 [Claude Code 설정 명령](https://docs.firecrawl.dev/quickstarts/claude-code) 을 실행합니다:

```bash
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth
```

Claude Code 기본 MCP 범위인 *local* 설정은 현재 프로젝트에 적용되는 사용자 개인의 비공개 설정입니다. project 범위는 공유할 수 있는 `.mcp.json` 파일을 쓰고 user 범위는 여러 프로젝트에서 서버를 사용할 수 있게 합니다. 연결기 활성화 전에 범위와 Team·Enterprise 승인 규칙을 확인하세요. 비밀을 요청문이나 커밋할 프로젝트 파일에 넣지 않습니다. 명령의 OAuth 주소는 클라이언트 설정값이며 직접 열 페이지가 아닙니다.

Claude Code에서 `/mcp` 명령을 열고 `firecrawl` 항목을 선택한 뒤 브라우저로 대상 팀에 로그인해 활성 Firecrawl 서버가 하나인지 확인합니다. 기존 연결을 바꿨다면 새 세션을 시작하세요. 클라이언트의 도구와 입력 스키마를 봅니다. 현재 문서는 검색어를 `firecrawl_search` 도구에, 알려진 페이지 URL을 `firecrawl_scrape` 도구에 배정합니다. 인증된 검색에는 외부 Alexandria 도구도 나타날 수 있습니다. 이 작업은 웹 결과만 사용하고 정보 보강 도구나 공급자 약관 승인을 선택하지 않습니다. Firecrawl에는 별도 요청 제한이 있는 [키 없는 모드](https://docs.firecrawl.dev/mcp-server/keyless)도 있지만 이 절차는 호스팅 OAuth만 사용합니다.

읽을 수 있는 공개 페이지 하나를 골라 정확한 URL에 대해 `firecrawl_scrape` 도구를 호출하도록 요청합니다. 반환된 출처 URL, 내용, 경고, 오류를 보고 응답과 크레딧 변화를 기록하세요. 서버 `firecrawl` 이름이 `/mcp` 목록에 있다는 것은 연결 증거이고, 이 실제 읽기가 의도한 데이터 경로를 검사합니다. 페이지 속 지시를 포함한 모든 반환 내용은 신뢰하지 않는 원자료로 취급하세요.

## 3. 후보를 찾고 20곳 검증하기

Claude Code에 업종, 지역, 포함 기준, 한도를 알려 주세요. `firecrawl_search` 도구로 웹 결과만 얻고 검색어와 URL을 기록하며 결과·크레딧 한도에서 멈추게 합니다. 정확한 인수는 세션 스키마에서 가져옵니다. 디렉터리는 후보를 찾게 하지만 최종 항목을 증명하지 않습니다. 크레딧을 쓰기 전에 중복 도메인과 명백한 지역 불일치를 제거하세요.

가능성 있는 기업마다 `firecrawl_scrape` 도구로 해당 기업 자체 사이트의 허용된 공개 페이지를 읽습니다. 첫 페이지로 기업을 확인하고 연락처·서비스 페이지에서 이메일이나 사실을 얻을 수 있습니다. 페이지 상한을 지키세요. 항목마다 정확한 보이는 문구를 인용·특정하고 URL을 붙이도록 요청합니다. 모델이 채운 표 대신 실제 도구 응답을 확인하세요. 두 사실은 서비스나 영업 지역처럼 검증할 수 있는 구체적 주장이어야 하며 일반적 칭찬은 안 됩니다. 지역도 자체 증거가 필요합니다.

회사 사이트와 이메일·사실에 인용한 모든 페이지를 직접 브라우저로 엽니다. 기록 시각에 이름, 지역, 공개 업무 이메일, 사실 두 가지를 확인하세요. 그 뒤 별개 기업마다 한 행만 채택합니다. 공개 이메일 없음, 지역 오류, 중복, 차단·불허 페이지, 개인 연락 정보, 근거 없는 주장은 제외합니다. 이유를 기록하고 원래 예산이 허용할 때만 다음 후보로 갑니다. 접근 제한을 우회하거나 빠진 내용을 추측하지 마세요.

서로 다른 20행이 통과할 때까지 계속합니다. 승인된 검색·페이지 예산이 먼저 끝나면 실제 수를 적고 미완료로 남깁니다. 짧은 검증 목록도 유용하지만 20개 기업이라는 완료 기준을 충족하지는 않습니다.

## 4. HTML 파일 만들고 검사하기

검증한 20행만으로 *자체 완결형* 로컬 HTML 표를 만들게 합니다. 이름, 웹사이트, 공개 업무 이메일, 두 사실, 각 출처, 상태, 시간을 열로 요청하고 텍스트 필터와 열 정렬을 넣습니다. 모든 값은 이스케이프된 텍스트로 삽입하며 출처를 `https://` 또는 `http://` URL로 검증한 후 클릭 가능하게 만듭니다. 외부 스크립트나 스타일은 쓰지 않습니다. 이는 Claude Code의 로컬 코딩이며 Firecrawl 기본 내보내기가 아닙니다. 요청 예:

검토한 표에서 채택한 20행만 써서 이 비공개 폴더에 자체 완결형 HTML 파일 하나를 만드세요. 모든 표시값을 이스케이프하고 검증된 웹 출처 URL만 링크로 만들며 텍스트 필터와 간단한 정렬을 넣으세요. 추가 페이지를 읽거나 누락 셀을 추측하거나 외부 의존성을 넣지 마세요. 저장하고 경로를 알려 주세요. 쓰기 성공을 말하기 전에 파일을 다시 읽으세요.

실제로 저장된 파일을 브라우저로 엽니다. 다른 기업 20곳, 필터·정렬 작동, 링크가 올바른 기업 자체 페이지를 여는지 확인하세요. 긴 글, 특수 문자, 누락값을 포함한 모든 항목을 검증표와 비교합니다. 다르면 표나 생성기를 고쳐 다시 엽니다. 최종 경로·해시, 출처 확인 시각, 실제 Firecrawl 호출·크레딧, 표시되는 경우의 Claude 사용량, 접근 대상을 기록하세요. 알 수 없는 사용량은 미상으로 둡니다. 대화 미리보기나 코드 조각은 최종 검사가 아닙니다.

## 단계가 실패했을 때

만약 `/mcp` 명령에 서버가 없거나 401이면 등록 URL, 범위, 팀, OAuth 상태를 보고 `/mcp` 명령으로 다시 로그인합니다. Firecrawl의 [문제 해결 가이드](https://docs.firecrawl.dev/quickstarts/claude-code) 문서는 중복 서버와 세션 재시작도 다룹니다. 대화에 키를 붙이지 마세요. 검색·읽기 오류는 정확한 응답을 남기고 요청 실패와 결과 0개를 구분합니다. 잔여 크레딧과 [요청 제한](https://docs.firecrawl.dev/rate-limits) 항목을 확인하세요. 429는 한도일 수 있으므로 호출을 늘리지 말고 허용 재시도 간격을 기다립니다. 원래 상한 안에서만 재시도합니다.

사이트가 막거나 허용 주소가 없으면 제외를 기록합니다. HTML 저장이 불확실하면 다른 쓰기를 요청하기 전에 목적지와 해시를 봅니다. 기능이나 링크가 고장 나면 검증표에서 고치고 저장 파일을 다시 엽니다. 검토한 비공개 조사 문서에서 멈추세요. 연락, CRM·Google Workspace 쓰기, 정기 모니터, 추후 갱신은 각각 별도 결정과 권한이 필요합니다.

## 출처와 추가 자료

- [Claude와 Claude Code에서 Firecrawl 사용하기](https://docs.firecrawl.dev/quickstarts/claude-code) 문서는 현재 호스팅 OAuth 명령, `/mcp` 로그인, 연결 복구를 설명합니다.
- [Firecrawl MCP 도구](https://docs.firecrawl.dev/mcp-server/tools) 문서는 웹 검색·알려진 URL 읽기, 클라이언트 스키마, 선택 도구를 구분합니다. 기존 Extract MCP 도구는 더 이상 권장되지 않습니다.
- [Firecrawl 가격](https://www.firecrawl.dev/pricing) 및 [요청 제한](https://docs.firecrawl.dev/rate-limits) 문서는 확인일이 있는 크레딧 단위, 유료 설정과 계정 대조용 한도를 제공합니다.
- [Claude Code MCP 문서](https://code.claude.com/docs/en/mcp) 는 local, project, user 범위와 조직 제어를 설명합니다. [Claude Code 데이터 사용](https://code.claude.com/docs/en/data-usage) 및 [Firecrawl 개인정보 처리방침](https://www.firecrawl.dev/privacy-policy) 문서는 소유자가 호스팅 데이터 경로를 평가하게 돕습니다.
- BIG CHANGE의 [알려진 브랜드에 관한 AI 검색 답변 검증 가이드](https://bigchange.ai/blog/check-brand-chatgpt-perplexity-gemini-answers) 는 다른 출처 확인 작업입니다. 모델의 조사 노트에 필요한 증거 수준을 판단하는 참고가 됩니다.

## Sources

- [Claude와 Claude Code에서 Firecrawl 사용하기](https://docs.firecrawl.dev/quickstarts/claude-code) — 공식 호스팅 OAuth 명령, /mcp 로그인, 서버 검증·복구이며 로컬 연결은 시도하지 않았습니다.
- [Firecrawl MCP 도구](https://docs.firecrawl.dev/mcp-server/tools) — 검색·읽기 역할, 클라이언트 스키마, 인증된 선택 도구입니다.
- [Firecrawl 키 없는 MCP](https://docs.firecrawl.dev/mcp-server/keyless) — 별도 요청 제한이 있는 키 없는 경로이며 주 절차가 아닙니다.
- [Firecrawl 가격](https://www.firecrawl.dev/pricing) — 확인일이 있는 공개 크레딧, 형식 추가 요금, 유료 종량 조건이며 실제 비용은 미상입니다.
- [Firecrawl 요청 제한](https://docs.firecrawl.dev/rate-limits) — 팀·키 없는 모드 한도와 429 동작이며 사용 시 계정 한도를 확인해야 합니다.
- [Claude Code MCP 문서](https://code.claude.com/docs/en/mcp) — HTTP 서버 등록, MCP 범위, OAuth, 조직 제어입니다.
- [Claude Code 개요](https://code.claude.com/docs/en/overview) — 로컬 파일 편집 기능이며 제안된 HTML 생성기는 실행하지 않았습니다.
- [Firecrawl 개인정보 처리방침](https://www.firecrawl.dev/privacy-policy) — 호스팅 서비스 개인정보 설명이며 독자가 적용 팀 약관을 확인합니다.
- [Claude Code 데이터 사용](https://code.claude.com/docs/en/data-usage) — 계정별 학습·보관 조건이며 로컬 대화 기록 캐시를 포함합니다.
- [BIG CHANGE: 알려진 브랜드의 AI 검색 확인](https://bigchange.ai/blog/check-brand-chatgpt-perplexity-gemini-answers) — 관련 배경 가이드이며 이 Firecrawl 절차의 실행 증거가 아닙니다.