MCP.Market

CN Scraper MCP server

by goesByhc·io.github.goesByhc/cn-scraper-mcp·v0.4.1·47 stars

MCP server for AI agents to search major Chinese internet platforms with local-first login support.

A88/100grade A
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

47 stars

Reviews

Write one

Nobody 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 posts

Read 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

no findings
  • 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
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.server

Docker

容器内预装 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.

  • Jshookmcp
    Search-first MCP server for JavaScript reverse engineering: 735 tools across 36 domains.
    C
  • AIHOT
    Chinese AI news: search topics, explore hot events, and read daily, weekly and monthly briefs.
    B
  • Free Search
    No-API-key web search, page fetching and document reading across many engines. Local-first.
    B
  • FrankenSurf
    Read any web page and search the web: 28 tools, cheapest first, every page checked.
    A
  • Open Library
    Search books and authors on the Internet Archive's Open Library
    A