> For the complete documentation index, see [llms.txt](https://help.listly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.listly.io/docs/ko/getting-started/listly-basics/url.md).

# URL빌더

같은 URL 패턴을 가진 여러 페이지(예: 1, 2, 3… 순으로 번호가 매겨진 상품 페이지)의 주소가 필요할 때, 패턴을 바탕으로 URL을 생성할 수 있습니다. **URL 빌더**는 예시 몇 개만으로 전체 주소 목록을 자동으로 만들어 주고, 이를 여러개의 탭으로 열거나, 심층추출로 연결해줍니다.

{% stepper %}
{% step %}

### URL 빌더 열기

Listly 패널에서 **URL Builder**를 클릭하세요.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2FS9Ou7bw6P2lVG7hv87Ff%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-1.png?alt=media&amp;token=fc97c9aa-8081-4193-9f87-20922d6431ba" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## 주소 추가하기

주소를 빌더에 넣는 방법은 두 가지입니다.

* **탭에서 고르기** — 같은 도메인의 페이지를 두 개 이상 열어 두면, Listly가 공통 패턴을 감지해 이곳에 자동으로 표시합니다.
* **직접 넣기** — 오른쪽 입력란에 주소를 직접 붙여 넣습니다.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2Fw8RLXgixqcInLX8Y3fR0%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-2.png?alt=media&amp;token=e603d59a-238b-4a2f-999f-8e3bf1218cda" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
어디서 시작해야 할지 막막하다면, **예시 넣어보기**를 클릭해 샘플을 불러와 작동 방식을 확인해 보세요.
{% endhint %}
{% endstep %}

{% step %}

## URL 패턴 찾기

같은 패턴을 따르는 주소가 **두 개** 이상 입력되면, Listly가 패턴을 인식합니다. 예를 들면 다음과 같습니다.

```
https://test.listly.io/goods/0
https://test.listly.io/goods/1
```

Listly는 이 패턴을 `test.listly.io/goods/{number}`로 인식합니다. **\[더 만들기]**&#xB97C; 클릭하면 왼쪽 창에 URL 세부 조정 창이 생성됩니다.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2F8RNYi7EKctVpY5JZy1MU%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-3.png?alt=media&amp;token=95b36afc-fadf-4123-9bc0-5beda168d570" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## 숫자 세부 조정하기

패턴이 감지되면, **Numbers** 패널에서 어떤 주소를 만들지 정확하게 조정할 수 있습니다.

* **시작** — 시작 숫자
* **끝** — 끝 숫자
* **간격** — 숫자를 얼마씩 증가시킬지

예를 들어 **시작**을 `0`, **끝**을 `10`, **간격**을 `1`로 설정하면 주소 11개(0부터 10까지)가 생성됩니다. **Step**을 `2`로 바꾸면 주소 6개(0, 2, 4, 6, 8, 10)가 생성됩니다.

생성된 주소는 오른쪽에 표시되며, **주소** 옆에 총 개수가 함께 나타납니다.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2FTaA6UIZ2q8RKAyhYRFn4%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-4.png?alt=media&amp;token=5992bb37-2bba-4227-9367-546caa1e3860" alt=""><figcaption></figcaption></figure>

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2FGLUKIEs34lKF8ci24iZk%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-5.png?alt=media&amp;token=6cff45c6-0af8-45a8-bbe7-3804ac1d01cc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## 데이터 추출하기

주소 목록이 원하는 대로 완성되면, 창 하단에서 두 가지 중 하나를 선택할 수 있습니다.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2Fn9buQWUU5NZVGvrHTwm4%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-6.png?alt=media&amp;token=6198819a-e073-4b59-a540-3528f346a874" alt=""><figcaption></figcaption></figure>

### 1. 탭으로 열기

페이지를 먼저 확인한 뒤 추출하고 싶다면 **탭으로 열기**를 클릭하세요. 추출 전에 페이지를 미리 살펴보고 싶을 때 유용합니다.

**탭으로 열기** 창에서 열고자 하는 탭 개수(최대 100개)를 선택하고, **열기 시작**을 클릭하세요.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2FcIxcxPgEHzsRAYzkCJoY%2F%E1%84%92%E1%85%A1%E1%86%AB%E1%84%80%E1%85%AE%E1%86%A8-URL%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5-7.png?alt=media&amp;token=635d3ec4-dd06-4f98-b767-8d3d1b8272cf" alt=""><figcaption></figcaption></figure>

아래와 같이 탭이 열리면 [**탭스 추출**](https://help.listly.io/docs/ko/~/revisions/aMxQF3DQDfS3HPRjIwmf/getting-started/listly-basics/tabs-parts-extraction)을 통해 열려있는 탭에서 데이터를 수집하실 수 있습니다.&#x20;

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2Fj3h5vRoFDc8kpb0y1cf4%2Furl%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5%E1%84%90%E1%85%A2%E1%86%B8.gif?alt=media&amp;token=a369ca3b-72cb-4057-958a-c388d201ee4c" alt=""><figcaption></figcaption></figure>

### 2. 추출 시작

**추출시작**을 클릭하면 생성된 모든 주소에 대해 심층추출이 자동으로 실행됩니다. 모든 페이지에서 데이터를 가장빠르게 가져올 수 있는 방법입니다. 해당 기능의 사용방법은 [**심층추출**](https://help.listly.io/docs/ko/~/revisions/aMxQF3DQDfS3HPRjIwmf/getting-started/listly-basics/deep-extract) 가이드 문서를 참고해주세요.

<figure><img src="https://712555646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiKxoYELFf9WS8XCvYe6S%2Fuploads%2FtJa2xWrEk3EdwZ6CMF1p%2Furl%E1%84%87%E1%85%B5%E1%86%AF%E1%84%83%E1%85%A5%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC.gif?alt=media&amp;token=e76c0edb-a6f1-4a4b-8a62-fa804619cc00" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.listly.io/docs/ko/getting-started/listly-basics/url.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.