# 추출 실패 메시지별 해결방법

추출에 실패한 경우, 스크린샷에 어떤 화면이 표시되는지를 기준으로 원인을 파악하고, 적합한 해결 방법을 안내받으실 수 있습니다. 다음 단계를 따라 문제를 해결해보세요.

### **✅ Step 1. 추출 실패 직후, 먼저 아래 항목을 점검해 보세요.**

**1. 약간의 시간을 두고 재추출을 시도해 보세요.**

* 대상 사이트의 일시적인 로딩 실패, 서버 오류 등으로 인한 일회성 문제였을 수 있습니다.

  ```
   → 수 분 이상의 간격을 두고 재시도해보세요. 재시도 후에도 같은 문제가 반복된다면, 아래 Step 2에서 
  화면 유형별 가이드를 참고해주세요. 
  ```

**2. 다수의 태스크를 동시에 실행하고 있지는 않나요?**

* 한 번에 많은 태스크를 동시에 실행할 경우, 처리 병목으로 에러가 발생할 수 있습니다.

  → 그룹 추출 중이라면 한 그룹당 URL의 개수를 줄여보세요.

  → 싱글 태스크(스케줄 등록 등)라면 시간차를 두어 처리량을 나눠보는 것이 좋습니다.

**3. 실패가 반복된다면, 에러 코드 또는 스크린샷이 바뀌었는지 확인해 주세요**

* 에러 코드 혹은 표시되는 스크린샷은 재시도 했을 때 이전보다 구체적인 원인을 드러낼 수 있습니다.

  ```
  → 코드나 화면의 메시지가 바뀌었다면, 해당 상황에 맞는 가이드를 Step 2에서 확인해주세요.
  ```

### **✅** Step 2. 에러 스크린샷 속 화면 유형을 선택해 주세요

<figure><img src="/files/zFCMc7JMVJSkULoxQdje" alt=""><figcaption></figcaption></figure>

추출 실패 시, 결과 대신 ‘스크린샷’이 생성됩니다. 이 곳에서는 에러타입 및 **수집기가 대상 URL에 접근했을 때 마주친 화면**이 표시되며, 이를 통해 실패의 원인을 추론해볼 수 있습니다.

**동일한 에러 코드도 스크린샷에 따라 원인이 다를 수 있으므로,** 화면에 표시된 모습이 아래 중 어떤 상황에 가까운지 먼저 확인 후 상황에 맞는 가이드를 따라주세요.

#### <mark style="background-color:$success;">**에러 스크린샷 속 화면 유형 바로가기**</mark>&#x20;

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>접근 차단 메시지가 보입니다.(캡챠, 로봇감지, 권한 확인, 접속 불가 등)</strong></td><td data-object-fit="contain"><a href="/files/cKzGkcDxwX84fVIZxd30">/files/cKzGkcDxwX84fVIZxd30</a></td></tr><tr><td><strong>연결 실패 메시지만 보입니다.</strong></td><td data-object-fit="contain"><a href="/files/i3eof9O8NbOVyC2Cyglk">/files/i3eof9O8NbOVyC2Cyglk</a></td></tr><tr><td><strong>팝업창이 추출 영역을 가리고 있습니다.</strong></td><td data-object-fit="contain"><a href="/files/cLhldOL0AO5cYrdXLs6l">/files/cLhldOL0AO5cYrdXLs6l</a></td></tr><tr><td><strong>로그인 화면이 표시됩니다.</strong></td><td data-object-fit="contain"><a href="/files/qxKt2optbG45IkK7aKy7">/files/qxKt2optbG45IkK7aKy7</a></td></tr><tr><td><strong>아무것도 없는 빈 화면만 보입니다.</strong></td><td data-object-fit="contain"><a href="/files/EBeohjCEj0SCOLkfIrZS">/files/EBeohjCEj0SCOLkfIrZS</a></td></tr><tr><td><strong>본문 콘텐츠만 보이지 않습니다.</strong></td><td data-object-fit="contain"><a href="/files/dv9HBkcwDv9VgITdMRxe">/files/dv9HBkcwDv9VgITdMRxe</a></td></tr><tr><td><strong>[그룹추출] 이상 없는 정상적인 화면이 보입니다.</strong></td><td data-object-fit="contain"><a href="/files/7HJMtpfGv9qfHr36RTZY">/files/7HJMtpfGv9qfHr36RTZY</a></td></tr><tr><td><strong>[스케줄추출] 이상 없는 정상적인 화면이 보입니다.</strong></td><td data-object-fit="contain"><a href="/files/A1H7hNSO1H5IMEELpniF">/files/A1H7hNSO1H5IMEELpniF</a></td></tr><tr><td><strong>에러코드-TimeOutException, TimeLimitExceeded</strong></td><td data-object-fit="cover"><a href="/files/iRIvYJ29elBeRatTy6zP">/files/iRIvYJ29elBeRatTy6zP</a></td></tr><tr><td><strong>에러코드-AutoClickError</strong></td><td><a href="/files/IZmp3vEyuBYkphvPVSv5">/files/IZmp3vEyuBYkphvPVSv5</a></td></tr><tr><td><strong>에러코드-ActionScriptError, ScriptError</strong></td><td><a href="/files/ILDJIn9SI7gDVnJzeshg">/files/ILDJIn9SI7gDVnJzeshg</a></td></tr></tbody></table>

### **✅** Step 3. 위 항목 중 해당되는 상황이 없다면?

위 예시 중 **어느 항목에도 해당하지 않거나**, 에러 스크린샷만으로 원인을 정확히 파악하기 어려운 경우에는 [**hello@listly.io**](mailto:hello@listly.io)로 문의해 주세요.

**문의 시 다음 정보를 포함해주시면 더 빠르고 원활한 상담이 가능합니다.**

1. **데이터보드 실패 화면의 URL을 전달해주세요** 만약 그룹추출이라면 그룹추출 결과화면의 URL을 전달해주셔도 됩니다.
2. **수집 대상 웹페이지에 직접 접속했을 때 보이는 화면을 캡처해 보내주세요.** 국가 설정, 로그인 여부 등 사용자 측 접속 환경과 저희의 접속 환경이 다를 수 있으므로, 어느 위치의 데이터를 수집하려고 했는지(요소/영역)를 캡처 이미지에 표시(박스, 화살표, 주석 등)해주시면 더 정확하게 확인할 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.listly.io/docs/ko/support/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.