> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 노코드 빌더

> 요소를 선택하고 동작을 추가하여 코딩 없이 Octoparse에서 사용자 지정 웹 스크래핑 워크플로를 시각적으로 만들어 보세요.

노코드 빌더를 사용하면 웹사이트와 시각적으로 상호 작용하여 사용자 지정 추출 워크플로를 만들 수 있습니다. 스크래퍼 코드를 작성하는 대신 페이지 요소를 선택하고 클릭, 루프, 페이지 넘기기, 스크롤, 대기, 데이터 추출 등의 워크플로 동작을 추가합니다.

템플릿이나 자동 감지가 대상 웹사이트 또는 데이터 요구 사항에 완전히 맞지 않을 때 사용하세요.

## 처리할 수 있는 시나리오

<Columns cols={2}>
  <Card title="반복 목록 추출">
    검색 결과, 디렉터리, 제품 그리드 또는 표에서 반복 항목을 추출합니다.
  </Card>

  <Card title="상세 페이지 탐색">
    각 항목을 클릭하여 추가 필드를 수집한 다음 목록으로 돌아갑니다.
  </Card>

  <Card title="여러 페이지 탐색">
    여러 페이지로 이동하거나 추가 결과를 로드하거나 스크롤하여 동적 콘텐츠를 표시합니다.
  </Card>

  <Card title="필드 값 사용자 지정">
    필드를 수동으로 선택하고 내보내기 전에 추출한 값을 세부 조정합니다.
  </Card>
</Columns>

다음과 같은 경우 노코드 빌더를 사용하세요.

* 적합한 템플릿이 없는 경우
* 자동 감지가 필드나 페이지 동작을 놓치는 경우
* 워크플로에 상세 페이지가 필요한 경우
* 웹사이트가 사용자 지정 페이지 넘기기 또는 무한 스크롤을 사용하는 경우
* 팝업, 메뉴, 탭 또는 로그인 단계를 처리해야 하는 경우
* 내보내기 전에 필드 수준의 정리가 필요한 경우

## 기본 워크플로

<Steps>
  <Step title="페이지 열기">
    수집하려는 데이터가 포함된 URL에서 시작합니다.
  </Step>

  <Step title="요소 선택">
    추출 워크플로를 정의하는 데이터 필드, 버튼, 링크 또는 목록 항목을 클릭합니다.
  </Step>

  <Step title="동작 선택">
    데이터 추출, 클릭, 항목 루프, 페이지 넘기기, 스크롤 또는 대기 등의 동작을 추가합니다.
  </Step>

  <Step title="워크플로 검토">
    동작 순서를 확인하고 작업이 의도한 페이지 경로를 따르는지 확인합니다.
  </Step>

  <Step title="테스트 실행">
    전체 작업을 실행하기 전에 작은 샘플을 실행하고 결과를 검토합니다.
  </Step>
</Steps>

## 일반적인 동작

| 동작       | 용도                                                                                                                                                     |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 웹페이지로 이동 | 추출 워크플로를 시작할 대상 URL을 로드합니다 <br /> <sub>유사한 여러 URL에서 추출하려면 루프와 결합하여 각 URL을 반복 처리하세요.</sub>                                                              |
| 데이터 추출   | 텍스트, 링크, 이미지 URL, 속성 또는 기타 필드 값을 수집합니다                                                                                                                 |
| 클릭       | 링크, 버튼, 탭, 메뉴 또는 상세 페이지를 엽니다                                                                                                                           |
| 루프       | 항목 목록에 대해 동작을 반복합니다                                                                                                                                    |
| 텍스트 입력   | 페이지의 입력 필드에 텍스트를 입력합니다 <br /> <sub>웹사이트에 수동 인증이 필요할 때 로그인 자격 증명을 입력하는 데도 사용됩니다.</sub>                                                                  |
| 페이지 넘기기  | 여러 결과 페이지를 이동합니다                                                                                                                                       |
| 스크롤      | 스크롤 후 나타나는 콘텐츠를 로드합니다 <br /> <sub>전체 페이지 스크롤(기본값)과 특정 영역 내 스크롤(부분)을 지원합니다. 스크롤 반복 횟수와 대기 시간을 설정하고 더 이상 콘텐츠가 로드되지 않을 때 루프를 자동으로 종료하도록 선택할 수 있습니다.</sub> |
| 대기 동작    | 동적 콘텐츠가 완전히 로드되도록 기다립니다                                                                                                                                |
| 데이터 클리닝  | 필드 값의 형식을 변경하거나 일부를 추출합니다                                                                                                                              |

## 선택자 수동 편집

기본 요소 선택으로 올바른 데이터가 수집되지 않으면 내부 XPath를 직접 편집할 수 있습니다. 다음과 같은 경우에 유용합니다.

* 자동 생성된 선택자의 범위가 너무 넓거나 좁은 경우
* 표시되는 텍스트 대신 특정 속성(예: `href`, `src`, `data-price`)을 대상으로 지정해야 하는 경우
* 항목마다 페이지 구조가 조금씩 달라 기본 선택자가 일부 행을 놓치는 경우

선택자를 편집하려면 워크플로에서 필드를 클릭하고 [XPath 편집 모드](/docs/ko/academy/xpath-css-selectors)로 전환하세요. 저장하기 전에 수정한 선택자를 실제 페이지에서 테스트할 수 있습니다.

## 문제 해결

| 문제                            | 가능한 원인                          | 시도할 방법                                       |
| ----------------------------- | ------------------------------- | -------------------------------------------- |
| 요소를 선택할 수 없음                  | 요소가 iframe 또는 shadow DOM 안에 있음  | 먼저 iframe으로 전환하거나 내장 브라우저를 사용해 페이지 구조를 검사하세요 |
| 선택한 요소에서 빈 값이 반환됨             | 페이지 렌더링 후 콘텐츠가 동적으로 로드됨         | 추출 단계 전에 대기 동작을 추가하세요                        |
| 루프에서 중복 행이 추출됨                | 루프 선택자가 겹치는 영역과 일치함             | 더 구체적인 컨테이너를 대상으로 루프 XPath 범위를 좁히세요          |
| 페이지 넘기기가 일찍 중지됨               | 다음 페이지 버튼 선택자가 이후 페이지에서 일치하지 않음 | 마지막 페이지에서 버튼의 클래스나 위치가 변경되는지 확인하세요           |
| 미리보기에서는 데이터가 정확하지만 내보내기 후 잘못됨 | 필드 값에 숨겨진 HTML 또는 공백이 포함됨       | 내보내기 전에 데이터 클리닝을 사용하여 공백을 제거하거나 형식을 변경하세요    |

## 권장 사항

* 전체 작업을 실행하기 전에 작은 샘플로 시작하세요.
* 명확한 필드 이름을 사용하세요.
* 값이 표시 텍스트, 링크, 이미지, 속성 또는 HTML 중 어디에서 수집되는지 확인하세요.
* 콘텐츠가 동적으로 로드되면 대기 시간을 추가하세요.
* 워크플로를 최대한 단순하게 유지하세요.
* 대상 웹사이트가 변경되면 다시 테스트하세요.

<Note>
  노코드 빌더는 웹사이트 구조를 기반으로 반복 가능한 워크플로를 만듭니다. 웹사이트가 크게 변경되면 작업을 조정해야 할 수 있습니다.
</Note>

## 관련 페이지

<Columns cols={3}>
  <Card title="템플릿" href="/docs/ko/platform/templates">
    일반적인 웹사이트용 사전 구축 워크플로로 시작하세요.
  </Card>

  <Card title="자동 감지" href="/docs/ko/platform/auto-detect">
    Octoparse가 페이지를 스캔하고 초기 워크플로를 자동으로 생성하도록 하세요.
  </Card>

  <Card title="데이터 세부 조정" href="/docs/ko/platform/refine-data">
    내보내기 전에 추출 필드를 정리하고 형식을 변경하세요.
  </Card>
</Columns>
