小红书 MCP 服务

这是一个针对小红书API的MCP（模型上下文协议）服务器，支持搜索笔记、获取内容、查看评论和发布评论等功能。

功能

• [x] 使用JS反向工程x-s和x-t，直接请求HTTP接口，无需复杂的Playwright
• [x] 搜索笔记
• [x] 获取笔记内容
• [x] 获取笔记评论
• [x] 发布评论

快速开始

方法1：使用uvx（推荐）

1. 环境要求

• Python 3.12+
• uv（安装方法：pip install uv）

2. 获取小红书的cookie

打开小红书网页版 登录后，获取cookie，并在下一步中将其配置到XHS_COOKIE环境变量中

3. 配置MCP服务器

在您的MCP客户端配置文件中添加以下配置：

{
    "mcpServers": {
        "xhs-mcp": {
            "command": "uvx",
            "args": [
                "--from",
                "jobson-xhs-mcp",
                "xhs-mcp"
            ],
            "env": {
                "XHS_COOKIE": "你的小红书cookie"
            }
        }
    }
}

4. 测试运行

# 设置环境变量
export XHS_COOKIE="你的小红书cookie"

# 直接运行测试
uvx --from jobson-xhs-mcp xhs-mcp --help

方法2：从源代码安装

环境要求

• node
• Python 3.12
• uv（pip install uv）

2. 克隆并安装

git clone git@github.com:jobsonlook/xhs-mcp.git
cd xhs-mcp
uv sync

3. 获取小红书的cookie

打开小红书网页版 登录后，获取cookie，并在下一步中将其配置到XHS_COOKIE环境变量中

4. 配置MCP服务器

{
    "mcpServers": {
        "xhs-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/xhs-mcp",
                "run",
                "xhs_mcp/__main__.py"
            ],
            "env": {
                "XHS_COOKIE": "你的小红书cookie"
            }
        }
    }
}

可用工具

此MCP服务器提供以下工具：

• check_cookie() - 检查cookie是否已过期
• home_feed() - 获取首页推荐笔记
• search_notes(keywords) - 根据关键词搜索笔记
• get_note_content(url) - 获取笔记内容（需要完整的URL，包括xsec_token）
• get_note_comments(url) - 获取笔记评论（需要完整的URL，包括xsec_token）
• post_comment(comment, note_id) - 在指定笔记上发布评论

使用示例

在Claude Desktop中使用

1. 打开Claude Desktop的设置
2. 定位到MCP服务器配置
3. 添加上述JSON配置
4. 重启Claude Desktop
5. 现在您可以在对话中使用与小红书相关的功能

常见问题

Q: 如何获取cookie？ A: 在浏览器中登录小红书网页版，打开开发者工具，在Network标签下找到任何请求，复制Cookie头的值。

Q: 为什么提示cookie无效？ A: 小红书的cookie有时间限制，需要定期更新。只需再次登录网页版即可获取新的cookie。

Q: 未找到uvx命令？ A: 请先安装uv：pip install uv然后确保PATH环境变量包含uv的安装路径。

免责声明

本项目仅用于学习和交流目的，禁止用于其他用途。任何商业盈利相关的目的严格禁止，风险由用户自行承担。