# CN Scraper MCP

Gives your agent tools to search Taobao, JD, Xiaohongshu, Zhihu, Weibo, Bilibili and more, with cookies kept on your machine.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 70
- Author: goesByhc
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/goesByhc/cn-scraper-mcp
- Updated: 2026-07-29
- HTML: https://affpapa.org/en/nevibecode/mcp/cn-scraper-mcp

## What it does

Agents can search the web, but Chinese platforms sit behind logins, browser fingerprints or platform-specific parameters. This server packages those workarounds into MCP tools: `taobao_search`, `jd_search`, `xiaohongshu_search`, `zhihu_search`, `weibo_search`, `bilibili_search`, `douban_search`, `dianping_search`, `zsxq_topics` and others. Some platforms run over plain HTTP, others need a local Chrome.

Install with `pip install cn-scraper-mcp`, then start it with `cn-scraper-mcp` or `python -m cn_scraper_mcp.server`. Python 3.11+ is required. The easiest login path is `guided_login(platform="weibo")`: it opens the official page, you sign in yourself, and the tool reads the cookies through CDP into `~/.cn-scraper-cookies/`. JD keeps its session in a local Chrome Profile. A Docker image ships with Chromium inside, and an HTTP transport mode covers remote setups.

Know the limits before you wire it up. Xiaohongshu only accepts residential IPs — datacenter addresses get blocked, so a local Chrome is mandatory there. Douyin is marked experimental: search needs a login and a manual captcha. Pinduoduo returns results only on the first search per browser session and then reports a system error, so the author advises against it. In HTTP mode, don't expose the port publicly: the tools reach your local cookies and profile.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add cn-scraper-mcp -- uvx cn-scraper-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from cn-scraper-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add cn-scraper-mcp -- uvx cn-scraper-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from cn-scraper-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cn-scraper-mcp": {
            "command": "uvx",
            "args": [
                "cn-scraper-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from cn-scraper-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cn-scraper-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "cn-scraper-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from cn-scraper-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cn-scraper-mcp uvx cn-scraper-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from cn-scraper-mcp <command>

## When to use it
- pull Taobao or JD listings with prices and sellers
- collect Xiaohongshu notes and comments
- get Zhihu answers and hot topics
- export Weibo posts and trending searches
- read Bilibili videos and comments

## Example prompts
- Search Taobao for kids' study desks and show prices and shops
- Collect Xiaohongshu notes about skincare
- Show today's Zhihu hot list

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 12927

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md