Product Title Checker (Amazon & eBay)

Validate Amazon & eBay product titles against official policies — character limits, banned symbols, keyword stuffing. Rule-based, deterministic, no LLM calls.

이커머스/드랍쉬핑 셀러 및 AI agent를 위한규칙 기반(non-AI)상품명 검증 API입니다. Amazon, eBay 정책 기준으로 글자수, 금지/과장 표현, 대문자 남용, 키워드 스터핑, 특수문자, 이모지, 공백 오류, 욕설 등을 검사합니다. LLM을 호출하지 않으므로 응답이 항상 결정적이고(deterministic), 지연시간이 짧고, 실행 비용이 거의 없습니다.

pip install -r requirements.txt uvicorn main:app --host 0.0.0.0 --port 8000

서버가 뜨면http://localhost:8000/docs에서 Swagger UI로 바로 테스트할 수 있습니다.

아래 표는 각 규칙이 어떤 소스에서 나왔는지, 얼마나 신뢰할 수 있는지를 명시합니다. "확인 방법"은 실제로 웹 검색/fetch를 통해 검증한 방식을 뜻합니다.
- Amazon 특수문자 목록과 단어반복 규칙은 공식 페이지 직접 열람이 아니라 이를 인용하는 2차 소스 교차 확인으로 검증했습니다. Seller Central 로그인이 가능하면Product title requirements and guidelines페이지 원문과 대조하는 것을 권장합니다.
- 과장 표현/욕설 목록은 공식 금칙어 사전이 아니라 일반적인 업계 관행 기반 추정 목록입니다. 실제 서비스 배포 전 반드시 별도 검증이 필요합니다.
- Amazon 75자 규칙은2026-07-27부터 시행 예정입니다(현재는 과도기). 시행 이후 실제 강제 여부를 재확인하는 것을 권장합니다.
- 두 플랫폼 다 정책이 자주 바뀌므로, 앞서 논의한 대로주 1회 정도 공식 페이지 diff 체크 후 변경 시에만 사람이 재검토하는 운영 방식을 권장합니다.

Amazon/eBay 타이틀 정책은 실제로 확인해보니변경 빈도가 낮습니다(Amazon: 2025-01 → 2026-07, 약 1년 반 간격). 이 빈도라면 자동 감지 스크립트를 만들고 유지보수하는 노동력이 오히려 과잉 투자라고 판단해,분기별 수동 체크 방식으로 운영합니다.
- 캘린더에 3개월 주기 리마인더 등록("Amazon/eBay 타이틀 정책 확인")
- 알림 오면 아래 공식 페이지를 브라우저로 직접 열어서 훑어봄 (5~10분)
- 변경 사항 발견 시 → Claude에게 변경 내용을 전달하고rules.py수정 요청
- 수정된 파일을 다운로드해서 실제 서버/호스팅에 재배포 (이 프로젝트 자체는 배포된 API와 별개의 작업 파일이므로, 재배포는 항상 수동으로 진행)

- 자동 스크래핑은 봇 차단(WAF) 리스크가 있어 신뢰성이 낮음
- 변경 빈도가 낮아 실시간 감지의 이득이 크지 않음 (최대 3개월 지연되어도 API가 당장 잘못된 판정을 대량으로 내리는 게 아니라, "완전 최신은 아니지만 거의 맞는" 상태로 계속 정상 작동함)
- 사람이 직접 브라우저로 확인하는 방식은 차단 리스크가 원천적으로 없고, 별도 인프라 (cron, 이메일 발송 설정 등) 유지보수가 필요 없음

render.yaml파일이 이미 포함되어 있어 대시보드에서 클릭 몇 번으로 배포됩니다.

1. GitHub에 코드 올리기 (Render는 GitHub 레포 연결 방식)

cd title_checker git init git add . git commit -m "Product Title Checker API - initial commit"

GitHub에서 새 레포지토리를 만든 뒤 (예:product-title-checker), 안내되는 명령어로 push:

git remote add origin https://github.com/본인계정/product-title-checker.git git branch -M main git push -u origin main

- render.com가입 (GitHub 계정으로 로그인 가능)
- 대시보드에서New > Blueprint선택
- 방금 만든 GitHub 레포 선택 → Render가render.yaml을 자동으로 인식해서 빌드/실행 명령어를 알아서 채움
- Apply클릭 → 몇 분 내로 빌드 및 배포 완료
- 배포되면https://product-title-checker-xxxx.onrender.com같은 공개 URL이 발급됨

curl https://받은-URL.onrender.com/ curl -X POST https://받은-URL.onrender.com/check \ -H "Content-Type: application/json" \ -d '{"title": "Wireless Earbuds", "platform": "amazon"}'

{ "mcpServers": { "Product Title Checker": { "command": "npx", "args": [ "mcp-remote", "https://mcp.rapidapi.com", "--header", "x-api-host: product-title-checker.p.rapidapi.com", "--header", "x-api-key: YOUR_RAPIDAPI_KEY" ] } } }

ReplaceYOUR_RAPIDAPI_KEYwith your own key. Get one by subscribing (free tier available) atRapidAPI.

title_checker/ ├── main.py # FastAPI 엔드포인트 ├── rules.py # 규칙 정의 및 검증 로직 (출처는 이 README 참고) ├── requirements.txt ├── render.yaml # Render 배포 설정 (Blueprint) ├── logo.png # RapidAPI 리스팅용 로고 └── README.md

Indie board game designers, tabletop creators, and TGC users who want to manage their projects through an AI assistant instead of navigating the TGC web interface manually.