# 확장 프로그램·브라우저 문제

> 💡 이 문서를 마치면 확장 프로그램이 연결되지 않거나, 수집이 멈추거나, 새 탭·팝업이 말썽일 때 원인을 찾아 해결할 수 있습니다. (⏱️ 약 5분)
>
> 📍 대상 화면: **상품 수집**, **마켓 입점 > 이베이 시작하기**, **마켓 관리 > 마켓 계정 관리**(eBay 연결)\
> ✅ 미리 준비: Chrome 브라우저, [크롬 확장 프로그램 설치하기](start-extension.md)

## 이게 뭔가요?

Spresso는 웹 화면과 Chrome [확장 프로그램](glossary.md)(Spresso-Extension)이 같이 일합니다.

- **상품 수집**: 확장 프로그램이 수집처 사이트를 열어 상품 정보를 가져옵니다. Spresso 화면의 [대시보드 탭](glossary.md)이 그 결과를 받아 저장합니다.
- **이베이 시작하기**: 확장 프로그램이 eBay·Payoneer 가입 화면의 칸을 채웁니다("에스프레소로 채우기").

그래서 확장 프로그램이 꺼져 있거나 Spresso 화면을 닫으면 수집이 멈춥니다.

## 먼저 확인할 것

어느 증상이든 아래 네 가지를 먼저 봅니다.

1. **Chrome**에서 Spresso를 열었나요? 확장 프로그램은 Chrome 웹 스토어에서 설치합니다.
2. **확장 프로그램이 켜져 있나요?** 주소창 오른쪽 퍼즐 아이콘에서 Spresso-Extension을 선택해 팝업에 "Spresso Extension", "버전: …", "확장 프로그램 ID"가 나오면 설치돼 있습니다. 안 보이면 [크롬 확장 프로그램 설치하기](start-extension.md)를 봅니다.
3. **Spresso 화면이 열려 있나요?** 수집하는 동안 Spresso 탭(대시보드 탭)이 열려 있어야 결과가 저장됩니다.
4. **플랜을 이용 중인가요?** 플랜이 끝나거나 부가서비스 한도를 넘으면 수집 메뉴가 막히고 수집 결과도 저장되지 않습니다([화면 둘러보기](app-basics.md)).

## 증상별 해결

아래 표에서 겪는 증상을 골라 바로 갑니다.

| 증상 | 볼 곳 |
| --- | --- |
| 수집을 시작하면 "확장 프로그램 설정이 필요합니다."가 나옵니다 | [바로 가기](#확장-프로그램-설정이-필요합니다-가-나와요) |
| 수집이 중간에 멈추거나 상품이 "네트워크 에러"로 실패합니다 | [바로 가기](#수집이-멈추거나-네트워크-에러-로-실패해요) |
| 수집 중에 쇼핑몰 탭이 열리거나 보안 확인 화면이 뜹니다 | [바로 가기](#수집-중-새-탭이-열리거나-확인-화면이-떠요) |
| Spresso 탭을 닫았거나 로그아웃했습니다 | [바로 가기](#spresso-창을-닫았거나-로그아웃했어요) |
| 이베이·Payoneer 가입 화면에서 칸이 안 채워집니다 | [바로 가기](#이베이-payoneer-화면에서-칸이-안-채워져요) |
| eBay 계정 연결에서 **[인증 URL 생성]**을 눌러도 eBay 로그인 탭이 안 열립니다 | [바로 가기](#이베이-로그인-창이-안-열려요-마켓-계정-연동) |
| 화면이 저절로 새로고침됩니다 | [바로 가기](#화면이-갑자기-새로고침돼요) |

### "확장 프로그램 설정이 필요합니다."가 나와요

**언제**: 수집을 시작할 때 Spresso가 확장 프로그램과 연결하지 못하면 오류 알림으로 나옵니다.

**왜**: 확장 프로그램이 설치되지 않았거나 꺼져 있을 때, 또는 확장 프로그램을 쓸 수 없는 브라우저일 때입니다.

**이렇게 해결합니다**

1. Chrome에서 Spresso를 엽니다.
2. 확장 프로그램이 없으면 [설치](start-extension.md)하고, 있으면 Chrome **확장 프로그램 관리** 화면(주소창에 `chrome://extensions`)에서 Spresso-Extension이 켜져 있는지 확인합니다.
3. Spresso 화면을 새로고침(F5)한 뒤 다시 수집합니다. 확장 프로그램을 설치하거나 켜기 전에 열어 둔 화면은 새로고침해야 확장 프로그램과 연결됩니다.

다시 수집했을 때 이 알림 없이 수집이 시작되면 해결됐습니다. 진행은 **상품 수집 > 수집기 조회**에서 봅니다.

### 수집이 멈추거나 "네트워크 에러"로 실패해요

**왜**: 확장 프로그램이 상품 하나에 60초 동안 답하지 않으면 그 상품은 "네트워크 에러"로 실패합니다. 수집기는 다음 상품으로 넘어갑니다.

- 이런 때 생깁니다: 인터넷이 불안정할 때, 확장 프로그램이 멈췄을 때, 수집 중에 열린 수집처 탭이 닫혔을 때.
- 확장 프로그램이 이유를 알면 그 이유가 대신 나옵니다(예: 비디오·디지털 상품이라 수집할 수 없음).

**이렇게 해결합니다**

1. 인터넷 연결을 확인합니다.
2. 수집하는 동안 자동으로 열린 수집처 탭을 닫지 않습니다. 수집이 끝나면 확장 프로그램이 그 탭을 닫습니다.
3. [수집기 조회](collector-list.md)의 **수집완료/미완료** 탭에서 **[미완료 상품 재수집]**을 선택합니다.
4. 요청이 잦으면 접속을 막는 수집처가 있습니다. 이런 곳은 [수집기 생성](collector-create.md)의 사이트 설정에서 **상품 수집속도 지연**을 늘려 다시 수집합니다.
   - SSG·올리브영: 3초 이상으로 두면 좋습니다.
   - 오너클랜: 접속이 막히면 수집기가 멈추고 30분 뒤에 풀립니다.

다시 수집한 뒤 미완료 상품이 남지 않으면 해결된 것입니다.

### 수집 중 새 탭이 열리거나 확인 화면이 떠요

일부 수집처는 수집하는 동안 그 사이트 탭을 열거나 보안 확인 화면([CAPTCHA](glossary.md))을 띄웁니다. 수집기 생성 화면의 사이트 유의사항(제목 옆 도움말)과 같은 내용입니다.

| 수집처 | 화면 안내 | 할 일 |
| --- | --- | --- |
| G마켓 · 옥션 | 첫 수집 시 봇 확인 화면이 약 30초 표시될 수 있습니다. | 기다립니다. |
| Taobao | 수집 중 CAPTCHA가 발생할 경우, 처리해주셔야 수집이 계속됩니다. | 나온 확인 화면(CAPTCHA)을 풉니다. 풀어야 수집이 이어집니다. |
| 올리브영 | 수집 중 올리브영 탭이 열리고, 접속 확인 화면("잠시만 기다리십시오")이 잠깐 뜰 수 있습니다. | 탭을 닫지 않고 기다립니다. |
| 오너클랜 | 수집 중 오너클랜 탭이 열립니다. | 탭을 닫지 않습니다. |
| SSG | 접속이 차단되면(캡차) 수집이 멈추고 SSG 탭이 열립니다. | 열린 탭에서 확인을 마친 뒤 다시 수집합니다. |
| 스마트스토어 | 보안 확인이 감지되면 네이버 탭이 열립니다. | 열린 탭에서 해제를 마칩니다. 목록 검색은 해제되면 바로 이어집니다. 정한 시간 안에 해제하지 않으면 검색을 멈춥니다. 상품 수집은 기다렸다가 다시 시도합니다. |
| 쿠팡 | 쿠팡 쿠키를 초기화할 때 새 탭이 자동으로 열리고 10초 후 자동으로 닫힙니다. | 그대로 둡니다. |
| 온채널 | 로그인해야 가격·옵션이 보입니다. | 같은 브라우저에서 온채널에 로그인해 둔 상태로 수집합니다. |

스마트스토어는 수집기 생성의 사이트 설정에서 보안 확인 때 어떻게 할지 정합니다.

- "CAPTCHA가 발생할 경우 상품 수집을 [진행] 합니다."에서 **진행** 또는 **중단**을 고릅니다.
- **진행**을 고르면 "보안 확인(캡차/로그인) 해제를 최대 [ ] 초까지 기다립니다."에 기다릴 시간을 넣습니다.
- "CAPTCHA 해제에 실패할 경우 [ ] 합니다."에서 **다음 상품을 수집** 또는 **상품 수집을 중단**을 고릅니다.

![수집기 생성 사이트 설정의 CAPTCHA 칸](../img/trouble-extension-03.png)

자세한 설정은 [수집기 생성](collector-create.md)을 봅니다.

### Spresso 창을 닫았거나 로그아웃했어요

- 수집 결과는 Spresso의 **대시보드** 탭이 받아 저장합니다. 수집이 끝날 때까지 Spresso 탭과 브라우저를 닫지 않습니다.
- 수집 중에 로그아웃하면 진행 중 수집기가 모두 "수집 미완료"로 바뀝니다([화면 둘러보기](app-basics.md)의 "로그아웃").
- 다시 들어오면 대시보드에 "일시중지된 수집기가 있습니다." 창이 나올 수 있습니다. **[재수집]**을 선택하면 이어서 수집합니다([대시보드](dashboard.md)).

### 이베이·Payoneer 화면에서 칸이 안 채워져요

1. [이베이 시작하기](ebay-start.md) 1단계에서 **[저장하고 다음 단계로]**를 눌러 저장했는지 확인합니다. 저장해야 확장 프로그램에 값이 들어갑니다.
2. 저장 뒤 안내를 확인합니다.
   - "저장했습니다. 확장 프로그램을 새 버전으로 바꿔 주세요." — 설치된 확장 프로그램이 옛 버전입니다. 새 버전으로 바꾼 뒤 **[다시 저장]**을 선택합니다.
   - "저장했습니다. 확장 프로그램이 설치돼 있지 않습니다." — 설치한 뒤 **[다시 저장]**을 선택합니다.
3. eBay·Payoneer 화면 오른쪽 아래 **에스프레소로 채우기**를 선택합니다. 칸이 채워지면 해결됐습니다.
   - Payoneer 첫 화면(이메일)은 직접 입력합니다. 다음 화면부터 채우기를 씁니다.

### 이베이 로그인 창이 안 열려요 (마켓 계정 연동)

[eBay 마켓 계정 연동](connect-ebay.md)에서 **[인증 URL 생성]**을 눌렀는데 새 탭이 열리지 않으면 브라우저가 팝업을 막은 것입니다. 화면에 따로 문구는 나오지 않습니다.

1. Chrome 주소창 오른쪽의 팝업 차단 아이콘을 선택합니다.
2. Spresso 사이트의 팝업을 항상 허용하고 **완료**를 선택합니다.
3. **[인증 URL 생성]**을 다시 선택합니다.

### 화면이 갑자기 새로고침돼요

Spresso에 새 버전이 배포되면 화면이 저절로 새로고침됩니다. 오류가 아닙니다. 탭 목록은 남지만 저장하지 않은 입력은 사라질 수 있습니다([화면 둘러보기](app-basics.md)).

## 그래도 안 되면

[고객센터](support.md) > **1:1 문의**에서 문의 유형 **상품 수집**으로 남깁니다. 아래를 같이 적으면 빨리 확인할 수 있습니다.

- 화면에 나온 문구 원문
- 확장 프로그램 팝업의 **버전**
- 수집처와 수집기 이름
- 일어난 날짜와 시각
- 화면 캡처(jpg·png·pdf 파일 하나, 10MB 미만)

화면에 나온 다른 문구는 [자주 보는 오류 메시지](trouble-errors.md)에서 찾습니다.

## 관련 문서

- [크롬 확장 프로그램 설치하기](start-extension.md)
- [수집기 생성](collector-create.md) · [수집기 조회](collector-list.md)
- [이베이 시작하기](ebay-start.md) · [eBay 마켓 계정 연동](connect-ebay.md)
- [자주 보는 오류 메시지](trouble-errors.md)