Weixin MCP - 위챗 기사 리더

대규모 언어 모델(LLM)이 위챗 공식 계정 기사를 읽을 수 있도록 하는 미니멀한 MCP입니다.

핵심 기능

• 🎭 브라우저 시뮬레이션: Playwright를 사용하여 브라우저 환경을 완벽하게 시뮬레이션

• 📝 내용 추출: 제목, 작성자, 게시 시간, 본문 내용을 자동으로 추출

• ⚡ 간결한 구현: 최소한의 코드로 핵심 기능 구현

Related MCP server: WeChat Article Parser

워크플로우

1. 사용자가 대규모 언어 모델에 URL과 요구사항을 전송

2. 대규모 언어 모델이 MCP 도구를 호출

3. MCP가 기사 내용을 가져와 대규모 언어 모델에 전송

4. 대규모 언어 모델이 기사 내용을 바탕으로 자연어 출력

기술 스택

• Python 3.10+

• fastmcp - MCP 프레임워크

• url-md (Rust 단일 바이너리) - 안티 크롤링 방지 + Markdown 추출을 한 번에 처리

• pyyaml - frontmatter 파싱

v0.3.0 업데이트 안내: 크롤링 계층을 agent-browser 4회 서브 프로세스 + BeautifulSoup 파싱에서 url-md md <url> 단일 호출로 간소화했습니다. url-md 내부에서 안티 크롤링 방지 / 위챗 본문 추출 / Markdown 변환 / frontmatter 생성을 처리합니다. 의존성이 줄었으며, content 필드가 Markdown으로 업그레이드되었습니다(이미지 참조 / 리스트 / 제목 계층 유지). MCP 프로토콜 인터페이스는 변경되지 않았으므로 기존 Claude/Cursor 설정을 조정할 필요가 없습니다.

v0.2.0 업데이트 안내: 기존 Playwright 방식이 위챗의 강화된 안티 크롤링에 의해 차단되었습니다(issue #3). 크롤링 계층을 agent-browser(Apache-2.0 오픈 소스 Rust 프로젝트)에 위임하도록 변경했습니다. v0.3.0부터는 url-md로 마이그레이션되었습니다.

빠른 시작

1. url-md 설치 (v0.3.0부터 필수)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Bwkyd/url-md/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/Bwkyd/url-md/main/install.ps1 | iex

# 验证
url-md --version

6초 만에 사용 가능. 7MB 단일 바이너리로 Chrome 등 외부 의존성이 필요 없습니다(위챗 영구 링크는 reqwest 빠른 경로 사용).

2. Python 의존성 설치

pip install -r requirements.txt

3. 설정

{
  "mcpServers": {
    "weixin-reader": {
      "command": "python",
      "args": [
        "C:/Users/你的用户名/Desktop/wx-mcp/wx-mcp-server/src/server.py"
      ]
    }
  }
}

주의: 경로를 실제 프로젝트 경로로 변경하십시오.

사용 예시

Claude에서 직접 사용:

请帮我总结这篇文章：https://mp.weixin.qq.com/s/nEJhdxGea-KLZA_IGw9R5A

Claude가 자동으로 read_weixin_article 도구를 호출하여 기사 내용을 가져오고 분석합니다.

기능 설명

read_weixin_article(url: str)

위챗 공식 계정 기사 내용을 읽습니다.

매개변수:

• url: 위챗 기사 URL, 형식: https://mp.weixin.qq.com/s/xxx

반환값:

{
  "success": true,
  "title": "文章标题",
  "author": "作者名",
  "publish_time": "2025-11-05",
  "content": "# 文章正文\n\n![封面](https://...)\n\n段落内容...",
  "cover_url": "https://mmbiz.qpic.cn/.../wx_fmt=jpeg",
  "error": null
}

v0.3.0부터 content 필드는 Markdown 형식입니다(v0.2.0 이전은 일반 텍스트). 하위 에이전트/프롬프트가 일반 텍스트로 처리하도록 되어 있다면 반환 전에 직접 Markdown 구문을 제거하거나, LLM이 더 잘 이해할 수 있도록 Markdown을 유지하십시오.

주의사항

• ⚠️ 개인 학습 및 연구용으로만 사용하십시오.

• ⚠️ 위챗 공식 플랫폼 서비스 약관을 준수하십시오.

• ⚠️ 고빈도 크롤링은 권장하지 않습니다(간격 > 2초 권장).

• ⚠️ 상업적 용도로 사용하지 마십시오.