aliexpress-auto-listing-skill

1688 소싱 → Dianxiaomi ERP → AliExpress 게시를 통한 AliExpress 상품 자동 등록 워크플로우. AI 브라우저 자동화로 크로스보더 이커머스 지원.

aliexpress-auto-listing-skill란 무엇인가요?

이 스킬은 1688.com에서 상품을 소싱하고 Dianxiaomi(店小秘) ERP를 거쳐 AliExpress(速卖通)에 자동으로 상품을 등록하는 완전한 크로스보더 이커머스 자동화 워크플로우를 제공합니다. Windows의 Chrome 브라우저를 원격 디버깅 모드로 실행하고, Relay2 프록시와 WSL 상의 chrome_relay.py를 통해 Playwright가 CDP(Chrome DevTools Protocol)로 브라우저를 제어할 수 있도록 연결합니다. 사용자는 1688 로그인(수동 로그인 필요)과 Dianxiaomi 로그인(QR 코드 자동 로그인 가능)만 완료하면, 나머지 상품 수집, ERP 입력, AliExpress 게시 과정을 AI가 자동으로 수행합니다. 또한 Gateway 연결 끊김 시의 복구 절차(올바른 탭 찾기, 데이터 손실 방지 등)를 상세히 안내하여 안정적인 자동화를 보장합니다. Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor

npx skills add southernspark-nfxh/aliexpress-auto-listing-skill

문서

시작 모듈: Chrome + Relay + Playwright

아키텍처

Windows Chrome (--remote-debugging-port=9222)
  ↕ Relay2.exe (0.0.0.0:9255 → 127.0.0.1:9222)
Windows IP (172.24.48.1:9255)
  ↕ WSL chrome_relay.py (127.0.0.1:19223 → 172.24.48.1:9255)
  ↕ Playwright connect_over_cdp('http://127.0.0.1:19223')

Step A: Chrome 실행 (Windows)

# 먼저 기존 Chrome 프로세스 종료
taskkill /F /IM chrome.exe

# 디버그 포트로 Chrome 실행
cmd.exe /c start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" \
  --remote-debugging-port=9222 \
  --user-data-dir="C:\Users\[사용자 Windows 사용자명]\Desktop\chrome-debug"

⚠️ 기본 프로필은 9222를 바인딩할 수 없으므로 반드시 별도의 --user-data-dir(예: chrome-debug)을 사용해야 합니다.

Step B: Relay2 실행 (Windows)

Relay2.exe는 Windows 시작 프로그램에 자동 등록되어 실행됩니다: C:\Users\[사용자 Windows 사용자명]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\hermes-gateway.vbs

수동 실행: Relay2.exe를 더블클릭합니다.

Step C: WSL Relay 실행

cd ~/.hermes/scripts && python3 chrome_relay.py &

Step D: 연결 확인

# WSL relay 확인
curl -s http://127.0.0.1:19223/json | head -5

# Chrome 탭 목록의 JSON이 반환되어야 합니다

Step E: Playwright 연결

from playwright.async_api import async_playwright

async with async_playwright() as p:
    browser = await p.chromium.connect_over_cdp('http://127.0.0.1:19223')
    pages = browser.contexts[0].pages
    # 열려 있는 탭 확인

로그인 확인

店小秘 로그인

店小秘로 이동 → 로그인 상태 확인(페이지에 [사용자 店小秘 사용자명] 사용자명이 있는지 확인):

document.body.innerText.includes('[사용자 店小秘 사용자명]')

로그인되지 않은 경우 QR 코드로 로그인: 店小秘 오른쪽 상단 → QR 코드 스캔 로그인.

1688 로그인

1688 로그인 상태 확인: 1688 임의 상품 페이지 열기 → "로그인" 버튼이 있는지 확인.

document.body.innerText.includes('登录')

로그인되지 않은 경우 수동 로그인 (1688 인증번호는 자동화 불가).

장애 복구

Gateway 연결 끊김 후 재연결 철칙

치명적 오류: browser_navigate를 직접 호출하면 새 탭이 생성되어 입력된 데이터가 손실됩니다.

올바른 절차:

1. browser_cdp → Target.getTargets     # 모든 탭 나열
2. 店小秘 편집 탭 찾기 (title="店小秘--编辑速卖通产品")
3. Runtime.evaluate로 페이지 상태 읽기 (제목/hash/bodyText)
4. 어떤 탭에 입력 데이터가 있는지 확인
5. Target.closeTarget으로 빈/중복 탭 닫기
6. Target.activateTarget으로 올바른 탭 활성화
7. 이제 browser_snapshot에 입력 데이터가 표시되어야 함

전체 연결 실패

# WSL 측
pkill -f chrome_relay.py
cd ~/.hermes/scripts && python3 chrome_relay.py &

# Windows 측 (수동 또는 WSL에서 트리거)
taskkill /F /IM chrome.exe
# Chrome 재시작 (Step A)

작성자: 南方星火 SouthernSpark | Xiaohongshu @南方星火 SouthernSpark | AI 자동화 전문가 워크플로우

aliexpress-auto-listing-skill