Metadata-Version: 2.4
Name: rednote-mcp
Version: 0.0.2
Summary: Plus version of MCP server for accessing RedNote
Project-URL: Homepage, https://github.com/MrMao007/RedNote-MCP-Plus
Author-email: MrMao007 <mty1209@gmail.com>
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# rednote-mcp

`rednote-mcp` 是一个面向 MCP 客户端使用者的小红书 MCP Server。它通过 Playwright 和小红书网页能力，提供登录、笔记发布、点赞收藏评论、内容爬取等能力。

你可以把它接入支持 MCP 的客户端，例如 Claude Code、Cline、MCP Inspector，或任何兼容 `stdio` 的 MCP 工具。

## 它能做什么

- 登录小红书账号，手动扫码完成登录，自动保存登录态到本地
- 登录态保存在 `~/.rednote-mcp/rednote_cookies.json`，重启后无需重新登录
- 搜索笔记、爬取笔记内容（标题、正文、图片/视频、标签、互动数据）
- 爬取用户信息（昵称、简介、标签、互动数据）
- 点赞、收藏、评论笔记
- 关注用户
- 发布图文笔记

当前项目实际注册了 **9 个 MCP tools**。

## 环境要求

- Python 3.10 或更高版本
- 可正常启动的 Chromium 浏览器环境
- 能访问小红书网页

## 通过 uvx 使用（推荐）

无需手动安装，uvx 会自动处理。

### Claude Code 配置

```bash
claude mcp add rednote -- uvx rednote-mcp
```

### 首次运行

首次运行会自动安装 Playwright Chromium（约需 1-2 分钟）。

---

## 快速开始

### 默认作为 `stdio` MCP Server 运行

默认启动方式是 `stdio`，适合 Claude Code 等 MCP 客户端以子进程方式拉起。

```sh
uvx rednote-mcp
```

### 快速调试

```sh
npx @modelcontextprotocol/inspector uvx rednote-mcp
```

> ⚠️ **注意：** 请务必先使用 `manualLogin` 工具登录小红书后再使用其他工具！

## MCP 客户端配置

### Claude Code

```bash
claude mcp add rednote -- uvx rednote-mcp
```

### Cline / JSON 配置

```json
{
  "mcpServers": {
    "rednote-mcp": {
      "command": "uvx",
      "args": ["rednote-mcp"]
    }
  }
}
```

## Tools 一览

### 账号登录

- `manualLogin`：打开浏览器，手动完成小红书登录，关闭浏览器后自动保存登录态

### 笔记查询

- `searchNotes`：按关键词搜索笔记，返回笔记 URL 列表（支持指定返回数量）
- `dumpNote`：爬取指定笔记的完整内容，以 Markdown 格式返回（标题、正文、图片/视频、标签、互动数据、发布时间、IP 属地）

### 用户信息

- `dumpUser`：爬取指定用户主页信息（昵称、简介、标签、互动数据）

### 互动操作

- `likeNote`：点赞指定笔记
- `collectNote`：收藏指定笔记
- `commentNote`：评论指定笔记
- `followUser`：关注指定用户

### 发布

- `publishText`：发布图文笔记（支持图片 URL 列表、标题、正文、标签）

## 发布新版本到 PyPI

修改代码后，更新 `pyproject.toml` 中的版本号，然后：

```sh
# 安装构建工具（首次需要，指定官方源）
pip install hatch twine -i https://pypi.org/simple/

# 构建
hatch build

# 上传到 PyPI
# Username: __token__
# Password: 在 https://pypi.org/manage/account/ 的 API tokens 中创建
python -m twine upload dist/*

# 验证上传成功
uvx rednote-mcp==<新版本号> --help
```

> 注意：上传后 PyPI 同步约需 1-2 分钟，验证前稍等片刻。

## 使用建议

- 使用其他工具前，请先通过 `manualLogin` 完成登录
- 登录态保存在 `~/.rednote-mcp/`，重启服务后无需重新登录
- 首次启动会自动安装 Playwright/Chromium，启动超时建议适当放宽
