# 小红书MCP服务
[![smithery badge](https://smithery.ai/badge/@jobsonlook/xhs-mcp)](https://smithery.ai/server/@jobsonlook/xhs-mcp)
[![PyPI version](https://badge.fury.io/py/jobson-xhs-mcp.svg)](https://badge.fury.io/py/jobson-xhs-mcp)

一个用于小红书API的MCP（Model Context Protocol）服务器，支持搜索笔记、获取内容、查看评论和发表评论等功能。
## 特点
- [x] 采用js逆向出x-s,x-t,直接请求http接口,无须笨重的playwright
- [x] 搜索笔记
- [x] 获取笔记内容
- [x] 获取笔记的评论
- [x] 发表评论

![特性](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/feature.png)

## 快速开始

### 方法一：使用uvx（推荐）

#### 1. 环境要求
- Python 3.12+
- uv (安装方法: `pip install uv`)

#### 2. 获取小红书的cookie
[打开web小红书](https://www.xiaohongshu.com/explore)
登录后，获取cookie，将cookie配置到下一步的 XHS_COOKIE 环境变量中
![cookie](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/cookie.png)

#### 3. 配置MCP服务器

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

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

#### 4. 测试运行
```bash
# 设置环境变量
export XHS_COOKIE="你的小红书cookie"

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

### 方法二：从源码安装

#### 1. 环境要求
- node
- python 3.12
- uv (pip install uv)

#### 2. 克隆并安装
```sh
git clone git@github.com:jobsonlook/xhs-mcp.git
cd xhs-mcp
uv sync
```

#### 3. 获取小红书的cookie
[打开web小红书](https://www.xiaohongshu.com/explore)
登录后，获取cookie，将cookie配置到下一步的 XHS_COOKIE 环境变量中
![cookie](https://raw.githubusercontent.com/jobsonlook/xhs-mcp/master/docs/cookie.png)

#### 4. 配置MCP服务器

```json
{
    "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)` - 发布评论到指定笔记

## 使用示例

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

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