> For the complete documentation index, see [llms.txt](https://qseller.gitbook.io/yqube-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qseller.gitbook.io/yqube-docs/integration/manual.md).

# 쇼핑몰 API "수동" 연동하기

네이버 커머스API센터에서 발급받은 키를 직접 입력해 스마트스토어를 연동합니다.

자동 연동이 어려운 경우, 네이버 커머스API센터에서 애플리케이션을 직접 등록하고 발급받은 키를 QSeller에 입력해 연동할 수 있습니다.

{% hint style="info" %}
먼저 [쇼핑몰 추가하기](/yqube-docs/integration/add-shop.md)에서 쇼핑몰을 추가하고 연동 방법으로 **직접 입력**을 선택하세요.
{% endhint %}

## 네이버 스마트스토어

{% stepper %}
{% step %}

### 네이버 커머스API센터 접속

[네이버 커머스API센터](https://apicenter.commerce.naver.com/ko/basic/main)에 접속합니다.

![네이버 커머스API센터](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-1bca9910d3348a51292814373bce54f8c6ec96bb%2Fmanual-naver-01-apicenter.png?alt=media)
{% endstep %}

{% step %}

### 로그인

**커머스API센터 시작하기** > **로그인**을 클릭합니다.

![커머스API센터 로그인](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-e30fa1f2d595a3cce502b6ef705b6ebc262ad758%2Fmanual-naver-02-login.png?alt=media)
{% endstep %}

{% step %}

### 개발업체 계정 생성

**개발업체계정 생성**을 클릭합니다.

![개발업체 계정 생성](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-b719654553d4169825ad674894f36134c4c3b6b7%2Fmanual-naver-03-create-dev-account.png?alt=media)

필수 항목을 입력하고 가입을 완료합니다.

![개발업체 계정 필수 항목 입력](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-4170ba686f71ca6d8117e08cfa2d91471d56e42b%2Fmanual-naver-04-signup.png?alt=media)

![개발업체 계정 가입 완료](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-4d72689cfebd298e35cbfed1a30d96e5926a760e%2Fnaver-dev-signup-done.png?alt=media)
{% endstep %}

{% step %}

### 애플리케이션 등록

가입이 완료되면 **애플리케이션** > **내 스토어 애플리케이션** > **등록하기**를 클릭합니다.

![애플리케이션 등록하기](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-7e7bcffd876cbb2cbb22729d847fb2d6fb394fc7%2Fmanual-naver-05-register-app.png?alt=media)
{% endstep %}

{% step %}

### 애플리케이션 정보 및 API 호출 IP 입력

애플리케이션 이름과 설명을 입력하고, **API 호출 IP**에 아래 QSeller IP를 입력합니다.

```
125.130.126.79
```

![애플리케이션 정보 입력](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-fb05c560a7f75fc6195197b5d1b16f4028fe88a4%2Fmanual-naver-06-app-info.png?alt=media)
{% endstep %}

{% step %}

### API 그룹 추가

전체 API 그룹을 모두 추가합니다.

![API 그룹 추가](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-c1f22286b6e6077b5fbffedb37860bb3ed8b026a%2Fmanual-naver-07-api-groups-1.png?alt=media)

![API 그룹 전체 추가](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-2176d3421d41fd3e2d24087ffc1edf5afa1c9641%2Fmanual-naver-08-api-groups-2.png?alt=media)
{% endstep %}

{% step %}

### 애플리케이션 ID / 시크릿 키 확인

애플리케이션 등록이 완료되면 **애플리케이션 ID**와 **시크릿 키**를 확인할 수 있습니다.

{% hint style="warning" %}
시크릿 키는 비밀번호와 같습니다. 다른 사람에게 공유하지 마세요.
{% endhint %}

![애플리케이션 ID와 시크릿 키](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-d74ab2395bd55fb796b14c42716c54180af2720f%2Fmanual-naver-09-app-keys.png?alt=media)
{% endstep %}

{% step %}

### QSeller에 API 정보 입력

QSeller 프로그램 > **API 연동** > **직접 입력**에서 네이버 ID, 애플리케이션 ID, Secret Key를 입력하고 **API 정보 저장**을 클릭합니다.

![API 정보 입력](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-a8a2b1bfcd29aeeb28d57b5832c34aca326edf62%2Fmanual-naver-10-enter-keys.png?alt=media)
{% endstep %}

{% step %}

### 상품 목록 수집 여부 선택

연동이 완료되면 기존 상품 목록을 수집할지 선택합니다.

![상품 목록 수집 여부 체크](https://1624479654-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUiXT0jodscyyi6oEHRTp%2Fuploads%2Fgit-blob-da8476061ed4be63824840a7ff6795e83aabb94f%2Fmanual-naver-11-collect.png?alt=media)
{% endstep %}
{% endstepper %}

## 다음 단계

{% content-ref url="/pages/vgBC5h4HfzJhrSgZ3yKt" %}
[상품 크롤링](/yqube-docs/products/collect.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://qseller.gitbook.io/yqube-docs/integration/manual.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.