> 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/ja/getting-started/extension-features/url-builder.md).

# URL Builder

同じURLパターンを持つ複数のページ（例: 1、2、3…のように番号が振られた商品ページ）のアドレスが必要なとき、そのパターンをもとにURLを生成できます。**URL Builder** は、いくつかの例だけで全アドレスのリストを自動で作成し、複数のタブで開いたり、Deep Extract につなげたりできます。

{% stepper %}
{% step %}

### URL Builder を開く

Listly パネルで **URL Builder** をクリックします。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2Fgtyi2eX5etTZZfL6XsGm%2Fimage.png?alt=media&amp;token=ea1d0063-0c38-4267-bc2c-75d1c0fa4a04" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## アドレスを追加する

アドレスをビルダーに入れる方法は2つあります。

* **タブから選ぶ（Pick from a tab）** — 同じドメインのページを2つ以上開いておくと、Listly が共通のパターンを検出し、ここに自動で表示します。
* **自分で入力する（Type your own）** — 右側の入力欄にアドレスを直接貼り付けます。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2Fe6PfbgZo3ETqbhQdSTcA%2Fimage.png?alt=media&amp;token=7be9830e-7dcf-4796-a3ab-f38603371824" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
どこから始めればよいか迷ったら、**例を試す（Try the example）** をクリックしてサンプルを読み込み、動作を確認してみましょう。
{% endhint %}
{% endstep %}

{% step %}

## URLパターンを見つける

同じパターンに従うアドレスを **2つ** 以上入力すると、Listly がパターンを認識します。例えば次のとおりです。

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

Listly はこのパターンを `test.listly.io/goods/{number}` として認識します。**［残りを生成（Fill in the rest）］** をクリックすると、左側にアドレスの調整パネルが表示されます。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2FayI42e7BoF7da1eVgtlH%2Fimage.png?alt=media&amp;token=4e505339-dc70-41e6-a2c3-dd8d5abcac1d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## 数値を調整する

パターンが検出されたら、**Numbers** パネルでどのアドレスを作成するかを細かく調整できます。

* **開始（Start）** — 最初の数値
* **終了（End）** — 最後の数値
* **間隔（Step）** — 数値をどれだけ増やすか

例えば **開始（Start）** を `0`、**終了（End）** を `10`、**間隔（Step）** を `1` に設定すると、アドレスが11個（0から10まで）生成されます。**間隔（Step）** を `2` に変えると、アドレスは6個（0、2、4、6、8、10）になります。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2FycfNLmXhZAy9AmI1DZL0%2Fimage.png?alt=media&amp;token=595be00f-0594-4bce-9325-0779a2d2308d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2FUVYBKqyQ1zqXvhmTdgRZ%2Fimage.png?alt=media&amp;token=e95ce305-f6d8-4b3f-8e63-fcf493749fc0" alt=""><figcaption></figcaption></figure>

生成されたアドレスは右側に表示され、**アドレス（Addresses）** の横に合計件数が表示されます。
{% endstep %}

{% step %}

## データを抽出する

アドレスのリストが思いどおりに完成したら、ウィンドウ下部で2つのうちどちらかを選べます。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2F01H8rIoy4pDdO2Dsp7c1%2Fimage.png?alt=media&amp;token=9b51ef3c-3a13-4187-a61f-b2044558e988" alt=""><figcaption></figcaption></figure>

### 1. タブで開く（Open as tabs）

抽出する前にページを確認したい場合は、**タブで開く（Open as tabs）** をクリックします。抽出前にページをあらかじめ確認したいときに便利です。

**タブで開く（Open as tabs）** ウィンドウで、開きたいタブの数（最大100個）を選び、**開始する（Start opening）** をクリックします。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2FrXdx5vFTUQiXVvClegpN%2Fimage.png?alt=media&amp;token=496e9d5c-1ff7-447a-8162-58e41aed85b8" alt=""><figcaption></figcaption></figure>

下のようにタブが開いたら、[**Extract Tabs**](https://help.listly.io/docs/ja/~/revisions/ByTRrASRSq9GYunPRdkc/getting-started/extension-features/tabs-parts) を使って、開いているタブからデータを収集できます。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2FSIp2xKLDRIDgqwViAzfy%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=342c1b46-074e-4781-b7b6-809412bcba8d" alt=""><figcaption></figcaption></figure>

### 2. 抽出する（Extract）

**抽出する（Extract）** をクリックすると、生成されたすべてのアドレスに対して Deep Extract が自動で実行されます。すべてのページからもっとも速くデータを取得できる方法です。使い方については [**Deep Extract**](https://help.listly.io/docs/ja/~/revisions/ByTRrASRSq9GYunPRdkc/getting-started/extension-features/madedeep-extract) ガイドをご参照ください。

<figure><img src="https://161576231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI8js41AfLS5QdXKB7e8A%2Fuploads%2FYTZNCkZt8tSh8Vw6F3ex%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=b7e31741-ccfb-4cc2-b0cd-85b920d4e049" 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/ja/getting-started/extension-features/url-builder.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.
