firecrawl 에이전트
AI 기반 자율 추출. 에이전트가 사이트를 탐색하고 구조화된 데이터를 추출합니다 (2~5분 소요).
구조화된 레코드나 목록을 위한 자율 추출을 시작하기 전에, firecrawl search alexandria '<필요한 데이터>' 명령어로 기성 워크플로우나 데이터 제공자가 있는지 확인합니다. 일치하는 계약이 있으면 firecrawl list <제공자> <기능> --pretty로 확인하고 firecrawl scrape --alexandria <제공자>/<기능> --options '<입력 JSON>'으로 실행합니다. 해당 계약의 정확한 제공자, 기능 및 입력 필드를 사용합니다. 적합한 도구가 없거나 작업에 자율 탐색이 필요한 경우 에이전트로 계속 진행합니다.
빠른 시작
# 구조화된 데이터 추출
firecrawl agent "모든 가격 계층 추출" --wait --json -o .firecrawl/pricing.json
# JSON 스키마로 구조화된 출력
firecrawl agent "제품 추출" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json
# 특정 페이지에 집중
firecrawl agent "기능 목록 가져오기" --urls "<url>" --wait --json -o .firecrawl/features.json
전체 옵션 목록은 firecrawl agent --help를 실행하세요.
완료 조건: 출력 파일에 요청에 응답하는 유효한 JSON이 포함되거나, 추후 폴링을 위해 작업 ID가 의도적으로 반환되었을 때.
Alexandria 제공자
연결된 Alexandria 데이터 제공자는 다음 Alexandria 플래그 중 하나로 시작할 때만 사용됩니다: --alexandria, --toolkits <슬러그> (최대 5개), --max-calls <n>, --require-approval, 또는 --on-terms-required skip|ask. 해당 스레드의 후속 작업은 이 설정을 유지합니다.
firecrawl agent "<회사>의 영업 책임자 찾기" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json
--require-approval (--mode chat 필요)을 사용하면 유료 호출 대신 pendingApproval로 실행이 종료될 수 있습니다. 사용자에게 물어본 후, 같은 스레드에서 firecrawl agent "<후속 프롬프트>" --thread <threadId> --mode chat --approve <approvalId> (또는 --decline <approvalId>)로 응답합니다. terms 승인은 조직 관리자가 Firecrawl 대시보드에서 제공자의 약관을 수락한 후에만 계속됩니다. 사용자에게 https://www.firecrawl.dev/app/settings?tab=data-sources 링크를 제공하고, 사용자가 약관을 먼저 검토하려면 firecrawl alexandria terms show <제공자>를 사용하세요. 승인이 약관을 수락하는 것은 아닙니다.
작업 ID
--wait를 생략하면 작업 ID가 반환됩니다. UUID 형식의 위치 인수는 자동으로 상태 확인으로 감지됩니다:
# 한 번 확인 (--status 추가와 동일)
firecrawl agent "<job-id>"
# 기존 작업 대기, 10초마다 폴링, 최대 5분
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300
# 활성 작업 취소
firecrawl agent "<job-id>" --cancel
팁
- 인라인 결과를 원하면
--wait를 사용하고, 나중에 폴링할 작업 ID가 필요할 때만 생략하세요 (작업 ID 참조). - 예측 가능한 구조화된 출력을 위해
--schema를 사용하세요. 그렇지 않으면 에이전트가 자유 형식 데이터를 반환합니다. - 에이전트 실행은 단순 스크래핑보다 더 많은 크레딧을 소모합니다.
--max-credits로 지출을 제한하세요. - 간단한 단일 페이지 추출의 경우
scrape를 사용하는 것이 더 빠르고 저렴합니다.
함께 보기
- firecrawl-scrape — 더 간단한 단일 페이지 추출
- firecrawl-interact — 수동 페이지 상호작용을 위한 스크래핑 + 상호작용 (더 많은 제어)
- firecrawl-crawl — AI 없이 대량 추출
- firecrawl-build-scrape — 구조화된 추출을 여기서 실행하는 대신 앱에 구축
Alexandria 세션 피드백
Alexandria 세션 결과나 제공자/기능 격차를 보고하려면 firecrawl alexandria feedback --rating good|partial|bad --url <웹사이트> --requested-functionality '<필요했던 기능>' --objective '<작업의 근본 목표>' --rationale '<발생한 상황>' --json을 사용하세요. 근거에는 관찰된 결과를 사용합니다. 작업 ID는 필요 없으며, 마지막 Alexandria 검색, 발견 또는 실행 후 20분 이내에 전송해야 합니다. 그렇지 않으면 거부됩니다. 각 제출은 크레딧 1개를 환불하며, 웹사이트당 최대 10개, 팀당 UTC 일별 최대 100개까지 가능합니다. 선택적 --provider-feedback 및 --capability-feedback JSON 배열은 특정 격차를 설명합니다. firecrawl alexandria feedback --help에서 해당 필드를 확인하세요. 제공자가 존재하지만 필요한 기능이 없을 때는 기능 문제 missing_capability를 사용하고, 새로운 기능을 요청하려면 new_capability_request (requestedFunctionality 포함)를 사용하세요.