Stride28 Search MCP
Provides tools for searching Xiaohongshu (Little Red Book) notes, retrieving note details and comments, and managing login sessions.
Provides tools for searching Zhihu questions and articles, retrieving question details and answers, and managing login sessions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Stride28 Search MCP search Xiaohongshu for RAG interview questions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
这是 Stride28 智能学习平台的搜索模块,独立抽出来作为 MCP 工具。
演示
Kiro + MCP 搜索
WorkBuddy + MCP 自动化(即将推出)
一键爬取小红书/知乎内容 → 接入腾讯文档/飞书文档自动整理 → 配合 Claw 实现每日自动化拉取、分类归档、摘要生成。
Related MCP server: RedNote MCP
使用场景
跟 AI 助手说:
"帮我搜小红书上关于 RAG 的面试题"
"看看那篇笔记的详细内容和评论"
"去知乎搜搜 Agent 开发相关的讨论"
"只搜小红书的视频笔记"
"获取知乎这个问题的完整回答,不要截断"
AI 会自动调用对应的 MCP tool。首次使用时会弹出浏览器让你完成登录。
安装
Python 3.10+
# uv(推荐)
uv tool install stride28-search-mcp
# 或 pipx
pipx install stride28-search-mcp安装浏览器:
stride28-search-mcp install-browser配置
在 MCP 客户端配置中添加:
{
"mcpServers": {
"stride28-search": {
"command": "stride28-search-mcp",
"disabled": false
}
}
}建议为不同客户端显式设置不同的 STRIDE28_SEARCH_MCP_PROFILE,不要共用默认 profile。否则 Kiro、Work Buddy、本地手测会复用同一份 Chromium 持久化目录,导致“没扫码却像是已经登录”的假象。
Kiro 示例:
{
"mcpServers": {
"stride28-search": {
"command": "stride28-search-mcp",
"env": {
"STRIDE28_SEARCH_MCP_PROFILE": "kiro",
"STRIDE28_XHS_HEADLESS": "false",
"STRIDE28_ZHIHU_HEADLESS": "true"
},
"disabled": false
}
}
}Work Buddy 示例(实验性):
{
"mcpServers": {
"stride28-search": {
"command": "uvx",
"args": ["stride28-search-mcp"],
"env": {
"STRIDE28_SEARCH_MCP_PROFILE": "workbuddy",
"STRIDE28_XHS_HEADLESS": "false",
"STRIDE28_ZHIHU_HEADLESS": "true"
},
"disabled": false
}
}
}
uvx + WorkBuddy + 小红书搜索当前只作为实验性路径保留,不作为发版前必过项。默认推荐已安装包的 stdio 配置。
{
"mcpServers": {
"stride28-search": {
"command": "uvx",
"args": ["stride28-search-mcp"],
"disabled": false
}
}
}兼容:Kiro · Cursor · Claude Code · VS Code + Copilot · 任何支持 MCP stdio transport 的客户端
Tool | 平台 | 说明 |
| 小红书 | 扫码登录,Cookie 持久化 |
| 小红书 | 关键词搜索,支持图文/视频过滤 |
| 小红书 | 笔记详情 + 评论翻页 + 发布时间 |
| 知乎 | 手动登录 |
| 小红书 | 清空当前 profile 的登录态 |
| 知乎 | 关键词搜索(问答/专栏/视频) |
| 知乎 | Top N 回答,内容长度可配置 |
| 知乎 | 清空当前 profile 的登录态 |
search_xiaohongshu
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 搜索关键词 |
| int | 10 | 返回条数;推荐 |
| string |
|
|
get_note_detail
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 笔记 ID |
| string |
| 安全 token |
| int | 10 | 推荐 |
search_zhihu
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 搜索关键词 |
| int | 10 | 推荐 |
get_zhihu_question
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 问题 ID |
| int | 5 | 推荐 |
| int | 10000 | 最大字符数, |
推荐使用方式
普通使用时,建议把这个 MCP 当成“低频、定向检索工具”,而不是批量采集器。
小红书:先
login_xiaohongshu,再search_xiaohongshu,最后只对少量目标笔记调用get_note_detail知乎:先
login_zhihu,再search_zhihu,只对少量目标问题调用get_zhihu_question不建议让 agent 连续发起很多轮相似搜索,也不建议一上来就要求深翻很多评论
如果返回
captcha_detected、search_blocked或risk_cooldown_active,就先停,不要继续重试
参数建议
下面这些建议值主要是为了让 MCP 的行为更克制、更可解释,不是因为搜索结果数本身会直接暴露“使用 AI”。
search_xiaohongshu.limit默认
10推荐
10-20主要影响单页结果里返回多少条,不会像评论翻页那样明显增加交互强度
get_note_detail.max_comments默认
10推荐
10-2020-50视为更深评论抓取服务端硬上限
50
search_zhihu.limit默认
10推荐
5-10
get_zhihu_question.limit默认
5推荐
3-5
get_zhihu_question.max_content_length默认
10000用于控制输出长度和 token 成本,不属于风控核心参数
所有错误返回统一 JSON,包含 retryable 字段供 agent 判断是否重试。
错误码 | 含义 | 可重试 | 怎么办 |
| 未登录 | ✗ | 调用 login tool |
| 登录超时 | ✓ | 重新登录 |
| 搜索超时 | ✓ | 稍后重试 |
| 搜索结果异常为空 | ✗ | 检查无头模式、风控或重新登录 |
| 风控冷却中 | ✗ | 等待冷却结束或清空状态后重测 |
| 浏览器启动失败 | ✗ |
|
| 浏览器崩溃 | ✗ | 重启 MCP Server |
| 验证码拦截 | ✗ | 等待后重试 |
| 未知错误 | ✗ | 查看日志 |
变量 | 默认值 | 说明 |
|
| 数据目录 |
|
| 浏览器 profile 名;为空时走兼容模式,共享默认目录,不推荐 |
|
| 小红书非登录工具默认有头,优先降低风控 |
|
| 知乎默认无头 |
|
| 兼容旧版本的全局 fallback,不再是主推荐配置 |
|
| 请求最小间隔(秒) |
|
| 小红书命中风控后的冷却时长(秒) |
小红书状态机
未登录:search_xiaohongshu/get_note_detail返回login_required已登录:允许搜索和详情读取搜索被拦截:返回search_blocked风控冷却中:返回risk_cooldown_active,默认冷却 15 分钟
首次测试建议
先确认环境:
stride28-search-mcp doctor如果你要回到“新用户第一次安装”的状态:
stride28-search-mcp clear-state xhs
stride28-search-mcp clear-state zhihu或一次清空全部:
stride28-search-mcp clear-state all推荐测试顺序:
为当前客户端设置独立
STRIDE28_SEARCH_MCP_PROFILE运行
stride28-search-mcp doctor,确认 profile、浏览器目录、cookie 库路径、小红书/知乎 headless 设置、风控冷却状态正确先调用
login_xiaohongshu,不扫码时不应返回成功再调用
search_xiaohongshu,未登录时必须返回login_required完成登录后再次搜索,若仍空结果会明确返回
search_blocked或captcha_detectedget_note_detail默认只返回较少评论;如需更深评论翻页,请显式提高max_comments知乎同理,先
login_zhihu再search_zhihu
测试策略
日常回归优先跑离线测试:认证状态机、快照回放、限流/熔断测试
真实平台只保留 1 个低频人工 canary 账号
canary 每次只做 1 次登录验证 + 1 次搜索 + 1 次详情验证
不建议拿多个小号做批量压测,也不要做连续自动回归
开发
License
MIT
Available Tools
8 toolsget_note_detailA
获取小红书笔记的完整详情,包括正文、评论、图片、互动数据。需要提供 note_id 和 xsec_token(从搜索结果中获取)。需要先登录(login_xiaohongshu)。默认仅返回较少评论;如需更深评论翻页,请显式提高 max_comments。
Inputs: note_id (required), xsec_token, max_comments. Returns: result
get_zhihu_questionA
获取知乎问题的详情和 top N 回答。当前需要先登录(login_zhihu)。需要提供 question_id(从搜索结果的 xsec_token 字段获取)。
Inputs: question_id (required), limit, max_content_length. Returns: result
login_xiaohongshuA
登录小红书账号。调用后会弹出浏览器窗口,需要用户使用小红书 App 手动扫码完成登录。扫码后耗时约 10-30 秒完成登录流程,总超时 5 分钟。登录成功后,后续搜索调用将使用新的登录态。
Inputs: no named parameters. Returns: result
login_zhihuA
登录知乎账号。调用后会弹出浏览器窗口,需要手动登录。登录成功后,search_zhihu 和 get_zhihu_question 都会复用登录态。
Inputs: no named parameters. Returns: result
reset_xiaohongshu_loginA
清空当前 profile 下的小红书浏览器状态目录,用于重新走首次登录流程。
Inputs: no named parameters. Returns: result
reset_zhihu_loginA
清空当前 profile 下的知乎浏览器状态目录,用于重新走首次登录流程。
Inputs: no named parameters. Returns: result
search_xiaohongshuA
搜索小红书笔记内容。返回标题、URL、作者、点赞数等信息。limit 建议 10-20 条。需要先登录(login_xiaohongshu),未登录时返回 login_required 错误。
Inputs: query (required), limit, note_type. Returns: result
search_zhihuA
搜索知乎内容(问答、专栏、视频)。当前需要先登录(login_zhihu),未登录时返回 login_required 错误。返回标题、URL、类型、赞数、作者等信息。
Inputs: query (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a specific platform and action, with no overlap. The tools are clearly separated by platform (xiaohongshu vs zhihu) and operation (search, get detail, login, reset), making it easy for an agent to select the correct tool.
All tool names follow a consistent verb_noun pattern using underscore_case. The naming is systematic per platform: search_<platform>, get_<resource>, login_<platform>, reset_<platform>_login. Minor variation (get_note_detail vs get_zhihu_question) does not cause confusion.
With 8 tools covering two platforms, the count is well-scoped. Each tool serves a distinct purpose, and there are no redundant or missing essential operations. The tool set is neither too sparse nor too heavy.
The set covers the full lifecycle for searching and retrieving content from both platforms: login, search, get detail, and reset login. There are no obvious gaps for the intended use case of searching and reading content. The tools work together seamlessly.
Maintenance
Related MCP Connectors
RedNote (Xiaohongshu, 小红书) note search, full notes, comment threads and creator profiles.
搜索笔记、浏览首页推荐、查看笔记内容与评论,并发表你的评论。直接在工作流中与小红书内容互动,高效跟进话题。
Read Douyin, RedNote, Bilibili, Toutiao, Weibo, YouTube, TikTok as text; search RedNote and Douyin
XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables users to search and retrieve content from Xiaohongshu (Red Book) platform with smart search capabilities and rich data extraction including note content, author information, and images.130MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and accessing Xiaohongshu (RedNote) content via natural language, with cookie-based authentication for note retrieval and keyword search.95 npm1,136MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search, browse, and publish notes on Xiaohongshu (Little Red Book) via MCP tools.8AGPL 3.0
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and collect data from Xiaohongshu/REDnote, including notes, comments, and user info, with dual-layer anti-detection and persistent login.25-