pub-pitfalls-mcp

한국어

1인 출판사가 책·전자책을 판매처에 등록하다 막힌 실제 사례(53건)를 AI 에이전트가 조회하는 MCP 서버입니다. 대상: Amazon KDP, 국립중앙도서관 ISBN, 교보문고 전자책 파트너, 크몽, Payhip, Google Play Books, Netlify.

설치·실행 (Node.js 18 이상, 외부 패키지 없음)

node index.js      # stdio MCP 서버
node test.js       # 시험

MCP 클라이언트 설정 예: {"command": "node", "args": ["<이 폴더>/index.js"]}

도구 3개

• search_pitfalls(query, platform?) : 증상 문구(한국어·영어)로 상위 5건 검색
• get_pitfall(id) : 사례 1건
• list_platforms() : 플랫폼별 건수

고지 이 자료는 1인 출판사가 2026년 10~11월 실제로 겪은 기록이며 각 플랫폼 정책은 바뀔 수 있습니다. 공식 안내를 함께 확인하세요.

라이선스 코드(index.js 등)는 MIT, 사례 자료(data/pitfalls.json)는 CC BY 4.0 — 출처 "victorview pub-pitfalls"를 밝히면 누구나 쓸 수 있습니다. 새로 막힌 사례·바뀐 정책 제보는 Issues로 받습니다.

English

An MCP server that lets AI agents look up 53 real cases where a one-person publisher got blocked while registering books and e-books (Amazon KDP, Korean National Library ISBN, Kyobo eBook partner, Kmong, Payhip, Google Play Books, Netlify). Case text is in Korean.

Install / run (Node.js 18+, no dependencies): node index.js starts the stdio server; node test.js runs the tests.

Tools: search_pitfalls(query, platform?) returns the top 5 matches for a Korean or English symptom text; get_pitfall(id) returns one case; list_platforms() returns case counts per platform.

Notice This data records what a one-person publisher actually experienced in Oct-Nov 2026. Platform policies may change; always check the official guidance too.

License Code: MIT. Case data (data/pitfalls.json): CC BY 4.0 — credit "victorview pub-pitfalls". Reports of new pitfalls or policy changes are welcome via Issues.