# Zhihu

> Zhihu is an open-source MCP server for news and media. Browse, search, download and publish Zhihu content from the terminal, for agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/kristhl181/zhihu-toolkit
- **MCP Registry name:** io.github.KrisTHL181/zhihu-mcp
- **Categories:** [news and media](https://ai-powered.com/categories/news-and-media), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

This is an unofficial command-line toolkit for Zhihu (not affiliated with Zhihu Inc., as the README says) that is also exposed to agents through an MCP entry point installed with the mcp extra. Authentication is by pasted cURL from browser DevTools, QR-code login with the Zhihu app, or importing a local browser session, with multiple saved profiles.

The CLI reads feeds, hot lists, questions, answers, articles, pins and Zhihu Daily; searches questions, articles, users and topics; downloads content as Markdown with YAML frontmatter in an incremental way; publishes and edits answers and articles from Markdown; votes, follows, comments and manages collections; and exports your activity as JSON. Optional extras add creator income analytics with charts and NLP tools such as word clouds and clustering.

Because it signs requests and mimics a browser TLS fingerprint to talk to Zhihu, users should treat it as at-your-own-risk. It needs Python 3.10 or newer and is MIT licensed.

## Features

- **Terminal reading:** Feeds, hot lists, questions, answers, articles and pins in a pager.
- **Markdown downloads:** Save content as Markdown with frontmatter, incrementally.
- **Search:** Search questions, articles, users and topics.
- **Publish and edit:** Write answers and articles from Markdown files.
- **Creator analytics:** Income trends and indicators drawn as charts.
- **Multiple profiles:** Switch between saved accounts.

## Good for

- Save a set of Zhihu answers as Markdown for notes
- Search Zhihu topics from an agent
- Publish an article from a local Markdown file
- Analyse creator income trends

## Install

### Claude Code (Terminal)

```sh
claude mcp add zhihu-mcp -- uvx zhihu-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zhihu-mcp": {
      "command": "uvx",
      "args": [
        "zhihu-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zhihu-mcp": {
      "command": "uvx",
      "args": [
        "zhihu-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zhihu-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zhihu-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zhihu-mcp": {
      "command": "uvx",
      "args": [
        "zhihu-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zhihu-mcp": {
      "command": "uvx",
      "args": [
        "zhihu-mcp"
      ]
    }
  }
}
```

## FAQ

### Is it official?

No. The README says it is unofficial and not affiliated with Zhihu Inc.

### How do I log in?

Paste a cURL from DevTools, scan a QR code, or import a browser session.

### What Python version?

3.10 or newer.

### Is download incremental?

Yes. Existing files with unchanged timestamps are skipped unless --force is used.

### Is Zhihu free?

Yes. Zhihu is open source, so you can use and self-host it for free.

### How do I add Zhihu to Claude Code?

Run this command in your terminal: claude mcp add zhihu-mcp -- uvx zhihu-mcp

### What are the best alternatives to Zhihu?

The closest alternatives to Zhihu are Scrapling MCP Server, TrendRadar, Firecrawl MCP Server, Douyin_TikTok_Download_API and SearXNG Search.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [machine_internet](https://ai-powered.com/mcp/machine-internet): machine_internet is an open-source MCP server for web search and scraping.
- [acrawl](https://ai-powered.com/mcp/acrawl): acrawl is an open-source MCP server for browser automation.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/zhihu
