firecrawl-build-interact은(는) 무엇을 하나요?
Firecrawl /interact를 제품 코드에 통합하여 동적 페이지 및 브라우저 작업(스크래핑 후)을 수행합니다. 평범한 /scrape로는 완료할 수 없는 클릭, 양식 작성, 페이지네이션, 인증 인식 흐름 등 다단계 상호작용이 필요한 기능에 사용하세요.
사용 방법
- Firecrawl API 키 설정 - 환경 변수
FIRECRAWL_API_KEY에 API 키를 설정하거나 요청 헤더에 직접 포함시킵니다. - 상호작용 요청 -
POST /interact엔드포인트에sessionId(선택사항)와actions배열을 전송합니다. - 응답 처리 - 반환된
results배열에서 각 액션의 실행 결과를 추출합니다.
요청 예시
curl -X POST https://api.firecrawl.dev/v1/interact \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"sessionId": "abc123",
"actions": [
{"type": "click", "selector": "#submit-button"},
{"type": "type", "selector": "#search-input", "value": "Firecrawl"},
{"type": "wait", "ms": 2000},
{"type": "scroll", "direction": "down", "amount": 500}
]
}'
액션 유형
| 액션 | 설명 | 필수 파라미터 |
|---|---|---|
click | 지정된 선택자의 요소를 클릭 | selector |
type | 지정된 선택자의 요소에 값 입력 | selector, value |
wait | 일정 시간(밀리초) 동안 대기 | ms |
scroll | 페이지를 특정 방향으로 스크롤 | direction, amount(선택) |
screenshot | 현재 페이지 스크린샷 캡처 | 없음 |
응답 형식
{
"success": true,
"data": {
"sessionId": "abc123",
"results": [
{
"action": "click",
"status": "success",
"html": "<html>...</html>"
},
{
"action": "type",
"status": "success",
"html": "<html>...</html>"
}
]
}
}
오류 처리
- 401 Unauthorized: API 키가 유효하지 않거나 누락됨.
FIRECRAWL_API_KEY를 확인하세요. - 400 Bad Request: 액션 배열이 비어있거나 잘못된 액션 유형이 포함됨.
actions필드를 검증하세요. - 500 Internal Server Error: 서버 내부 오류. 잠시 후 재시도하거나 Firecrawl 지원팀에 문의하세요.
보안 모범 사례
- API 키를 코드에 하드코딩하지 말고 환경 변수나 안전한 저장소를 사용하세요.
sessionId를 재사용할 경우, 세션 데이터에 민감한 정보가 포함되지 않도록 주의하세요./interact호출 시 HTTPS를 사용하여 데이터 전송을 암호화하세요.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 REST API 호출이 가능한 모든 AI 에이전트 플랫폼