# 사이트 캡처

> 웹 페이지를 휴대폰 너비로 캡처해, 섹션별 스틸을 페이지 순서대로 전체 페이지 이미지, 섹션 목록, 페이지에 적힌 정확한 수치와 함께 가져옵니다.

Source: https://nodaro.ai/ko/docs/nodes/automate/site-capture

**사이트 캡처** 노드는 웹 페이지를 휴대폰에 보이는 그대로 열고, 주요 섹션(히어로, 기능, 가격, 후기)을 한 장씩 스틸로 촬영합니다. 노드는 먼저 페이지를 끝까지 스크롤하므로, 스크롤할 때 나타나는 섹션도 캡처됩니다. 스틸은 페이지 순서대로, 휴대폰 카드 모양으로 나와 영상 화면에 바로 쓸 수 있습니다. 함께 페이지 전체를 담은 이미지 한 장, 섹션 목록, 가격·개수·평점처럼 페이지에 적힌 정확한 수치도 반환합니다.

## 사용 시기
- 실제 제품 페이지를 영상에 보여 줍니다. 예를 들어 토킹 헤드 클립 위에 카드로 올립니다.
- 페이지의 각 섹션을 스틸마다 한 번씩 설명하거나 애니메이션으로 만듭니다.
- 페이지를 슬라이드쇼나 콜라주로 만듭니다.
- 스크린샷에서 옮겨 적는 대신 페이지의 정확한 가격과 수치를 대본에 가져옵니다.

## 빠른 시작
### 노드 추가하기
캔버스에서 Tab을 누르고 **자동화 › 콘텐츠 가져오기 › 사이트 캡처**를 선택합니다.

### 페이지 입력하기
**페이지**에 브라우저에 입력하듯 페이지 주소를 입력합니다. `https://`는 생략해도 됩니다. 또는 **페이지**를 비워 두고, 주소가 담긴 텍스트 노드를 **페이지 URL** 입력에 연결합니다.

### 실행하기
**실행**을 클릭합니다. 캡처는 보통 1분 안에 끝나며, 길어도 몇 분이면 끝납니다. 실행하는 동안 노드에 경과 시간이 표시되며, 실행을 멈출 수 있습니다. 스틸이 노드에 나타납니다.

### 스틸 사용하기
**스틸** 출력을 다음 노드에 연결합니다. 연결을 **개별**로 설정하면 스틸마다 다음 노드가 한 번씩 실행되고, **묶음**으로 설정하면 모든 스틸이 한 번에 전달됩니다.

## 설정
| 설정 | 기본값 | 설명 |
| --- | --- | --- |
| **페이지** | 비어 있음 | 캡처할 페이지입니다. 비어 있으면 **페이지 URL** 입력에 연결된 텍스트에서 첫 번째 웹 주소를 사용합니다. |
| **스틸** | 8 | 목표로 하는 섹션 스틸 수로, 3~8입니다. 섹션이 적은 페이지는 더 적게 나옵니다. |

## 입력
| 입력 | 필수 | 연결할 항목 |
| --- | --- | --- |
| **페이지 URL** | 아니요 | 페이지 주소가 담긴 텍스트입니다. 예를 들어 [텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드입니다. 주소 [목록](https://nodaro.ai/docs/nodes/automate/list)을 연결하면 주소마다 한 번씩 실행됩니다. |

## 출력
| 출력 | 전달하는 내용 |
| --- | --- |
| **스틸** | 섹션 스틸을 페이지 순서대로 전달합니다. 일반 연결은 첫 번째 스틸을 전달합니다. **개별** 연결은 스틸마다 다음 노드를 한 번씩 실행하고, **묶음** 연결은 모두를 전달합니다. 전체 페이지 이미지는 스틸에 포함되지 않습니다. |
| **JSON** | 캡처 전체입니다. 전체 페이지 이미지, 스틸, 텍스트가 담긴 섹션 목록, 페이지의 정확한 수치(`facts`), 경고가 들어 있습니다. `facts`처럼 일부만 꺼내려면 [필드 추출](https://nodaro.ai/docs/nodes/automate/extract-field)을 사용하세요. |

JSON 출력은 다음과 같은 모양입니다(일부 생략).

```json
{
"finalUrl": "https://www.example.com/",
"title": "Example: the product",
"fullPage": { "url": "https://…/full.jpg", "width": 412, "height": 6420 },
"stills": [{ "index": 0, "label": "Ship faster", "category": "hero", "url": "https://…/0.png" }],
"sections": [{ "order": 0, "label": "Ship faster", "category": "hero", "text": "…", "stillIndex": 0 }],
"facts": ["$12 per month", "4.8/5", "10,000 teams"],
"warnings": []
}
```

섹션의 `category`는 `hero`, `feature`, `pricing`, `proof`, `faq`, `cta`, `other` 중 하나입니다.

## 크레딧
스틸 수와 관계없이 캡처 한 번에 11크레딧입니다.

- **실패한 캡처는 환불됩니다.** 방문을 차단한 페이지, 아무것도 표시되지 않는 페이지, 연결할 수 없는 페이지, 시간이 초과된 캡처가 해당합니다.
- **요금이 청구되기 전에 거절되는 페이지도 있습니다.** 자동 방문을 피해 달라고 요청한 사이트(robots.txt)의 페이지나 존재하지 않는 주소입니다.

셀프 호스팅 설치에서는 [공급자 키](https://nodaro.ai/docs/self-hosting/provider-keys)에서 설명하는 웹 스크래핑용 키나 [Nodaro Cloud 연결](https://nodaro.ai/docs/self-hosting/cloud-connect)이 필요합니다. 설치에서 캡처를 끌 수도 있으며, 그러면 노드가 표시되지 않습니다.

## 팁
- **정확한 수치를 사용하세요.** 페이지의 가격과 수치를 JSON 출력의 `facts`에서 가져오면 대본이 이미지에서 잘못 읽을 일이 없습니다.
- **필요한 스틸만 고르세요.** 스틸마다 `category`가 있어서 히어로와 가격만 남기는 식으로 쓸 수 있습니다.
- **스틸은 라이브러리에 남습니다.** 저장하기 전까지는 미디어 선택기에 나타나지 않습니다.

## 문제 해결
| 문제 | 원인과 해결 |
| --- | --- |
| "blocked" 메시지와 함께 캡처가 실패합니다. | 사이트가 자동 방문에 챌린지 페이지를 보여 주거나 방문을 거부합니다. 그 사이트는 직접 찍은 스크린샷을 업로드하세요. |
| 스틸이 **스틸** 값보다 적습니다. | 페이지의 섹션이 적거나, 섹션이 빈 화면으로 나왔거나, 섹션의 제목이 화면에 나타나지 않았습니다. 이런 섹션은 건너뛰며, JSON 출력의 `warnings`에 나옵니다. |
| 스틸에 쿠키나 앱 배너가 찍혀 있습니다. | 노드는 알아볼 수 있는 쿠키 알림을 숨기지만, 사이트 자체의 배너는 남을 수 있습니다. 다른 스틸을 고르거나 다음 노드에서 잘라 내세요. |

## API에서 사용
`POST /v1/site-capture`에 `{ "url": "…", "maxStills": 8 }`을 보내면 같은 캡처를 코드에서 실행할 수 있습니다. 응답은 바로 `jobId`로 돌아오며, 완료된 작업의 캡처는 `GET /v1/jobs/:id`로 읽습니다. [단일 노드 실행](https://nodaro.ai/docs/developers/api/nodes)과 [작업](https://nodaro.ai/docs/developers/api/jobs)을 참고하세요.

## 자주 묻는 질문

### 사이트 캡처 노드는 무엇을 반환하나요?

히어로, 기능, 가격 등 페이지 섹션의 스틸을 최대 8장, 페이지 순서대로 반환합니다. 모두 휴대폰 카드 모양입니다. 함께 페이지 전체를 담은 이미지 한 장, 페이지 섹션 목록, 가격이나 평점처럼 페이지에 적힌 정확한 수치도 반환합니다.

### 사이트 캡처는 크레딧이 얼마나 드나요?

스틸 수와 관계없이 캡처 한 번에 11크레딧입니다. 페이지가 자동 방문을 차단한 경우처럼 실패한 캡처는 환불됩니다.

### 요청한 것보다 스틸이 적게 나오는 이유는 무엇인가요?

스틸 값은 상한입니다. 섹션이 적은 페이지는 스틸도 적게 나오고, 빈 화면으로 나온 스틸은 건너뜁니다. 건너뛴 섹션은 JSON 출력의 warnings에 나옵니다.

### 한 번 실행으로 여러 페이지를 캡처할 수 있나요?

네. 주소를 목록 노드에 넣고 페이지 URL 입력에 연결하세요. 노드가 주소마다 한 번씩 실행됩니다.

### 일부 사이트에서 캡처가 실패하는 이유는 무엇인가요?

챌린지 페이지로 자동 방문을 막거나 오류로 응답하는 사이트가 있습니다. 이 경우 노드는 그 이유와 함께 실패하고 크레딧을 환불합니다. 이런 사이트는 직접 찍은 스크린샷을 업로드하세요.