> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/reference/naver-ep-url.md).

# Naver EP URL 설정 가이드

NaverEP URL을 확인하는 방법에 대해 안내합니다.

## **URL만 찾으면 되는 경우**

TSV 파일이 어디에 저장되어 있는지에 따라 URL 형태가 다릅니다. 환경을 확인하여 URL 주소를 확인해 주세요.

#### **방법 1: 네이버 쇼핑파트너센터에서 확인**

1. [네이버 쇼핑파트너센터](https://center.shopping.naver.com/login) 로그인
2. 상품 관리 → 상품정보 수신현황 이동
3. 쇼핑몰 상품 DB URL 항목에서 URL 복사

#### **방법 2: 개발팀에 문의**

TSV 파일은 보통 아래 중 한 곳에 저장되어 있습니다.

* 쇼핑몰 서버 내 특정 경로에 정적 파일로 생성되는 경우
* AWS S3, Google Cloud Storage 등 외부 파일 서버(오브젝트 스토리지)에 업로드되는 경우
* 별도 API 엔드포인트로 동적으로 생성되는 경우

저장 위치에 따라 EP URL 형태가 다릅니다. 아래의 URL 을 참고해 주세요.

<table><thead><tr><th width="210.1484375">저장 방식</th><th>EP URL 예시</th></tr></thead><tbody><tr><td>쇼핑몰 서버 내 정적 파일</td><td><code>https://www.yourshop.com/feed/products.tsv</code></td></tr><tr><td>AWS S3</td><td><code>https://s3.ap-northeast-2.amazonaws.com/bucket-name/ep/products.tsv</code></td></tr><tr><td>CloudFront (CDN) 경유</td><td><code>https://cdn.yourshop.com/ep/products.tsv</code></td></tr><tr><td>API 엔드포인트</td><td><code>https://api.yourshop.com/v1/feed/naver-ep</code></td></tr></tbody></table>

개발팀에 아래와 같이 문의해 주세요.

> "네이버 쇼핑 연동에 사용 중인 TSV 피드 파일 URL이 어떻게 되나요? S3나 CDN 등 외부 파일 서버를 사용 중이라면 해당 공개 URL도 함께 알려주세요."

***

## **처음 만드는 경우**

* **TSV 파일 스펙**
  * 1행: 컬럼 헤더
  * 2행 이후: 상품 데이터 (상품 1개 = 1행)
  * 구분자: 탭(`\t`)
  * 인코딩: UTF-8 (BOM 없음)

{% hint style="info" %}
gelatto는 [네이버 EP 3.0](https://join.shopping.naver.com/misc/download/ep_guide.nhn) TSV 표준 포맷을 사용합니다.&#x20;
{% endhint %}

#### **필수 필드**

<table><thead><tr><th width="150.296875">컬럼명</th><th width="215.74609375">설명</th><th>예시</th></tr></thead><tbody><tr><td><code>id</code></td><td>상품 고유 ID</td><td><code>PRD_001</code></td></tr><tr><td><code>title</code></td><td>상품명</td><td><code>[브랜드] 반팔 티셔츠 화이트 L</code></td></tr><tr><td><code>price_pc</code></td><td>PC 판매가 (정수, 원화)</td><td><code>29000</code></td></tr><tr><td><code>link</code></td><td>상품 상세 URL</td><td><code>https://www.yourshop.com/product/1</code></td></tr><tr><td><code>image_link</code></td><td>대표 이미지 URL</td><td><code>https://cdn.yourshop.com/img/1.jpg</code></td></tr><tr><td><code>category_name1</code></td><td>카테고리 대분류</td><td><code>의류</code></td></tr><tr><td><code>shipping</code></td><td>배송비 (무료=<code>0</code>, 착불=<code>-1</code>)</td><td><code>3000</code></td></tr></tbody></table>

#### **선택 필드 (권장)**

| 컬럼명              | 설명           |
| ---------------- | ------------ |
| `price_mobile`   | 모바일 판매가      |
| `normal_price`   | 정가 (할인 전 가격) |
| `mobile_link`    | 모바일 상품 URL   |
| `add_image_link` | 추가 이미지 URL   |
| `category_name2` | 카테고리 중분류     |
| `category_name3` | 카테고리 소분류     |
| `brand`          | 브랜드명         |
| `review_count`   | 리뷰 수         |

**TSV 샘플**

```
id	title	price_pc	link	image_link	category_name1	shipping
PRD_001	[브랜드] 반팔 티셔츠 화이트 L	29000	https://www.yourshop.com/product/1	https://cdn.yourshop.com/img/1.jpg	의류	3000
PRD_002	[브랜드] 슬랙스 블랙 M	49000	https://www.yourshop.com/product/2	https://cdn.yourshop.com/img/2.jpg	의류	0
```

#### **개발팀 구현 체크리스트**

* 전체 상품을 TSV 형식으로 출력하는 엔드포인트 구현
* 파일 URL이 외부에서 HTTP/HTTPS로 접근 가능한지 확인

***

## **Naver EP URL 정상 여부 확인**

브라우저 주소창에 EP URL을 직접 입력했을 때 TSV 데이터가 텍스트로 표시되면 정상입니다.

```
O 정상 브라우저에서 탭 구분 텍스트 데이터가 표시됨
```

***

## **자주 묻는 질문**

<details>

<summary><strong>Q. 상품이 추가·수정되면 TSV 파일도 업데이트해야 하나요?</strong></summary>

TSV 생성 로직이 항상 최신 데이터를 반영하도록 구현되어 있으면 됩니다. 이후 gelatto가 어드민에서 설정된 주기로 EP URL에 접근하여 자동으로 최신 데이터를 수집합니다.&#x20;

</details>

<details>

<summary><strong>Q. 컬럼 값에 탭이나 줄바꿈이 포함된 경우 어떻게 처리하나요?</strong></summary>

탭(`\t`)과 개행(`\n`, `\r`) 문자는 반드시 공백( ) 처리 또는 제거 후 출력해야 합니다. 포함된 경우 파싱 오류로 해당 상품이 무효 처리됩니다.

</details>


---

# 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.genser.ai/reference/naver-ep-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.