heqiangdiao-wq/AI-Cross-Border-Ecommerce-Agent-Toolkit

AI 跨境电商运营智能体工具箱 · 把运营 SOP 拆成 7 个可复用的 AI Agent 工作流,含 Prompt、模板与真实案例

AI 국경 간 전자상거래 에이전트 툴킷

정의 – 국경 간 전자상거래 SOP를 재현 가능한 워크플로우로 전환하는 7개의 즉시 사용 가능한 AI 에이전트 "스킬" 모음입니다. 각 에이전트는 다음을 포함합니다:

  • 역할과 계약을 정의하는 시스템 프롬프트,
  • 입력-출력 템플릿,
  • 작은 헬퍼 스크립트(예: 시장 지표 계산기, 규정 준수 확인),
  • 예제 데이터 및 자체 검증을 위한 체크리스트.

이 툴킷은 SaaS 플랫폼을 제공하지 않습니다. 프롬프트와 템플릿을 모든 LLM(OpenAI, Claude 등)에 입력하여 에이전트를 로컬에서 실행합니다.


핵심 에이전트 (7개)

# 에이전트 핵심 작업
01 시장 조사 에이전트 카테고리 데이터를 파싱하고 집중도, 가격대, 기회 지표를 계산합니다(번들 스크립트 사용).
02 제품 전략 에이전트 포지셔닝, SKU 구성, 가격 모델, 이익률 매트릭스를 결정합니다.
03 리스팅 크리에이티브 에이전트 키워드 그룹, 제목, 불릿 포인트, 사양 테이블을 생성하며 문자 수 및 금지어 검사를 포함합니다.
04 제품 이미지 에이전트 9-이미지 그리드를 계획하고, 이미지 생성 프롬프트를 만들고, 픽셀 수준 규정 준수 검사를 실행합니다.
05 제품 비디오 에이전트 스크립트와 스토리보드를 작성하고, AI 비디오 프롬프트를 구축하고, 음성 해설과 자막을 추가합니다.
06 광고 최적화 에이전트 퍼널 단계를 진단하고, 손익분기 CPC를 계산하고, 단계별 조치(P0-P2)를 제안합니다.
07 리뷰 분석 에이전트 리뷰를 8가지 귀인 범주로 분류하고, 오해를 식별하고, 리스팅 개선을 제안합니다.

모든 에이전트는 ✅ v0.4(안정)로 표시되며, 스킬 기반 LLM 프레임워크에 가져올 수 있는 SKILL.md 파일로 패키징됩니다.


실행 방법 (API 키 불필요)

  1. 원하는 에이전트의 templates/ 폴더를 복사합니다.
  2. 제품 정보를 입력합니다(약 10분).
  3. 시스템 프롬프트, 작업 프롬프트, 작성된 템플릿을 연결합니다.
  4. 결합된 텍스트를 선택한 LLM에 보냅니다.
  5. 게시 전에 docs/04_Result_Checklist.md로 출력을 검증합니다.

저장소에는 시장 조사에서 광고/리뷰 피드백 루프까지 전체 체인을 안내하는 완전한 엔드투엔드 예제(전동 스쿠터)가 포함되어 있습니다.


규정 준수 초점

원래 내부 SOP에는 금지된 전술(예: 가짜 주문, 허위 주장)이 포함되어 있습니다. 이 툴킷은 그러한 행동을 제외하며, 레드라인과 규정 준수 대안을 나열하는 03_Compliance_Guard.md 파일을 제공합니다. 별도의 05_SOP_Gap_Register.md는 생략된 모든 항목을 문서화합니다.


플랫폼 지원

플랫폼 지원 수준 주요 제약
Shopee (브라질) ✅ 일급 120자 제목 제한, 9-이미지 흰색 배경 그리드, PT-BR 언어
Mercado Livre ✅ 일급 60자 제목, 깨끗한 배경 이미지, PT-BR/ES
Amazon 📄 필드 매핑됨 200자 제목(권장 80), 순수 흰색 배경
TikTok Shop 📄 필드 매핑됨 세로 9:16 이미지 선호
Shopify 📄 필드 매핑됨 하드 제한 없음

자세한 필드 사양은 docs/02_Platform_Output_Spec.md에 있습니다.


로드맵 요약

  • v0.3 (현재): 7개 에이전트, 데이터 파싱 스크립트, 규정 준수 가드.
  • v1.0: 직접 업로드를 위한 원클릭 자료 패키지 생성.
  • v2: Shopee / Mercado Livre에서 실시간 데이터를 가져오는 API 통합.
  • v3: 시각적 워크플로우 오케스트레이션을 위한 웹 UI.
  • v4: 폐쇄 루프 최적화를 갖춘 완전 자동화, 예약 실행 에이전트.

사용 대상

  • 전문가 SOP를 반복 가능한 LLM 기반 프로세스로 코드화하려는 국경 간 판매자.
  • 여러 고객 스토어를 위한 내부 도구를 구축하는 대행사.
  • 구체적인 프롬프트 엔지니어링 예제와 재사용 가능한 스킬 번들을 찾는 개발자.

라이선스

MIT – 자유롭게 사용, 수정, 공유할 수 있습니다.


결론 – 이 툴킷은 호스팅 서비스 없이 모든 LLM으로 실행할 수 있는 모듈식 AI 에이전트로 노련한 전자상거래 지식을 전환하기 위한 실용적이고 규정 준수 우선의 청사진입니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트