CN Scraper MCP server
io.github.goesByhc/cn-scraper-mcp·v0.4.1·47 starsMCP server for AI agents to search major Chinese internet platforms with local-first login support.
47 stars
Reviews
Write oneNobody has reviewed CN Scraper MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
CN Scraper MCP tools (40, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
bilibili_comments获取 B 站视频一级评论,支持游标分页。无需登录或浏览器。
bilibili_popular获取 B 站当前热门视频榜。公开 HTTP API,无需登录或浏览器。
bilibili_search搜索 B 站视频。公开 HTTP API,无需登录或浏览器。
bilibili_video获取 B 站视频详情及互动统计。无需登录或浏览器。
check_cookies检查所有平台的 cookie 文件是否存在、有效字段及新鲜度。
diagnose诊断平台环境 — 检查 Python、依赖、Chrome、CDP 端口、Cookie、最近错误。
dianping_reviews获取大众点评商户评价。
dianping_search搜索大众点评商户。city 用于给 Agent 记录搜索城市。
dianping_shop获取大众点评商户详情。shop_id 来自 dianping_search。
douban_reviews获取豆瓣条目的短评/影评。支持 start 分页。
douban_search搜索豆瓣书籍、电影、音乐等条目。
douban_subject获取豆瓣条目详情。subject_id 来自 douban_search。
douyin_comments获取抖音视频评论(首屏)。需要登录 cookie。
douyin_hot_list抖音实时热搜榜。需要登录 cookie(首次用 guided_login 收割)。
douyin_search搜索抖音视频 — CDP 浏览器自动轮询,验证码自动等待。
douyin_video获取抖音视频详情(标题、作者、点赞、描述)。需要 Chrome。
guided_login打开浏览器让你登录平台,自动检测登录态并收割 Cookie。
harvest_cookies从用户自己的浏览器会话中自动提取 cookie(包括 HttpOnly cookie)。
jd_product获取京东商品详情(名称、价格、店铺、规格)。需要本地 Chrome。
jd_search搜索京东商品。需要已登录的有头 Chrome(会自动启动)。
pdd_product_detail获取拼多多商品详情(名称、价格、原价、销量、规格)。
pdd_search搜索拼多多商品。需要 Chrome + PDD cookie(PDDAccessToken + pdd_user_id)。
taobao_product获取淘宝商品详情(标题、价格、店铺)。
taobao_search搜索淘宝/天猫商品。纯脚本,无需浏览器,不限流。
verify_login远端验证缓存登录态是否仍被平台接受。
weibo_comments获取微博帖子的评论(支持分页)。需要登录 cookie(SUB token)。
weibo_hot_list获取微博实时热搜榜。**无需登录!**
weibo_postwrite action获取微博帖子的完整详情(含长文本)。
weibo_search搜索微博帖子。需要登录 cookies(SUB token)。
weibo_user_timeline获取微博用户时间线(最近发言)。
xiaohongshu_comments获取小红书笔记的评论(首屏,约 10-20 条)。
xiaohongshu_note获取小红书笔记详情(标题、正文、点赞、标签、评论)。
xiaohongshu_search搜索小红书笔记。需要本地 Chrome + XHS 登录 cookie。
zhihu_answer获取知乎回答的完整正文。
zhihu_comments获取知乎回答的评论(支持分页)。需要登录 cookie。
zhihu_hot_list获取知乎实时热榜。无需登录。
zhihu_question_answers获取知乎问题下的回答列表。
zhihu_search搜索知乎内容(问题/文章)。知乎已关闭游客搜索,需要有效登录 Cookie。
zsxq_article获取知识星球文章全文。
zsxq_topics获取知识星球 (ZSXQ) 付费社群最新帖子。
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan24 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 58 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How CN Scraper MCP compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 80% of 3,470 Web search servers
- Tools
- 40
- the typical Web search server has 5
- Tools that change things
- 3%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 47
- more than 92% of 1,786 Web search servers
What its tools let an agent do: 39 read · 1 change
Install CN Scraper MCP in Claude Code, Cursor or VS Code
claude mcp add cn-scraper-mcp -- uvx cn-scraper-mcp
What the publisher says
From the CN Scraper MCP repository's README, as published. We do not edit it. Read it on GitHub
CN Scraper MCP
让 AI Agent 直接搜索中国互联网——淘宝、京东、小红书、知乎、微博、B站、知识星球……不再被反爬墙挡住。
<!-- mcp-name: io.github.goesByhc/cn-scraper-mcp -->
这是什么
每个 AI Agent(Codex、Claude Code、Cursor、Trae)都能搜网页,但中文平台通常需要登录态、浏览器环境或平台专用参数:
- 淘宝:需要浏览器一致的网络指纹和登录 Cookie
- 京东:依赖已登录的本地浏览器环境
- 小红书:需要住宅 IP、本地浏览器和搜索结果中的访问参数
- 知乎:游客搜索已关闭,全部 API 需要登录态
- 拼多多:平台限制严格,目前不推荐使用
- 微博:搜索 API 需要登录态(SUB token),热搜游客即可访问
- 抖音:需要浏览器登录并可能人工处理验证码
- B站:搜索、热门、视频详情和评论可直接使用公开 API
- 豆瓣:条目搜索、条目详情和短评/影评
- 大众点评:商户搜索、商户详情和用户评价
- 知识星球:付费社群,内容藏在 cookie 认证的 REST API 后面
这个项目就是把踩了好几个月的坑打包成一个 MCP Server——你的 Agent 一句话就能搜:taobao_search("儿童学习桌")。
安全与隐私
cn-scraper-mcp 在你的电脑上本地运行,不需要把 Cookie、账号密码或浏览器 Profile 上传到任何中转服务器:
- Cookie 默认保存在 ~/.cn-scraper-cookies/,京东登录态保存在本地 Chrome Profile。
- 登录过程直接发生在平台官方页面,软件不会读取或保存你的账号密码。
- Cookie 值不会写入日志,也不会通过 MCP 工具结果返回给 Agent;工具只返回状态、字段名和本地路径等非敏感信息。
- 发起抓取或在线登录验证时,凭证只会发送给对应平台域名。
- 代码完全开源,所有凭证处理流程都可以审查。
建议仍像保护浏览器登录态一样保护本机账号:不要分享 Cookie 文件,不要把凭证提交到 Git,并限制本地文件的访问权限。
平台支持
电商
¹ 淘宝无硬性限流,但平台可能随时收紧,不建议高频批量抓取。
² 京东由本地 Chrome 生成登录态和动态签名,工具读取结构化 API 响应;通过 guided_login("jd") 可自动初始化持久化 Profile。
³ 拼多多每个浏览器会话仅放行第一次搜索,之后永久"系统繁忙"。单次搜索结果零实用价值,引擎代码保留但不推荐使用。
内容社区
⁴ 小红书只允许住宅 IP——云浏览器/数据中心 IP 直接封。必须用本地 Chrome。
⁵ 抖音搜索需要登录态 + 手动过滑块验证码。支持 120s 等待用户手动验证,通过后自动抓取。guided_login("douyin") 可引导登录。
快速开始
安装
pip install cn-scraper-mcp也可以从源码安装开发版本:
git clone https://github.com/goesByhc/cn-scraper-mcp.git
cd cn-scraper-mcp
pip install .推荐:CDP 自动登录并保存 Cookie
安装并连接 MCP 后,直接让 Agent 调用:
guided_login(platform="weibo")它会打开本地 Chrome 并进入平台官方登录页。你自己扫码或输入密码后,工具通过 CDP 自动读取完整 Cookie(包括 JavaScript 无法读取的 HttpOnly Cookie),再保存到本机 ~/.cn-scraper-cookies/。京东则保存到本地持久化 Chrome Profile。
这是推荐方式,因为它不会要求你复制 Cookie,不容易漏掉关键字段,也更适合 Cookie 过期后的重新登录。可用平台名包括 taobao、jd、xiaohongshu、zhihu、weibo、zsxq、douyin、pdd、douban 和 dianping。
已有通过远程调试端口启动且登录完成的 Chrome 时,也可以调用:
harvest_cookies(platform="weibo")启动
cn-scraper-mcp
# 或: python -m cn_scraper_mcp.serverDocker
容器内预装 Chromium,无需本地浏览器:
docker build -t cn-scraper-mcp .
docker run -i --rm \
-v ~/.cn-scraper-cookies:/root/.cn-scraper-cookies \
-v ~/.jd_login_profile:/root/.jd_login_profile \
cn-scraper-mcp远程服务器部署可以切换到 HTTP transport,通过 IP + 端口 连接:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
CN Scraper MCP: common questions
- Is CN Scraper MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the CN Scraper MCP safety report
- How do I install CN Scraper MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does CN Scraper MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is CN Scraper MCP maintained?
- The last commit was 98 days ago (2026-07-29). The latest release is v0.4.1.
- What can I use instead of CN Scraper MCP?
- Servers from other publishers that do the same job: Jshookmcp MCP server, AIHOT MCP server and Free Search MCP server.
- How does CN Scraper MCP compare with other Web search MCP servers?
- safety score 88/100 (higher than 80% of 3,470 Web search servers); tools 40 (the typical Web search server has 5); tools that change things 3% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to CN Scraper MCP
Same job from other publishers: the closest match first, then the best rated.
- JshookmcpSearch-first MCP server for JavaScript reverse engineering: 735 tools across 36 domains.not reviewedEstablishedC
- AIHOTChinese AI news: search topics, explore hot events, and read daily, weekly and monthly briefs.not reviewedEstablishedB
Free SearchNo-API-key web search, page fetching and document reading across many engines. Local-first.not reviewedEstablishedB- FrankenSurfRead any web page and search the web: 28 tools, cheapest first, every page checked.not reviewedEstablishedA
- Open LibrarySearch books and authors on the Internet Archive's Open Librarynot reviewedEstablishedA