xiaohongshu-search-mcp：免登录的小红书搜索 MCP

让 Claude Code、Codex、Cursor、Claude Desktop 这类 AI 工具直接搜小红书笔记、读全文和评论、查博主、看热点。 不用登录小红书，不用 Cookie，不开浏览器，你自己的小红书账号完全不参与，也就不存在被风控的问题。

一个文件、不装依赖，Python 3.9 以上就能跑。只读，不能发笔记、点赞或私信。

30 秒接上

1. 在 okdata 注册拿一个 key（以 okd_ 开头）。

2. 下载：

git clone https://github.com/okdataapi/xiaohongshu-search-mcp
cd xiaohongshu-search-mcp

3. 加到你的 AI 工具里（把 okd_... 换成你的 key，/完整路径/ 换成上面目录的路径）。

Claude Code

claude mcp add xiaohongshu --scope user -e OKDATA_API_KEY=okd_... -- python3 "$PWD/server.py"

Cursor（~/.cursor/mcp.json）、Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "python3",
      "args": ["/完整路径/xiaohongshu-search-mcp/server.py"],
      "env": { "OKDATA_API_KEY": "okd_..." }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.xiaohongshu]
command = "python3"
args = ["/完整路径/xiaohongshu-search-mcp/server.py"]
env = { OKDATA_API_KEY = "okd_..." }

key 只写在你自己用户目录下的配置里，不要放进项目仓库。

Related MCP server: SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

能做什么

调用失败不扣钱。每个结果都带 cost_usd（这次花了多少）和抓取时间，AI 可以据此告诉你花了多少钱、数据是什么时候的。 返回的是精简字段，省 token。

可以直接这样问：

• “搜一下小红书上最近关于‘露营 装备’最火的 10 篇笔记，按收藏数排个表。”

• “读一下这篇笔记的评论，总结大家夸什么、吐槽什么：<粘贴分享文字>”

• “这个博主粉丝多少、最近都发什么？<主页链接>”

不想跑本地进程？

okdata 有远程 MCP：https://api.okdata.online/mcp（Streamable HTTP，请求头 Authorization: Bearer okd_...）。 除了小红书，还能查抖音、微信、快手、B站、微博、知乎、TikTok、X、YouTube、Instagram、Reddit 等，共 17 个平台、200 多个接口。配置方法见 okdata.online/zh/agents.md。

说明

• 这是 okdata 的示例项目，不是小红书的官方项目。server.py 只调用 okdata 的接口，本身没有爬虫。 接口文档：笔记搜索、笔记详情、 笔记评论。

• 只读取公开内容。请尊重作者版权和用户隐私，不要用来骚扰或批量收集个人信息。

• 测试：python3 -m unittest discover -s tests（本地模拟服务器，不联网、不花钱）。

• 问题和建议请提 issue。MIT 许可证。

English

A Xiaohongshu (RedNote) MCP server that needs no login: no account, no cookies, no browser. Six read-only tools let Claude Code, Codex, Cursor and other MCP clients search notes, read full text and comments, look up creators and see hot topics, at $0.02 a call (failed calls are free). One Python 3.9+ file, standard library only, stdio transport. Needs an okdata key in OKDATA_API_KEY: sign up.

claude mcp add xiaohongshu --scope user -e OKDATA_API_KEY=okd_... -- python3 /path/to/server.py

Prefer a hosted server? Use okdata's remote MCP at https://api.okdata.online/mcp (17 platforms, 200+ endpoints). Unofficial; public data only. MIT licence.