Xianyu AutoAgent 실전 리뷰: 오픈소스 시엔위 24시간 AI 고객서비스, 멀티 전문가 협업 + 스마트 가격 협상 지원

시엔위에서 물건을 팔고 있다면 이런 경험을 해봤을 겁니다. 새벽 2시에 구매자가 “이거 아직 있나요?”라고 물어보는데, 답장하지 않으면 다른 곳으로 가버립니다. Xianyu AutoAgent는 바로 이 문제를 해결하기 위해 탄생했습니다. 24시간 자동 응답, 가격 협상, 질문 답변을 지원하는 오픈소스 AI 고객서비스 시스템입니다.

이 글에서는 Xianyu AutoAgent의 핵심 기능, 기술 아키텍처, 배포 방법을 자세히 분석하고, 다른 시엔위 자동화 도구와 비교해 보겠습니다.

1. Xianyu AutoAgent란?

Xianyu AutoAgent는 오픈소스 Python 프로젝트로, 시엔위 스토어를 AI 기반 자동화 운영 시스템으로 변환하는 것이 핵심 기능입니다. “안녕하세요, 있어요”만 보내는 단순 자동 응답이 아니라, 대규모 언어 모델(LLM)을 사용해 구매자의 의도를 진정으로 이해하고, 컨텍스트 기반 대화를 나누며, 가격 협상까지 해줍니다.

시엔위 판매자의 고충

시엔위는 중국 최대의 중고거래 플랫폼으로, 일일 활성 사용자가 1억 명을 넘습니다. 하지만 판매자들은 몇 가지 핵심 고충에 직면해 있습니다:

적시성 없는 응답: 구매자 문의 시간이 불규칙적이라, 새벽이나 회의 중에 놓치면 주문이 유실됨
반복 질문 많음: 문의의 80%가 “아직 있나요?”, “깎아주실 수 있나요?”, “언제 발송되나요?” 같은 반복 질문
가격 협상의 피로: 모든 구매자가 깎으려 하고, 반복적인 줄다리기는 정신적으로 소모됨
다중 계정 관리의 어려움: 전문 판매자는 여러 계정을 동시에 운영하느라 메시지에 대응하기 힘듦

Xianyu AutoAgent는 바로 이런 문제들을 해결하기 위해 탄생했습니다.

GitHub 프로젝트: shaxiu/XianyuAutoAgent

핵심 데이터:

⭐ GitHub Stars: 8,800+
🐍 언어: Python 3.8+
🆓 오픈소스 라이선스: 완전 무료
🤖 지원 모델: Qwen(기본값), OpenAI 등 호환 API
📅 생성일: 2025년 3월

이 프로젝트는 개발자 shaxiu가 2025년 3월에 만들었으며, 중국 개발자 커뮤니티에서 높은 관심을 받고 있습니다. 전자상거래場景에서의 AI Agent 실전 적용 사례입니다. 현재 27개의 WeChat 교류 그룹이 있어 커뮤니티 활성도가 높음을 보여줍니다.

2. 핵심 기능 상세

1. 컨텍스트 인식 대화

대부분의 자동 응답 도구는 각 메시지를 독립적인 질문으로 처리합니다. Xianyu AutoAgent는 대화 기록을 유지하여 AI가 다음을 가능하게 합니다:

같은 대화 내의 과거 메시지를 기억
구매자의 추가 질문과 보충 설명을 이해
일관된 커뮤니케이션 로직 구축

실제 효과:

구매자: 이 핸드폰 아직 있나요?
AI: 네, 개인 사용 폰이고 9成新이며 모든 기능이 정상입니다.
    어떤 부분이 궁금하신가요?

구매자: 배터리 건강도는 어때요?
AI: 배터리 건강도는 87%이고, 약 1년 사용했습니다.
    보통 하루 한 번 충전하면 문제없습니다.

2. 멀티 전문가 라우팅 시스템

Xianyu AutoAgent의 핵심 하이라이트는 멀티 전문가 협업 아키텍처입니다. 시스템은 구매자 의도에 따라 대화를 다양한 “전문가 에이전트”로 라우팅합니다:

전문가 유형	역할	전형적 시나리오
분류 전문가	구매자 의도 식별	대화를 해당 전문가로 라우팅
가격 협상 전문가	가격 협상 처리	”깎아주실 수 있나요?”
기술 전문가	기술적 질문에 답변	”사양이 어떻게 되나요?”
고객서비스 전문가	일반 문의 처리	”언제 발송되나요?”

시스템은 LLM을 사용하여 의도 인식을 수행하고, 구매자가 전문적이고 정확한 답변을 받을 수 있도록 합니다.

3. 스마트 가격 협상 시스템

가격 협상 시스템은 Xianyu AutoAgent의 가장 실용적인 기능 중 하나입니다. 단계적 가격 인하 전략을 구현합니다:

첫 번째 협상: 약간의 양보로 성의 표시
두 번째 협상: 추가 인하하되, 마지노선 지키기
마지노선 유지: 원가 이하 가격을 정중히 거절

가격 협상 예시:

구매자: 1500에 팔릴까요?
AI: 그 가격은 좀 낮네요. 1800은 어떠세요? 이게 최저가입니다.

구매자: 1600은요?
AI: 좋은 가격을 원하시는 마음은 이해하지만, 1800이 정말 최저입니다.
    이 상태에 이 가격은 아주 공정합니다.

설정 가능한 항목:

최소 허용 가격
가격 인하 임계값
협상 톤 (친절/단호)

4. 커스텀 프롬프트

Xianyu AutoAgent는 4개의 프롬프트 템플릿을 제공하며, 자유롭게 커스터마이징할 수 있습니다:

classify_prompt.txt: 의도 분류
price_prompt.txt: 가격 협상
tech_prompt.txt: 기술 답변
default_prompt.txt: 기본 응답

즉, 자신의 제품 특징과 브랜드 톤에 맞춰 AI의 “페르소나”를 조정할 수 있다는 뜻입니다.

3. 기술 아키텍처 분석

멀티 전문가 협업 의사결정 시스템

아키텍처는 허브 앤 스포크 모델을 따릅니다:

구매자 메시지 → 분류 전문가 → 의도 식별
                              ↓
                ┌─────────────┼─────────────┐
                ↓             ↓             ↓
           가격 전문가    기술 전문가    고객서비스
                ↓             ↓             ↓
                └─────────────┼─────────────┘
                              ↓
                      최종 응답 생성

기술 스택

백엔드: Python 3.8+
AI 프레임워크: Qwen(기본값) / OpenAI API 호환
데이터 저장: 인메모리 세션 관리
배포 방식: 로컬 / Docker

워크플로우

메시지 수신: 시스템은 Web API를 통해 시엔위 메시지를 모니터링하고, 구매자가 보낸 내용을 실시간 캡처
의도 분류: LLM이 메시지 내용을 분석하여 구매자 의도 식별 (가격 문의, 기술 상담, 일반 문의 등)
전문가 라우팅: 메시지는 해당 전문가 에이전트로 라우팅되며, 각 에이전트는 독립적인 프롬프트와 의사결정 로직을 가짐
응답 생성: 전문가 에이전트가 컨텍스트 기록을 결합해 응답을 생성하여 대화의 일관성과 자연스러움 보장
자동 전송: 응답은 API를 통해 구매자에게 자동 전송되며, 전 과정 인력 개입 불필요

주요 기술 세부사항

세션 관리: 시스템은 경량 인메모리 세션 저장소를 사용하며, 각 구매자와의 대화는 독립적으로 유지됩니다. 구매자가 새 메시지를 보내면, 시스템은 해당 구매자의 과거 대화를 가져와 LLM의 컨텍스트 입력으로 사용합니다. 이를 통해 대화 일관성이 유지되면서도 컨텍스트가 너무 길어져 토큰 소비가 커지는 것을 방지합니다.

의도 인식: 분류 전문가는 LLM 프롬프트와 규칙 기반 라우팅을 결합합니다. 먼저 프롬프트로 LLM에게 메시지 유형(가격 협상/기술/고객서비스/잡담)을 판단하게 하고, 그 판단 결과에 따라 해당 전문가에게 전달합니다. 이 방식은 전통적인 키워드 매칭보다 유연하며, 더 복잡한 의도를 처리할 수 있습니다.

인간 시뮬레이션: 시스템은 SIMULATE_HUMAN_TYPING 옵션을 지원하며, 활성화하면 인간의 응답 지연을 시뮬레이션하여 대화를 더 자연스럽게 만들고, 봇으로 식별될 위험을 줄입니다.

키워드 전환: 특정 키워드(기본값은 마침표) 입력을 통해 AI 관리와 수동 관리를 전환할 수 있습니다. 필요시 수동으로 개입한 후 처리가 끝나면 AI 모드로 돌아올 수 있습니다.

4. 일반적인 시엔위 자동 응답 도구와 비교

기능	Xianyu AutoAgent	전통적 자동 응답	기타 AI 고객서비스
컨텍스트 인식	✅ 완전	❌ 없음	부분 지원
멀티 전문가 시스템	✅ 있음	❌ 없음	❌ 없음
스마트 가격 협상	✅ 고급	❌ 없음	기본
오픈소스 무료	✅ 예	❌ 아니오	❌ 아니오
커스텀 프롬프트	✅ 완전	❌ 없음	제한적
웹 검색 통합	✅ 있음	❌ 없음	제한적
비용	무료 + API 비용	유료 구독	고가 SaaS

핵심 차이점: Xianyu AutoAgent는 현재 멀티 전문가 협업과 스마트 가격 협상을 결합한 유일한 오픈소스 솔루션으로, 중고거래 시나리오에 특히 적합합니다.

5. 로컬 배포 실전

하드웨어 요구사항

CPU: 1코어+
메모리: 1GB+
디스크: 100MB 여유 공간
네트워크: 안정적인 인터넷 연결

설치 단계

# 1. 리포지토리 클론
git clone https://github.com/shaxiu/XianyuAutoAgent.git
cd XianyuAutoAgent

# 2. 의존성 설치
pip install -r requirements.txt

# 3. 환경 변수 설정
cp .env.example .env
# .env 파일 편집, API_KEY와 COOKIES_STR 입력

# 4. 프로그램 실행
python main.py

설정 튜토리얼

API_KEY 얻기

알리바바 클라우드 모델 서비스(https://modelscope.cn/) 접속
가입 후 로그인
콘솔에서 API_KEY 획득

COOKIES_STR 얻기

시엔위 웹 버전(https://www.goofish.com/) 열기
F12를 눌러 개발자 도구 열기
Network 탭으로 전환
페이지 새로고침 후 아무 요청이나 클릭
Request Headers의 Cookie 값 복사

6. 실제 사용 시나리오와 효과

시나리오 1: 중고 전자제품

구매자: 이 핸드폰 아직 있나요? AI: 네, 개인 사용 제품이고 9成新이며 모든 기능 정상입니다. 무엇을 알고 싶으신가요?

구매자: 1500에 팔릴까요? AI: 그 가격은 좀 낮네요. 1800은 어떠세요? 최저가입니다.

시나리오 2: 의류/신발

구매자: M 사이즈 있나요? AI: 네, M 사이즈는 아직 두 벌 남았습니다. 새 제품, 태그 부착, 미착용입니다.

구매자: 무료 배송 가능할까요? AI: 네, 지금 주문하시면 무료 배송됩니다.

시나리오 3: 서적/교재

구매자: 책이 정품인가요? AI: 네, 정품입니다. 페이지가 깨끗하고 필기나 밑줄 없이 새 것과 같습니다.

7. 한계와 주의사항

플랫폼 규정 리스크

⚠️ 중요 안내: 자동화 도구 사용은 시엔위 이용약관을 위반할 수 있으며, 계정 정지 위험이 있습니다.

기술적 한계

Cookie 의존: Cookie는 만료되며 정기적으로 갱신 필요
이미지 미지원: 현재 텍스트 대화만 처리 가능
지속 실행 필요: 자동 응답하려면 프로그램을 계속 실행해야 함

사용 권장사항

먼저 테스트: 저가 상품으로 먼저 안정성을 테스트하고, AI가 올바르게 이해하는지 확인 후 확대 적용
정기 점검: 응답 로그를 확인하여 AI가 올바르게 이해하는지 확인하고, 잘못된 응답은 즉시 수정
수동 개입: 복잡한 문제 발생 시 수동 응답으로 전환하여 AI의 부적절한 답변 방지
규정 준수: 시엔위 플랫폼 규정을 이해하고 준수하며, 사용 빈도 제어
Cookie 백업: 정기적으로 유효한 Cookie를 백업하여 중단 시간 최소화
적합한 모델 선택: Qwen은 가성비가 높고, OpenAI는 효과는 좋지만 비용도 높음

비용 추정

Qwen 기준, 하루 100건의 메시지를 처리한다고 가정:

건당 평균 500 토큰(입력+출력)
하루 약 50,000 토큰
월 비용 약 15~30위안

하루 100건 이상 문의가 있는 판매자에게 이 비용은 인간 고객서비스를 고용하는 비용보다 훨씬 낮습니다.

8. 총평

장점

✅ 오픈소스 무료 ✅ 멀티 전문가 협업 시스템 ✅ 컨텍스트 인식 대화 ✅ 스마트 가격 협상 ✅ 배포 간편

단점

❌ 플랫폼 규정 리스크 ❌ Cookie 의존이 안정성에 영향 ❌ 멀티미디어 미지원 ❌ 지속 실행 필요

대상 사용자

24시간 자동 응답을 원하는 시엔위 판매자
AI Agent 적용에 관심 있는 개발자
자동화 애호가
하루 50건 이상 문의가 있는 전문 판매자
고객서비스 비용을 절감하고 싶은 중소 판매자

비대상 사용자

가끔 파는 개인 사용자(설정 비용이 맞지 않음)
플랫폼 규정에 대해 제로 허용인 사용자(정지 위험)
대량의 이미지/동영상 문의를 처리해야 하는 시나리오

종합 평가

⭐⭐⭐⭐ 4/5

Xianyu AutoAgent는 현재 가장 완성도 높은 오픈소스 시엔위 AI 고객서비스 솔루션입니다. 멀티 전문가 아키텍처와 스마트 가격 협상 기능으로 수많은 자동 응답 도구 중 돋보입니다. 단, 플랫폼 규정 리스크에 주의하고 신중하게 사용하시기 바랍니다.

향후 발전 방향

프로젝트 README에 따르면, 개발팀은 다음 기능을 계획 중입니다:

감정 분석 강화: 구매자 감정 인식, 응답 전략 조정
시장 가격 비교 기능: 유사 상품 가격 자동 분석, 가격 협상 전략 최적화
RAG 지식 베이스 강화: 상품 자료 가져오기 지원, AI 답변을 더 전문적으로
DingTalk 통합: 중요 메시지를 실시간으로 핸드폰에 푸시
Web 관리 인터페이스: 시각적 설정 및 모니터링

이러한 기능들이 구현되면 Xianyu AutoAgent는 더욱 완성도 높아질 것입니다. 장기적으로 사용하려는 판매자라면 프로젝트 업데이트를 주시할 가치가 있습니다.

상용 솔루션과 비교

시중에는 상용 시엔위 자동 고객서비스 솔루션도 있으며, 가격은 수백 위안에서 수천 위안까지 다양합니다. 이에 비해 Xianyu AutoAgent의 장점은:

완전 오픈소스: 코드가 투명하고 백도어 없음
고도로 커스터마이징 가능: 자신의 필요에 따라 수정 가능
비용 제어 가능: API 비용만, 구독료 없음
커뮤니티 지원: 활발한 개발자 커뮤니티가 지속 개선

물론 상용 솔루션의 장점은 바로 사용할 수 있고 기술 지원이 있다는 점입니다. 어떤 솔루션을 선택할지는 기술력과 예산에 달려 있습니다.

FAQ

Q1: Xianyu AutoAgent란 무엇인가요? A: Xianyu AutoAgent는 오픈소스 시엔위 AI 고객서비스 봇으로, 24시간 자동 응답, 스마트 가격 협상, 멀티 전문가 협업을 지원합니다.

Q2: Xianyu AutoAgent를 사용하면 계정이 정지되나요? A: 자동화 도구 사용은 시엔위 이용약관을 위반할 수 있으며, 정지 위험이 있습니다. 신중하게 사용하고 플랫폼 규정을 이해하시기 바랍니다.

Q3: Xianyu AutoAgent는 무료인가요? A: 프로젝트 자체는 오픈소스로 무료이지만, AI 모델(Qwen 등) 호출에는 API 비용이 듭니다.

Q4: 시엔위 Cookie는 어떻게 얻나요? A: 시엔위 웹 버전을 열고, F12로 개발자 도구를 열고, Network 탭으로 전환하고, 요청을 찾아 Request Headers의 Cookie 값을 복사합니다.

Q5: Xianyu AutoAgent는 어떤 AI 모델을 지원하나요? A: 기본값으로 Qwen을 사용하며, OpenAI API 및 기타 호환 모델도 지원합니다. .env 파일에서 설정할 수 있습니다.

이 리뷰가 도움이 되셨기를 바랍니다! Xianyu AutoAgent에 대한 질문이나 사용 경험을 공유하고 싶으시면 댓글을 남겨주세요.

#Xianyu AutoAgent #闲鱼 AI 客服 #闲鱼自动回复 #AI Agent #开源工具 #电商自动化