Zhihu Scraper MCP Server

MCP 클라이언트에 Zhihu 전문 본문, 전체 댓글 트리, 유형별 검색 읽기 기능을 제공하는 MCP Server입니다.

이것은 zhihu-toolkit CLI(zhihu 명령)의 얇은 래퍼입니다: 각 도구는 CLI의 --json 인터페이스를 호출하고, 결과를 간결한 구조로 다듬어 반환하여 아바타/HTML/중복 타임스탬프 등의 필드가 모델 컨텍스트를 채우는 것을 방지합니다.

세 가지 기능에 집중합니다: 답변/기사 전문, 전체 댓글 트리, 유형별 정밀 검색 — 정확한 목록, 본문 추출, 댓글 수집이 필요한 시나리오에 적합합니다.

기능 개요

Related MCP server: zhihu MCP Server

환경 요구사항

• Python 3.12+

• uv

• Zhihu 로그인 상태(Cookie), zhihu auth paste로 가져오기; 이 Server는 자격 증명을 관리하거나 저장하지 않습니다.

빠른 시작

INSTALL.md 참조 (Claude Code / Agent 자동 설치용). 도구의 상세 매개변수와 사용 권장 사항은 USAGE.md 참조.

한 줄 요약:

git clone https://github.com/luyanhexay/zhihu-scraper-mcp.git
cd zhihu-scraper-mcp
uv sync --locked
.venv/bin/zhihu auth paste     # 粘贴浏览器 DevTools 复制的 cURL，Ctrl+D 结束

그런 다음 Claude Code에 등록합니다 (<ABS>를 이 저장소의 절대 경로로 바꾸세요):

claude mcp add zhihu-scraper -- <ABS>/.venv/bin/zhihu-scraper-mcp

자격 증명 및 개인정보

• 인증 정보는 zhihu CLI가 ~/.zhihu-cli/에 저장하며, 이 저장소 내에 있지 않습니다.

• 이 저장소에는 Cookie가 포함되어 있지 않습니다; .gitignore가 cookies.json 등의 파일을 추가로 차단하여 실수로 커밋되는 것을 방지합니다.

• 이 저장소를 배포해도 Zhihu 계정이 유출되지 않습니다. 사용자는 자신의 로그인 상태를 직접 가져와야 합니다.

알려진 문제

• 단일 답변의 HTML 엔드포인트는 Zhihu의 리스크 관리(__zse_ck)에 자주 차단됩니다. get_fulltext는 자동으로 "질문 API에서 해당 답변을 골라내는" 경로로 폴백하므로, 가능하면 /question/<id>/answer/<id>가 포함된 전체 답변 URL을 전달하세요.

• 검색 키워드는 간결하게(≤3단어), 너무 길면 빈 결과가 반환되기 쉽습니다.

• 리스크 관리가 트리거되면 브라우저에서 먼저 검증을 완료한 후 zhihu auth paste로 로그인 상태를 다시 새로고침하세요.

감사의 말

• zhihu-toolkit / zhihu-cli

• Model Context Protocol

License

MIT