xhs-mcp

一个用于小红书API的MCP（Model Context Protocol）服务器，支持搜索笔记、获取内容、查看评论和发表评论等功能。

• 采用js逆向出x-s,x-t,直接请求http接口,无须笨重的playwright
• 搜索笔记
• 获取笔记内容
• 获取笔记的评论
• 发表评论

• Python 3.12+
• uv (安装方法: pip install uv)

打开web小红书 登录后，获取cookie，将cookie配置到下一步的 XHS_COOKIE 环境变量中

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

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

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

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

• node
• python 3.12
• uv (pip install uv)

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

打开web小红书 登录后，获取cookie，将cookie配置到下一步的 XHS_COOKIE 环境变量中

{
    "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) - 获取笔记内容（需要带xsec_token的完整URL）
• get_note_comments(url) - 获取笔记评论（需要带xsec_token的完整URL）
• post_comment(comment, note_id) - 发布评论到指定笔记

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的安装路径。

本项目仅用于学习交流，禁止用于其他用途，任何涉及商业盈利目的均不得使用，否则风险自负。