Skip to content
Agentmart
Submit a tool

CN Scraper MCP

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

Connector by goesByhc · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 70
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/goesbyhc-cn-scraper-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
18 read · 7 write · 0 delete · 15 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 40

Read from the source code; the running server may list different tools.

Read 18 · Look things up without changing anything.

  • bilibili_search
  • check_cookies
  • dianping_reviews
  • dianping_search
  • douban_search
  • douyin_hot_list
  • douyin_search
  • jd_search
  • pdd_search
  • taobao_search
  • verify_login
  • weibo_hot_list
Show 6 more tools
  • weibo_search
  • xiaohongshu_search
  • zhihu_answer
  • zhihu_hot_list
  • zhihu_question_answers
  • zhihu_search

Write 7 · Create, change, send or run things.

  • bilibili_comments
  • douyin_comments
  • guided_login
  • weibo_comments
  • weibo_post
  • xiaohongshu_comments
  • zhihu_comments

Not yet classified 15 · We could not tell from the name and description.

  • bilibili_popular
  • bilibili_video
  • diagnose
  • dianping_shop
  • douban_reviews
  • douban_subject
  • douyin_video
  • harvest_cookies
  • jd_product
  • pdd_product_detail
  • taobao_product
  • weibo_user_timeline
Show 3 more tools
  • xiaohongshu_note
  • zsxq_article
  • zsxq_topics

Network hosts it talks to 27

  • account.dianping.com · found in code
  • accounts.douban.com · found in code
  • api.bilibili.com · found in code
  • api.zsxq.com · found in code
  • articles.zsxq.com · found in code
  • bilibili.com · found in code
  • cli.github.com · found in code
  • dianping.com · found in code
  • douban.com · found in code
  • douyin.com · found in code
  • github.com · found in code
  • h5.m.taobao.com · found in code
  • h5api.m.taobao.com · found in code
  • item.jd.com · found in code
  • item.taobao.com · found in code
  • jd.com · found in code
  • login.taobao.com · found in code
  • m.douban.com · found in code
  • m.weibo.cn · found in code
  • mobile.yangkeduo.com · found in code
  • passport.jd.com · found in code
  • s.weibo.com · found in code
  • search.jd.com · found in code
  • weibo.com · found in code
  • wx.zsxq.com · found in code
  • xiaohongshu.com · found in code
  • zhihu.com · found in code

Files it touches

  • ~/.cn-scraper-cookies
  • ~/.cn-scraper-cookies/douyin.json
  • ~/.cn-scraper-cookies/pdd.json
  • ~/.cn-scraper-cookies/weibo.json
  • ~/.cn-scraper-cookies/xiaohongshu.json
  • ~/.cn-scraper-cookies/zhihu.json
  • ~/.cn-scraper-cookies/zsxq.json
  • Your home directory (~)
  • ~/.jd_login_profile

Tools (40)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • bilibili_comments

    获取 B 站视频一级评论,支持游标分页。无需登录或浏览器。 bvid 来自 bilibili_search 或 bilibili_popular;下一页传回上次结果中的 next_cursor。评论按 B 站热门评论模式返回。 Args: bvid: B 站 BV 号 limit: 返回条数上限(默认 20) cursor: 上一页返回的 next_cursor;第一页留空 Returns: {bvid, aid, total, count, comments: [{id, content, user, user_id, likes, reply_count, time}], next_cursor, is_end, pagination}

  • bilibili_popular

    获取 B 站当前热门视频榜。公开 HTTP API,无需登录或浏览器。 Args: limit: 返回条数上限(默认 20) Returns: {count, items: [{bvid, aid, title, author, views, likes, url}], no_more}

  • bilibili_search

    搜索 B 站视频。公开 HTTP API,无需登录或浏览器。 Args: keyword: 视频搜索关键词 limit: 返回条数上限(默认 10) Returns: {keyword, total, count, items: [{bvid, aid, title, description, author, duration, views, danmaku, published_at, cover, url}]}

  • bilibili_video

    获取 B 站视频详情及互动统计。无需登录或浏览器。 bvid 来自 bilibili_search 或 bilibili_popular 结果。 Args: bvid: B 站 BV 号 Returns: {bvid, aid, title, description, author, duration, views, danmaku, comments, likes, favorites, coins, shares, pages, url}

  • check_cookies

    检查所有平台的 cookie 文件是否存在、有效字段及新鲜度。 Cookie 文件查找路径 (按优先级): 1. 平台专用环境变量 (如 TAOBAO_COOKIES_FILE) 2. ~/.cn-scraper-cookies/<name>.json (推荐) JD 特殊: 检查 Chrome profile 目录 ~/.jd_login_profile Returns: {taobao, xiaohongshu, zhihu, zsxq, jd, pdd: {exists, valid, missing_fields, path, age_hours, stale}}

  • diagnose

    诊断平台环境 — 检查 Python、依赖、Chrome、CDP 端口、Cookie、最近错误。 不做任何实际抓取,纯本地诊断。每项检查超时 5 秒。 Returns: sections: platform: {package_version, python_version} dependencies: {fastmcp: {installed, version}, curl_cffi: {...}, ...} browsers: {chrome: {found, path, version}, obscura: {found, path}} cdp_ports: {9222: {in_use}, 9247: {...}, 9251: {...}} cookies: 来自 check_all_cookies() 的结果 diagnostics: {recent_errors: [...]}

  • 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。 video_id 来自 douyin_search 结果中 item 的 video_id 字段。 Args: video_id: 视频 ID limit: 返回条数 (默认 20) Returns: {video_id, count, comments: [{id, content, user, user_id, likes, time}]}

  • douyin_hot_list

    抖音实时热搜榜。需要登录 cookie(首次用 guided_login 收割)。 Returns: {count, items: [{word, hot_value, position, label}]}

  • douyin_search

    搜索抖音视频 — CDP 浏览器自动轮询,验证码自动等待。 需要 Chrome 已登录抖音(用 guided_login 先登录)。 弹出验证码时持续等待你手动过,通过后自动抓取结果。 Args: keyword: 搜索关键词 limit: 返回条数 (默认 10)

Show 25 more tools
  • douyin_video

    获取抖音视频详情(标题、作者、点赞、描述)。需要 Chrome。 video_id 来自 douyin_search 结果中 item 的 video_id 字段。 Args: video_id: 视频 ID Returns: {id, title, author, likes, description, url}

  • guided_login

    打开浏览器让你登录平台,自动检测登录态并收割 Cookie。 自动打开 Chrome → 导航到平台登录页 → 你扫码/输入密码 → 检测到你登录成功后自动收割 Cookie 并保存。 无需手动操作 CDP 端口——全程自动化。 Args: platform: 认证注册表中的平台名,包括京东、微博、抖音、豆瓣和大众点评。 port: CDP 端口 (可选, 默认 9222) Returns: {platform, count, saved_to, status, method: 'guided_login'}

  • harvest_cookies

    从用户自己的浏览器会话中自动提取 cookie(包括 HttpOnly cookie)。 通过 Chrome DevTools Protocol (CDP) 的 Network.getAllCookies 提取 浏览器 cookie jar 中的所有 cookie(含 HttpOnly,这是 JS 无法获取的)。 仅提取用户**自己**的浏览器会话——浏览器须已在指定端口运行且已登录。 非 profile 平台的 Cookie 保存到认证注册表指定的 JSON 文件。 京东使用持久化 Chrome profile,请改用 guided_login。 Args: platform: 认证注册表中的平台名。京东会返回 profile_required。 port: CDP 调试端口 (可选, 各平台有默认值) Returns: {platform, count, saved_to, status}

  • jd_product

    获取京东商品详情(名称、价格、店铺、规格)。需要本地 Chrome。 sku 来自 jd_search 结果中 item 的 sku 字段。 并发: ⚠️ 使用 BrowserLock 保护 CDP 端口。 Args: sku: 商品 SKU Returns: {sku, name, price, shop, specs, url}

  • jd_search

    搜索京东商品。需要已登录的有头 Chrome(会自动启动)。 京东 headless 返回 0 结果 → 必须 headful。 需要持久登录 profile (~/.jd_login_profile)。 首次使用需在弹窗 Chrome 中手动登录 jd.com 一次。 并发: ⚠️ 使用 BrowserLock 保护 CDP 端口,同端口调用自动串行化。 Args: keyword: 搜索关键词 limit: 返回条数上限 (默认 10) Returns: {keyword, count, items: [{sku, name, price, ad, url}]}

  • pdd_product_detail

    获取拼多多商品详情(名称、价格、原价、销量、规格)。 商品详情独立于搜索限制 — 不限次数。 Args: url_or_id: 商品 goods_id(如 "123456789")或完整 goods2.html URL Returns: {goodsId, name, price, origPrice, sales, specs, url, soldOut, state}

  • pdd_search

    搜索拼多多商品。需要 Chrome + PDD cookie(PDDAccessToken + pdd_user_id)。 ⚠️ 严重限制:拼多多手机搜索**每个浏览器会话仅允许一次搜索**。 第一次搜索后,所有后续搜索返回「系统繁忙」。 如需再次搜索,必须重启 MCP server 以创建新的浏览器会话。 原理: Chrome CDP + iPhone UA 模拟手机浏览器搜索。 Cookie 文件: ~/.cn-scraper-cookies/pdd.json Token 有效期约 1 小时,需定期从手机浏览器重新导出。 并发: ⚠️ 使用 BrowserLock 保护 CDP 端口,同端口调用自动串行化。 Args: keyword: 搜索关键词 limit: 返回条数上限 (默认 10) Returns: {keyword, count, items: [{goodsId, name, price, sold, url}]}

  • taobao_product

    获取淘宝商品详情(标题、价格、店铺)。 item_id 来自 taobao_search 结果中 item 的 id 字段。 并发安全: ✅ 纯 HTTP/MTOP API。 Args: item_id: 商品 ID Returns: {id, title, price, shop, url}

  • taobao_search

    搜索淘宝/天猫商品。纯脚本,无需浏览器,不限流。 原理: curl_cffi 伪造 Chrome TLS 指纹 + MTOP HMAC-MD5 签名。 需要 TAOBAO_COOKIES_FILE 环境变量或 ~/.cn-scraper-cookies/taobao.json。 并发安全: ✅ 纯 HTTP/REST API,无共享状态,任意并发调用安全。 Args: keyword: 搜索关键词,如 "华为mate70" limit: 返回条数上限 (默认 10) Returns: {keyword, total, items: [{title, price, origPrice, sales, id, shop, url}]}

  • verify_login

    远端验证缓存登录态是否仍被平台接受。 这与 check_cookies 的本地文件检查不同:本工具会发起只读在线请求。 当前可远端验证:知乎、微博、知识星球、抖音。 淘宝等没有稳定只读验证接口的平台会明确返回 unsupported。 Args: platform: 认证注册表中的平台名。 Returns: {platform, cache_state, verified, remote_state}

  • weibo_comments

    获取微博帖子的评论(支持分页)。需要登录 cookie(SUB token)。 mid 来自 weibo_search 或 weibo_user_timeline 结果中 item 的 id 字段。 Args: mid: 微博帖子 ID limit: 返回条数 (默认 20) max_id: 分页游标,从上一页的 next_max_id 字段获取(空 = 第一页) Returns: {mid, count, comments: [...], next_max_id}

  • weibo_hot_list

    获取微博实时热搜榜。**无需登录!** 原理: 调用 weibo.com/ajax/side/hotSearch(游客可访问)。 返回实时热搜 50 条 + 置顶政务话题。 并发安全: ✅ 纯 HTTP/REST API,无共享状态,任意并发调用安全。 Returns: {count, items: [{rank, word, num, url, label}], hotgov: {name, url}|null}

  • weibo_post

    获取微博帖子的完整详情(含长文本)。 mid 来自 weibo_search 或 weibo_user_timeline 结果中的 item.id。 Args: mid: 微博帖子 ID Returns: {id, text, user, user_id, attitudes, comments, reposts, created_at, url}

  • weibo_search

    搜索微博帖子。需要登录 cookies(SUB token)。 ⚠️ 微博搜索 API 需要登录 — 游客模式不可用。 热搜(weibo_hot_list)无需登录即可使用。 原理: 调用 m.weibo.cn 移动端 API,解析 cards[].mblog。 Cookie 文件: ~/.cn-scraper-cookies/weibo.json(需要 SUB cookie) 并发安全: ✅ 纯 HTTP/REST API,无共享状态,任意并发调用安全。 Args: keyword: 搜索关键词,如 "华为" limit: 返回条数上限 (默认 10) Returns: {keyword, count, items: [{id, text, user, attitudes, comments, reposts, url}]}

  • weibo_user_timeline

    获取微博用户时间线(最近发言)。 需要登录 cookie(SUB token)。 可通过 weibo_search 找到目标用户获取其 UID。 Args: uid: 用户 ID(数字,如 "2803301701" = 人民日报) limit: 返回帖子数 (默认 10) Returns: {uid, user, count, items: [{id, text, user, attitudes, comments, reposts, created_at, url}]}

  • xiaohongshu_comments

    获取小红书笔记的评论(首屏,约 10-20 条)。 需要本地 Chrome + XHS 登录 cookie。 note_id 和 xsec_token 都来自同一条 xiaohongshu_search 结果。 Args: note_id: 笔记 ID(16 位十六进制字符串) xsec_token: 同一搜索结果中的访问令牌(必填) Returns: {noteId, comments: [{content, userName, likes, time}]}

  • xiaohongshu_note

    获取小红书笔记详情(标题、正文、点赞、标签、评论)。 note_id 和 xsec_token 都来自同一条 xiaohongshu_search 结果。 Args: note_id: 笔记 ID(从 xiaohongshu_search 结果中的 noteId 字段) xsec_token: 反爬 token(从同一条 xiaohongshu_search 结果中的 xsec_token 字段) Returns: {id, title, desc, likes, collects, comments, tags, user, time}

  • xiaohongshu_search

    搜索小红书笔记。需要本地 Chrome + XHS 登录 cookie。 小红书只允许住宅 IP(本地 Chrome)——云浏览器/数据中心 IP 直接封。 需要 XHS cookies: web_session, a1, webId, gid 等。 Cookie 文件: ~/.cn-scraper-cookies/xiaohongshu.json 并发: ⚠️ 使用 BrowserLock 保护 CDP 端口,同端口调用自动串行化。 Args: keyword: 搜索关键词 limit: 返回条数 (默认 10) Returns: {keyword, items: [{title, author, likes, noteId, href}]}

  • zhihu_answer

    获取知乎回答的完整正文。 answer_id 来自 zhihu_search 结果中 type 为 "answer" 的 item 的 id 字段。 Args: answer_id: 回答 ID Returns: {id, content, excerpt, author, votes, comments, question_title, url}

  • zhihu_comments

    获取知乎回答的评论(支持分页)。需要登录 cookie。 answer_id 来自 zhihu_search 结果中 type 为 "answer" 的 item 的 id 字段。 Args: answer_id: 回答 ID limit: 返回条数 (默认 20) offset: 分页偏移 (默认 0,即第一页) Returns: {answer_id, count, comments: [...], has_next}

  • zhihu_hot_list

    获取知乎实时热榜。无需登录。 Returns: {items: [{title, url, excerpt, hot_metric}]}

  • zhihu_question_answers

    获取知乎问题下的回答列表。 question_id 来自 zhihu_search 结果中 type 为 "question" 的 item 的 id 字段。 Args: question_id: 问题 ID limit: 返回条数 (默认 20) Returns: {question_id, count, items: [{id, content, excerpt, author, votes, comments}]}

  • zhihu_search

    搜索知乎内容(问题/文章)。知乎已关闭游客搜索,需要有效登录 Cookie。 无需浏览器——直接调知乎 v4 search API。 需要 cookie: ~/.cn-scraper-cookies/zhihu.json(z_c0 + d_c0) 并发安全: ✅ 纯 HTTP/REST API,无共享状态,任意并发调用安全。 Args: keyword: 搜索关键词 limit: 返回条数 (默认 10) Returns: {keyword, items: [{title, excerpt, url, type, votes, comments}]}

  • zsxq_article

    获取知识星球文章全文。 article_url 来自 zsxq_topics 结果中的 topic 对象, 仅当 topic 类型为文章时可用(talk.article.inline_article_url)。 Args: article_url: 文章 URL(从 topic 的 inline_article_url 字段获取) Returns: {url, text} 或 {error, url}

  • zsxq_topics

    获取知识星球 (ZSXQ) 付费社群最新帖子。 纯 REST API,无需浏览器,只需 cookie。 Cookie 文件: ~/.cn-scraper-cookies/zsxq.json (需要 zsxq_access_token) 并发安全: ✅ 纯 HTTP/REST API,无共享状态,任意并发调用安全。 Args: group_id: 星球 ID (数字,如 "28888555451") count: 获取帖子数量 (默认 5) owner_only: 只看星主帖子 (默认 False) Returns: {group_id, count, topics: [{topic_id, title, text, author, created_at, comments}]}

Signals

Stars
70
Forks
8
Open issues
2
Contributors
1
Weekly downloads
157
Last commit
Jul 29, 2026 (3 months ago)
Last release
Jul 29, 2026 (3 months ago)
Last package publish
Jul 29, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.goesByhc/cn-scraper-mcp
Version
0.4.1
Auth
No auth
Packages
pypi cn-scraper-mcp
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Cite this page

CN Scraper MCP. Agent Mart. https://agentmart.dev/connectors/goesbyhc-cn-scraper-mcp (last updated 2026-10-24)