tmwgsicp/wechat-download-api

해결하는 문제

이 프로젝트는 WeChat 공식 계정 생태계의 폐쇄성을 극복하는 방법을 제공합니다. 사용자는 RSS를 통해 어떤 공개 계정이든 구독할 수 있으며, 기사 본문(이미지 포함)을 완전히 스크래핑하고, 오프라인 읽기나 AI 학습을 위해 다양한 형식으로 아카이브를 내보낼 수 있습니다. 또한 계정 정지 방지를 위한 악성 봇 방지 조치를 구현했습니다.

작동 방식

이 시스템은 WeChat 공식 계정 관리자 로그인을 QR 코드를 통해 수행하여 필요한 자격 증명을 얻는 API 브리지 역할을 합니다. 이후 curl_cffi를 통해 Chrome TLS 지문을 시뮬레이션하고, SOCKS5 프록시 풀을 사용하여 실제 브라우저의 동작을 모방하며 IP 주소를 회전시켜 WeChat의 보안 시스템에 의해 탐지되는 위험을 줄입니다. 백그라운드 폴링 기능은 구독한 계정의 새 기사를 자동으로 가져와 로컬 SQLite 데이터베이스에 저장합니다.

대상 사용자

• RSS 사용자: Feedly나 FreshRSS와 같은 표준 리더에서 WeChat 계정을 구독하고 싶은 사람
• 지식 관리자: Obsidian이나 Logseq를 사용해 WeChat 기사를 Markdown 파일로 동기화하고 싶은 사람
• AI 애호가: LLM이나 개인 지식 기반에 공급할 수 있는 깨끗하고 구조화된 데이터(Markdown/JSON)가 필요한 사람
• 개발자: 계정을 검색하고 기사 메타데이터를 가져올 수 있는 프로그래밍 방식이 필요한 사람

주요 기능

• AI 통합: Claude, Cursor, Cline 등의 AI 클라이언트가 직접 기사를 검색하고 구독하며 읽을 수 있도록 하는 내장된 Model Context Protocol (MCP) 서버
• 다양한 형식 내보내기: 하나의 클릭으로 계정 전체를 Markdown, HTML, Word, PDF, EPUB, Excel 또는 JSON 형식으로 아카이브 가능
• 위험 방지 시스템: TLS 지문 시뮬레이션, 프록시 회전, 3단계 레이트 제한을 통해 WeChat의 스크래핑 방지 메커니즘에 대응
• 완전 본문 RSS: 기본 스크래퍼와 달리 본문과 이미지를 포함한 RSS 2.0 피드를 생성
• 이미지 프록시: WeChat의 이미지 핫링크(리치 방지) 제한을 해결하는 내장 프록시 포함