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 키 불필요)
- 원하는 에이전트의
templates/폴더를 복사합니다. - 제품 정보를 입력합니다(약 10분).
- 시스템 프롬프트, 작업 프롬프트, 작성된 템플릿을 연결합니다.
- 결합된 텍스트를 선택한 LLM에 보냅니다.
- 게시 전에
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 에이전트로 노련한 전자상거래 지식을 전환하기 위한 실용적이고 규정 준수 우선의 청사진입니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트