# 그룹추출

## 그룹추출이란?

그룹 추출은 **여러 페이지를 한 번에 수집할 수 있는 기능**입니다.

{% columns %}
{% column width="83.33333333333334%" %}

<figure><img src="/files/NrjJULzfU2PXgoXh2jy4" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="16.666666666666657%" %}

{% endcolumn %}
{% endcolumns %}

대표 페이지 하나를 먼저 추출한 뒤, 결과창에서 **\[+그룹]** 버튼을 눌러 연계된 페이지의 URL을 추가하면, 나머지 페이지는 리스틀리가 자동으로 추출합니다.

***

## 그룹추출 시작 전 URL 준비하기

그룹추출을 실행하기 위해서는 여러 페이지의 URL을 한 번에 입력하는 과정이 필요하므로, 미리 추출할 페이지의 URL을 준비해두는 것이 좋습니다.

상황에 따라 아래 가이드를 참고해 필요한 URL을 먼저 준비해주세요.&#x20;

1. [1,2,3…연속된 페이지를 추출하는 경우](/docs/ko/getting-started/result-page-features/group-extraction-sequential-page-urls.md)
2. [목록페이지에 포함된 상세페이지를 추출하는 경우](/docs/ko/getting-started/result-page-features/group-extraction-detail-page-urls.md)

***

## 주의사항

{% columns %}
{% column width="83.33333333333334%" %}

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

{% endcolumn %}

{% column width="16.666666666666657%" %}

{% endcolumn %}
{% endcolumns %}

그룹 추출에서 **첫 번째로 추출하는 페이지는 ‘틀’** 역할을 합니다.\
그룹 추출은 이 첫 페이지에서 선택한 위치와 동일한 위치의 데이터를 다른 페이지에서도 가져오는 방식으로 동작합니다.

따라서, **처음 추출한 페이지와 이후 입력한 URL의 페이지 구조가 다르면 추출이 실패할 수 있습니다.**\
그룹 추출을 진행하기 전, 반드시 페이지 구조가 동일한지 확인해 주세요.

***

## 사용방법&#x20;

{% stepper %}
{% step %}

### 그룹추출 소스 페이지 추출하기

그룹 추출의 기준이 될 소스 페이지를 먼저 추출합니다. 반드시 준비한 URL 중 첫 번째일 필요는 없으며, **그룹 추출할 페이지들 중 대표적인 구조를 가진 페이지**를 선택하면 됩니다. 추출 방식은 Whole / Parts 모두 가능하지만, **데이터 위치를 더 정확하게 지정할 수 있는** [**부분 추출(Parts)**](/docs/ko/getting-started/listly-basics/parts-extraction.md)을 권장합니다.

<figure><img src="/files/4voStvCxe7giVFnblttK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 추출 탭 선택하기

결과창에서 **원하는 정보가 포함된 탭을 선택**합니다. 선택한 영역 내의 모든 정보가 포함된 탭을 선택해주세요.

<figure><img src="/files/uydzVz3qOcI1GMhzqHoV" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### \[+그룹] 버튼 클릭하기&#x20;

**\[+그룹]** 버튼을 클릭합니다.

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

{% endstep %}

{% step %}

### 그룹추출에 필요한 URL 주소 붙여넣기&#x20;

그룹 설정창 하단에 **준비해둔 URL 주소**를 붙여넣고, **\[완료]** 버튼을 클릭하세요.&#x20;

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

{% hint style="warning" %}
반드시 **최초 추출을 진행했던 소스 페이지의 URL도 함께 입력**해야 합니다.
{% endhint %}

{% endstep %}

{% step %}

### 그룹추출 진행상황 확인하기

그룹 추출 시 데이터보드를 새로고침해 진행 상황을 확인할 수 있습니다. 추출이 완료되면 결과칸을 클릭해 그룹 결과창으로 이동합니다.

<figure><img src="/files/5T7FMUHwY7PcZ7b1PI5E" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### 데이터 정렬 방식 선택하기&#x20;

엑셀 혹은 구글시트 버튼을 클릭하고, 데이터 정렬 방식을 선택한 후 다운로드 버튼을 클릭합니다.

{% hint style="info" %}
참고: [카드 1개씩 1줄에 넣기 / 탭 1개씩 1줄에 넣기](broken://spaces/7gAZPuKEwHYWzOCfiiPk/pages/EOpiA3FVFIfsQdpIbRmv)
{% endhint %}

<figure><img src="/files/3h1uXPZuuoQDMh3lsCnp" alt=""><figcaption></figcaption></figure>

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

{% endstep %}

{% step %}

### 그룹추출 완료

다운로드한 파일을 열어 추출한 데이터를 확인해보세요. 그룹추출이 완료되었습니다.

<figure><img src="/files/jv8kYPO6OvslGgJaJsiF" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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/getting-started/result-page-features/group-extraction.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.