rednote-mcp 0.0.1__tar.gz

rednote_mcp-0.0.1/.gitignore

@@ -0,0 +1,148 @@
+# Python
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask
+instance/
+.webassets-cache
+
+# Scrapy
+.scrapy
+
+# Sphinx
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# Virtual environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Package managers
+.pdm-python
+.pdm-build/
+.pixi
+__pypackages__/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath
+*.sage.py
+
+# Type checkers
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+cython_debug/
+.ruff_cache/
+
+# Spyder / Rope
+.spyderproject
+.spyproject
+.ropeproject
+
+# mkdocs
+/site
+
+# Abstra
+.abstra/
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# PyPI
+.pypirc
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Cursor
+.cursorignore
+.cursorindexingignore
+
+# Project-specific
+browser_data/
+screenshots/
+logs/
+
+# OS
+.DS_Store
+Thumbs.db

rednote_mcp-0.0.1/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: rednote-mcp
+Version: 0.0.1
+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，启动超时建议适当放宽

rednote_mcp-0.0.1/README.md

@@ -0,0 +1,132 @@
+# 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，启动超时建议适当放宽

rednote_mcp-0.0.1/docs/README.en.md

@@ -0,0 +1,88 @@
+# RedNote-MCP-Plus
+
+<p align="center"><img src= "img/logo.png" width="600"/></p>
+
+[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
+[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![PyPI version](https://badge.fury.io/py/rednote_mcp_plus.svg)](https://badge.fury.io/py/rednote_mcp_plus)
+
+⚙️ MCP server with a more comprehensive suite of tools for RedNote(XiaoHongShu, xhs).
+
+## Key Features
+- Easy to Get Started: Experience the tool capabilities with just a few simple commands, no additional configuration required
+- Automated Interaction Tools: Includes publishing, liking, bookmarking, commenting, following and other tools to facilitate automated account management
+- Automated Scraping Tools: Includes search, note content scraping, user data scraping and other tools to facilitate content discovery
+
+## Tool List
+- ✅ Login: Must use this tool to log in to RedNote before using other tools, saves login state
+- ❤️ Like: Like any note
+- 📥 Bookmark: Bookmark any note
+- 💬 Comment: Comment on any note
+- 👤 Follow: Follow any user
+- 🖼️ Publish Note: Publish any image-text note
+- 🔍 Search Notes: Search notes by keyword
+- 📖 Note Content Scraping: Save any note in Markdown format
+- 📊 User Data Scraping: Get user nickname, bio, tags, interaction information
+
+## Quick Start
+
+If you want to quickly experience the tool capabilities, follow these steps:
+
+### Environment Setup
+1. Install uv:
+```bash
+brew install uv
+```
+
+2. Install playwright:
+```bash
+pip install playwright
+playwright install
+```
+
+3. Install node:
+```bash
+brew install node
+```
+
+4. Install RedNote MCP
+```bash
+uv tool install rednote_mcp_plus
+```
+
+### Quick Trial
+
+**Start MCP service debugging with one command!**
+```bash
+npx @modelcontextprotocol/inspector uvx rednote_mcp_plus
+```
+
+If everything goes well, you should now see all the tools listed as shown in the image, and you can try out any MCP tools you're interested in!
+
+![MCP Tools List](img/mcp_tools.png "MCP Tools List")
+
+> ⚠️ **Note:** Please make sure to use the manualLogin tool to log in to RedNote first before trying other tools!
+
+### Demo
+
+The image shows the results of getting note content, including title, author, images/videos, text content, tags, interaction data, publish time, publish location, and other data.
+
+![RedNote Note](img/note.png "RedNote Note")
+
+## MCP Server Configuration
+
+Using Cline configuration as an example:
+
+```json
+{
+  "mcpServers": {
+    "RedNote_MCP_Plus": {
+      "command": "uvx",
+      "args": [
+        "rednote_mcp_plus"
+      ]
+    }
+  }
+}
+```

rednote_mcp-0.0.1/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rednote-mcp"
+dynamic = ["version"]
+authors = [
+    {name = "MrMao007", email = "mty1209@gmail.com"}
+]
+description = "Plus version of MCP server for accessing RedNote"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli]>=1.0.0",
+    "playwright>=1.40.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.scripts]
+rednote_mcp = "rednote_mcp_plus:main"
+
+[project.urls]
+Homepage = "https://github.com/MrMao007/RedNote-MCP-Plus"
+
+[tool.hatch.version]
+path = "src/rednote_mcp_plus/__init__.py"
+validate-bump = false
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rednote_mcp_plus"]

rednote_mcp-0.0.1/red_note.md

@@ -0,0 +1,45 @@
+# 5s见证一张神图的诞生
+
+<div align="center">
+<img src="https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31r9lf4sa74005oup8jh9i8aohkafpoo" width="50" style="border-radius: 50%;" />
+
+**Turner特讷**
+</div>
+
+## 🎬 视频
+
+<div style="position: relative; width: 100%; padding-top: 56.25%;">
+    <iframe 
+        src="http://sns-video-qc.xhscdn.com/stream/1/110/259/01e9650db30723c8010370039bb2bfe547_259.mp4?sign=4202ed58b480ba3eadca83412daca940&t=6973dd78" 
+        style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
+        scrolling="no" 
+        border="0" 
+        frameborder="no" 
+        allowfullscreen="true">
+    </iframe>
+</div>
+
+
+
+## 📝 正文
+
+#一张封神[话题]#
+#神图[话题]#
+#神图主理人[话题]#
+
+## 🏷️ 标签
+
+`#一张封神` `#神图` `#神图主理人`
+
+## 📊 互动数据
+
+| 👍 点赞 | ⭐ 收藏 | 💬 评论 | 🔗 分享 |
+|:---:|:---:|:---:|:---:|
+| 19 | 4 | 0 | 5 |
+
+## ℹ️ 其他信息
+
+- **发布时间**：2026-01-12 23:07:53
+- **更新时间**：2026-01-12 23:10:51
+- **IP 属地**：浙江
+- **内容类型**：📹 视频