Stride28 Search MCP

这是 Stride28 智能学习平台的搜索模块，独立抽出来作为 MCP 工具。

演示

Kiro + MCP 搜索

WorkBuddy + MCP 自动化（即将推出）

一键爬取小红书/知乎内容 → 接入腾讯文档/飞书文档自动整理 → 配合 Claw 实现每日自动化拉取、分类归档、摘要生成。

Related MCP server: RedNote MCP Server

使用场景

跟 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 的客户端

search_xiaohongshu

get_note_detail

search_zhihu

get_zhihu_question

推荐使用方式

普通使用时，建议把这个 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 判断是否重试。

小红书状态机

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