Nodaro 문서
문서노드 레퍼런스모델템플릿AI 에이전트(MCP)개발자셀프 호스팅리서치비교
자동화

사이트 캡처

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

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

사용 시기

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

빠른 시작

노드 추가하기

캔버스에서 Tab을 누르고 자동화 › 콘텐츠 가져오기 › 사이트 캡처를 선택합니다.

페이지 입력하기

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

실행하기

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

스틸 사용하기

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

설정

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

입력

입력필수연결할 항목
페이지 URL아니요페이지 주소가 담긴 텍스트입니다. 예를 들어 텍스트 노드입니다. 주소 목록을 연결하면 주소마다 한 번씩 실행됩니다.

출력

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

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)의 페이지나 존재하지 않는 주소입니다.

셀프 호스팅 설치에서는 공급자 키에서 설명하는 웹 스크래핑용 키나 Nodaro Cloud 연결이 필요합니다. 설치에서 캡처를 끌 수도 있으며, 그러면 노드가 표시되지 않습니다.

팁

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

문제 해결

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

API에서 사용

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

자주 묻는 질문

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

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

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

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

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

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

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

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

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

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

최종 업데이트

목차