NAVER博客MCP服务器
   
用于基于Playwright的NAVER博客自动化的Model Context Protocol（MCP）服务器。允许Claude在NAVER博客上撰写和管理文章。
📋 项目概述
随着NAVER博客的官方API于2020年结束，我们将利用Playwright Web浏览器自动化实现模型上下文协议（MCP）服务器。支持AI助手（Claude等）在NAVER博客上撰写文章。
主要功能
- ✅ NAVER登录自动化 （保存/重新使用会话）
- ✅ 实施MCP服务器 （Claude Desktop集成）
- ✅ 撰写NAVER博客文章 （标题、正文、出版物）
- ✅ 上传图像 （支持文件/Base64、单/多、7种格式）
- ✅ 错误处理和重试 （自动修复网络错误，响应UI更改）
- ✅ 调试工具 （Playwright Trace，自动截图）
- ✅ 浏览类别 （博客类别列表）
🛠️ 技术堆栈
- Python 3.13
- 剧作家1.55.0 -自动化Web浏览器
- MCP-SDK -模型上下文协议
- 派丹蒂克 -数据验证
- 坚韧 -重试逻辑
📦 安装
1.存储库克隆
git clone https://github.com/space-cap/naver-blog-mcp.git
cd naver-blog-mcp2.安装依赖性
# uv를 사용하여 의존성 설치
uv sync
# Playwright 브라우저 다운로드 (필수!)
uv run playwright install chromium3.设置环境变量
# .env.example을 .env로 복사
cp .env.example .env
# .env 파일 편집
# NAVER_BLOG_ID와 NAVER_BLOG_PASSWORD를 입력하세요.env 文件示例：
# 네이버 블로그 계정 정보
NAVER_BLOG_ID=your_naver_id
NAVER_BLOG_PASSWORD=your_password
# Playwright 설정
HEADLESS=false # 디버깅 시 false로 설정
SLOW_MO=100 # 액션 사이 딜레이 (ms)
# 로깅 레벨
LOG_LEVEL=INFO🚀 使用方法
方法1:与Claude Desktop集成（推荐）
Claude Desktop配置文件（claude_desktop_config.json）添加以下内容：
{
"mcpServers": {
"naver-blog": {
"command": "uv",
"args": ["run", "naver-blog-mcp"],
"cwd": "C:\\workdir\\space-cap\\naver-blog-mcp",
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}重新启动Claude Desktop后使用：
네이버 블로그에 글을 작성해줘.
제목: MCP 테스트
내용: Claude가 작성한 첫 번째 글!方法2：直接运行
# MCP 서버 실행
uv run naver-blog-mcp方法3:测试脚本
# 서버 초기화 테스트
uv run python tests/test_server.py
# Tool 핸들러 테스트 (실제 글 작성)
uv run python tests/test_tools.py
# 통합 테스트 (전체)
uv run python tests/test_integration.py📁 项目结构
naver-blog-mcp/
├── src/
│ └── naver_blog_mcp/
│ ├── server.py # ✅ MCP 서버 메인
│ ├── config.py # ✅ 설정 관리
│ ├── automation/ # Playwright 자동화
│ │ ├── login.py # ✅ 로그인 자동화
│ │ ├── post_actions.py # ✅ 글쓰기 자동화
│ │ └── selectors.py # ✅ DOM 셀렉터
│ ├── services/ # 비즈니스 로직
│ │ └── session_manager.py # ✅ 세션 관리
│ ├── mcp/ # MCP 프로토콜
│ │ └── tools.py # ✅ Tool 정의 및 핸들러
│ ├── models/ # 데이터 모델
│ └── utils/ # 유틸리티
├── tests/
│ ├── test_server.py # ✅ 서버 초기화 테스트
│ ├── test_tools.py # ✅ Tool 핸들러 테스트
│ └── test_integration.py # ✅ 통합 테스트
├── docs/
│ ├── architecture.md # 아키텍처 설계서
│ ├── implementation-plan.md # 구현 계획서
│ ├── progress.md # 진행 상황
│ └── user-guide.md # ✅ 사용자 가이드
└── playwright-state/ # 세션 저장 (Git 무시)📊 开发进度
第1阶段完成：93%（第13/14天完成）
Phase 1 (Week 1-2): █████████████░ 93%
Phase 2 (Week 3): ░░░░░░░░░░░░░░ 0%
Phase 3 (Week 4): ░░░░░░░░░░░░░░ 0%
전체 프로젝트: █████████████░ 52%完成的里程碑
- ✅ 第1-3天：项目初始设置和基本自动化
- ✅ 第5-7天：实施MCP服务器和核心工具
- ✅ 第8-10天：错误处理和重试逻辑
- 自定义异常类，Playwright错误处理程序 - tenacity重试（指数回退） - Playwright Trace自动记录
- ✅ 第11-12天：图像上传功能
- 文件/Base64上载，单/多映像 - 支持7种格式（JPG、PNG、GIF、BMP、HEIC、HEIF、WebP） - 10MB大小限制，自动错误处理
- ✅ 第13天：查看类别列表并与MCP服务器配合使用
- 创建Claude Desktop集成文档 - 修复MCP服务器编码错误 - 完全实现类别列表查询功能
已知限制
- ❌ 第14天：Markdown支持（无法实现）
- NAVER博客不支持Markdown - HTML编辑模式也随着智能编辑器ONE的集成而被删除
详细的进展情况 docs/progress.md请参考。
🎯 可用的MCP工具
1. naver_blog_create_post
在博客上写新文章。
参数：
title（必填）：文章标题content（必填）：文章正文category（可选）：类别名称tags（可选）：标记数组images（可选）：排列图像文件路径publish（可选）：是否立即发布（默认为true）
2. naver_blog_list_categories
查看博客的类别列表。
参数： 无
🔧 开发
运行测试
# 모든 테스트
uv run pytest tests/ -v
# 로그인 테스트
uv run python tests/test_login.py
# 글쓰기 테스트
uv run python tests/test_post_write.py代码抛售
# Black 포매팅
uv run black src/ tests/
# Ruff 린팅
uv run ruff check src/ tests/
# Mypy 타입 체킹
uv run mypy src/Playwright调试
# Inspector 모드
PWDEBUG=1 uv run python tests/test_post_write.py
# 헤드 모드 (브라우저 보이기)
HEADLESS=false uv run python tests/test_post_write.py
# 느린 모드 (액션 사이 딜레이)
SLOW_MO=500 uv run python tests/test_post_write.py注意事项
验证码
- 在无头模式下可能会发生CAPTCHA
HEADLESS=false如果设置为，则可以手动打开CAPTCHA。
NAVER使用条款
- 避免过度使用自动化
- 禁止发布垃圾内容
- 保持正常的使用模式
会话管理
- 会话最多有效24小时
playwright-state/永远不要将文件夹提交到Git.env不要将文件提交到Git
📚 文件
用户
- 部署指南 -安装和部署完整指南
- 安装指南 -详细安装方法
- Claude Desktop指南 -Claude Desktop集成
- 用户指南 -使用方法和示例
开发者
🎯 使用示例
示例1:撰写简单的文章
要求Claude：
네이버 블로그에 글을 써줘.
제목: 오늘의 개발 일지
내용: MCP 서버를 사용해서 자동으로 글을 작성했다. 정말 편리하다!示例2:撰写技术博客
Playwright의 장점에 대한 기술 블로그를 작성해줘.
제목은 "Playwright로 웹 자동화 시작하기"로 하고,
Selenium과의 비교, 코드 예제를 포함해줘.示例3:标记格式
다음 마크다운을 네이버 블로그 글로 작성해줘:
제목: Python asyncio 입문
# asyncio란?
Python의 비동기 프로그래밍 라이브러리입니다.
## 주요 개념
- Event Loop
- Coroutines
- Tasks🤝 贡献
欢迎发布和PR！
📄 许可证
MIT许可证
📞 咨询
请通过GitHub Issues联系我们。
______________________________________________________________________
🤖 生成于 克劳德代码