naver-marketing-mcp

Claude에서 네이버 블로그 게시와 파워링크 입찰을 대화로 호출하는 로컬 MCP 서버. Blotato·Higgsfield가 못 하는 한국 갭만 담당합니다.

왜 로컬인가

• 네이버 블로그는 공식 게시 API가 없어 브라우저 자동화(Playwright) 가 필요합니다.
• 로컬·사장님 자기 IP·단일 계정으로 돌면 봇 탐지/정지 리스크가 서버 실행보다 훨씬 낮습니다.
• 로그인 세션은 로컬(.auth/)에만 저장하고, 비밀번호는 저장하지 않으며, 외부로 보내지 않습니다.

도구 (P0)

✅ 실제 로그인 세션에서 발행까지 검증 완료(SmartEditor ONE). 🔨 = 골격.

네이버 블로그 발행 방식 (검증됨)

• 로그인: Playwright 직접실행 대신 진짜 Chrome 을 원격디버깅 포트로 켜고 CDP attach → 자동화 탐지 회피. 세션은 쿠키 JSON(.auth/naver_state.json)으로 저장·주입.
• 에디터: SmartEditor ONE(iframe#mainFrame) — 제목/본문 입력, 사진(로컬 업로드), 태그, 공개범위, 발행까지 자동.

감성 서식과 발행 옵션 (검증됨)

• 서식 블록: blocks 로 본문, 소제목, 인용구, 구분선, 사진을 원하는 순서대로 배치. 글과 사진이 번갈아 나오는 자연스러운 글을 만든다.
• 글꼴: font 로 본문 기본 글꼴 지정. 기본서체, 나눔고딕, 나눔명조, 나눔바른고딕, 나눔스퀘어, 마루부리, 다시시작해, 바른히피, 우리딸손글씨 중 선택. 블록마다 {"font":"..."} 로 다르게 줄 수도 있다(예: 인용구만 손글씨체).
• 카테고리와 공개범위: category(블로그의 카테고리 이름과 정확히 일치), visibility(public/neighbor/both/private).
• 예약발행: schedule_at="YYYY-MM-DD HH:MM" 으로 네이버 네이티브 예약. 네이버 서버가 그 시각에 자동 발행하므로 PC를 켜 둘 필요가 없다. 분은 10분 단위로 반올림되며 지금부터 최소 10분 뒤여야 한다.

설치

방법 1. 앱에서 더블클릭 (터미널 모름, 추천)

Claude 데스크톱 앱을 쓰면 .mcpb 파일을 더블클릭해 설치합니다. 파이썬도 uv도 미리 안 깔아도 됩니다(번들에 uv 포함).

• 다운로드: https://github.com/kimtaedaeri/smb-marketing-kit/releases/latest (맥은 -mac, 윈도우는 -win)
• 자세한 안내는 docs/설치_앱_더블클릭.md, 번들 빌드는 mcpb/ 참고. 맥은 애플 실리콘과 인텔 모두 지원(유니버설).

방법 2. 한 줄 설치 (Claude Code, 터미널)

claude mcp add smb-marketing -- uvx smb-marketing-naver-mcp@latest

@latest 를 붙여야 최신 버전을 받습니다. 처음 대화에서 "네이버 블로그 연결해줘, 아이디는 OOO" 로 블로그 아이디를 한 번 알려주면 저장됩니다.

방법 3. 소스로 개발 설치

python -m venv .venv && source .venv/bin/activate
pip install -e .
claude mcp add naver-marketing -- python -m naver_marketing_mcp

크로미움 다운로드는 필요 없습니다(시스템 크롬에 붙습니다).

안전장치 (코드에 내장)

• 승인 게이트: naver_blog_publish(approve=False) 는 초안만 반환, approve=True 여야 실제 게시.
• 일일 상한 + 랜덤 지연: policy.yaml 의 daily_cap·min_interval_min 을 서버가 강제.
• dry-run: 파워링크는 기본 dry_run=True.