Skip to main content
Glama
Stride28 Search MCP

Stride28 Search MCP

by BrunonXU




这是 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

平台

说明

login_xiaohongshu

小红书

扫码登录,Cookie 持久化

search_xiaohongshu

小红书

关键词搜索,支持图文/视频过滤

get_note_detail

小红书

笔记详情 + 评论翻页 + 发布时间

login_zhihu

知乎

手动登录

reset_xiaohongshu_login

小红书

清空当前 profile 的登录态

search_zhihu

知乎

关键词搜索(问答/专栏/视频)

get_zhihu_question

知乎

Top N 回答,内容长度可配置

reset_zhihu_login

知乎

清空当前 profile 的登录态

search_xiaohongshu

参数

类型

默认值

说明

query

string

必填

搜索关键词

limit

int

10

返回条数;推荐 10-20,主要影响返回多少条,不会额外触发评论翻页

note_type

string

"all"

"all" / "normal" / "video"

get_note_detail

参数

类型

默认值

说明

note_id

string

必填

笔记 ID

xsec_token

string

""

安全 token

max_comments

int

10

推荐 10-20;超过 20 属于更深评论抓取。服务端会将大于 50 的值按 50 处理,以控制单次详情请求强度

search_zhihu

参数

类型

默认值

说明

query

string

必填

搜索关键词

limit

int

10

推荐 5-10;主要影响返回多少条解析结果

get_zhihu_question

参数

类型

默认值

说明

question_id

string

必填

问题 ID

limit

int

5

推荐 3-5;主要影响返回多少条回答

max_content_length

int

10000

最大字符数,0 = 不截断;这是输出长度控制,不是风控参数

推荐使用方式

普通使用时,建议把这个 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-20

    • 20-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_required

未登录

✗

调用 login tool

login_timeout

登录超时

✓

重新登录

search_timeout

搜索超时

✓

稍后重试

search_blocked

搜索结果异常为空

✗

检查无头模式、风控或重新登录

risk_cooldown_active

风控冷却中

✗

等待冷却结束或清空状态后重测

browser_init_failed

浏览器启动失败

✗

stride28-search-mcp install-browser

browser_crashed

浏览器崩溃

✗

重启 MCP Server

captcha_detected

验证码拦截

✗

等待后重试

unknown_error

未知错误

✗

查看日志

变量

默认值

说明

STRIDE28_SEARCH_MCP_HOME

~/.stride28-search-mcp

数据目录

STRIDE28_SEARCH_MCP_PROFILE

""

浏览器 profile 名;为空时走兼容模式,共享默认目录,不推荐

STRIDE28_XHS_HEADLESS

false

小红书非登录工具默认有头,优先降低风控

STRIDE28_ZHIHU_HEADLESS

true

知乎默认无头

STRIDE28_SEARCH_MCP_HEADLESS

true

兼容旧版本的全局 fallback,不再是主推荐配置

STRIDE28_RATE_LIMIT_SECONDS

5.0

请求最小间隔(秒)

STRIDE28_XHS_RISK_COOLDOWN_SECONDS

900

小红书命中风控后的冷却时长(秒)

小红书状态机

  • 未登录: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

推荐测试顺序:

  1. 为当前客户端设置独立 STRIDE28_SEARCH_MCP_PROFILE

  2. 运行 stride28-search-mcp doctor,确认 profile、浏览器目录、cookie 库路径、小红书/知乎 headless 设置、风控冷却状态正确

  3. 先调用 login_xiaohongshu,不扫码时不应返回成功

  4. 再调用 search_xiaohongshu,未登录时必须返回 login_required

  5. 完成登录后再次搜索,若仍空结果会明确返回 search_blocked 或 captcha_detected

  6. get_note_detail 默认只返回较少评论;如需更深评论翻页,请显式提高 max_comments

  7. 知乎同理,先 login_zhihu 再 search_zhihu

测试策略

  • 日常回归优先跑离线测试:认证状态机、快照回放、限流/熔断测试

  • 真实平台只保留 1 个低频人工 canary 账号

  • canary 每次只做 1 次登录验证 + 1 次搜索 + 1 次详情验证

  • 不建议拿多个小号做批量压测,也不要做连续自动回归

开发

详见 ARCHITECTURE.md

License

MIT

Available Tools

8 tools
get_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

    A4.3/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      1
      30
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and accessing Xiaohongshu (RedNote) content via natural language, with cookie-based authentication for note retrieval and keyword search.
      95 npm
      1,136
      MIT