Xiaohongshu Mcp

xiaohongshu-mcp

MCP for 小红书 / xiaohongshu.com。让你的 AI 助手直接访问小红书数据。

🚀 快速开始：选择最适合你的版本

重要

🔥 方案 A：Openclaw 深度集成 (推荐给开发者)

• Openclaw 太火啦 🔥🔥🔥 ，新增 Openclaw 支持，分为两种，请各位按需使用：
• xiaohongshu-mcp-skills（适用于已部署完本项目的用户）
• xiaohongshu-skills（开箱即用版）

ヒント

✨ 方案 B：x-mcp 浏览器插件版 (推荐给非技术同学 / 追求极简的用户)

• 不想折腾 Docker 或部署环境？试试：xpzouying/x-mcp
• 零配置：安装插件即用，无需任何代码、代理或复杂的环境配置。
• 安全稳定：直接在常用浏览器 (Chrome/Edge) 及本地网络运行，无服务器 IP 风险，且能解决 90% 的部署报错。

📖 相关资源

• 我的博客文章：haha.ai/xiaohongshu-mcp
• 贡献指南：Contributing Guide

🛠️ 疑难杂症

如果您在部署传统 Docker 版本时遇到问题，务必先查看：各种疑难杂症 (Issues #56)。

提示：如果环境排查太耗时，切换到 x-mcp 插件版 通常是更高效的选择。

Star History

赞赏支持

本项目所有的赞赏都会用于慈善捐赠。所有的慈善捐赠记录，请参考 DONATIONS.md。

捐赠时，请备注 MCP 以及名字。 如需更正/撤回署名，请开 Issue 或通过邮箱联系。

支付宝（不展示二维码）：

通过支付宝向 [email protected] 赞赏。

微信：

项目简介

主要功能

💡 提示： 点击下方功能标题可展开查看视频演示

"/Users/username/Videos/video.mp4"

小红书基础运营知识

• 标题：（非常重要）小红书要求标题不超过 20 个字
• 正文：（非常重要）：正文不能超过 1000 个字
• 当前支持图文发送以及视频发送：从推荐的角度看，图文的流量会比视频以及纯文字的更好。
• （低优先级）可以考虑纯文字的支持。1. 个人感觉纯文字会大大增加运营的复杂度；2. 纯文字在我的使用场景的价值较低。
• Tags：现已支持。添加合适的 Tags 能带来更多的流量。
• 根据本人实操，小红书每天的发帖量应该是 50 篇。
• （非常重要）小红书的同一个账号不允许在多个网页端登录，如果你登录了当前 xiaohongshu-mcp 后，就不要再在其他的网页端登录该账号，否则就会把当前 MCP 的账号“踢出登录”。你可以使用移动 App 端进行查看当前账号信息。
• 曝光低的话，首先查看内容中是否有违禁词，搜一下有很多第三方免费工具。
• 一定不要出现引流、纯搬运的情况，属于官方重点打击对象。

风险说明

1. 该项目是在自己的另外一个项目的基础上开源出来的，原来的项目稳定运行一年多，没有出现过封号的情况，只有出现过 Cookies 过期需要重新登录。
2. 我是使用 Claude Code 接入，稳定自动化运营数周后，验证没有问题后开源。
3. 如果账号没有实名认证，特别是新号，一般会触发 实名认证 的消息提醒（参见下图）。⚠️ 这个不是封号，不用 MCP 也会要求实名认证。实名认证后，账号就正常了。建议使用该项目前就先实名。

该项目是基于学习的目的，禁止一切违法行为。

实操结果

第一天点赞/收藏数达到了 999+，

一周左右的成果

1. 使用教程

1.1. 快速开始（推荐）

方式一：下载预编译二进制文件

直接从 GitHub Releases 下载对应平台的二进制文件：

主程序（MCP 服务）：

• macOS Apple Silicon: xiaohongshu-mcp-darwin-arm64
• Windows x64: xiaohongshu-mcp-windows-amd64.exe
• Linux x64: xiaohongshu-mcp-linux-amd64

登录工具：

• macOS Apple Silicon: xiaohongshu-login-darwin-arm64
• Windows x64: xiaohongshu-login-windows-amd64.exe
• Linux x64: xiaohongshu-login-linux-amd64

目前支持以上三个平台。macOS Intel 与 Linux ARM64 暂不支持。

使用步骤：

# 1. 首先运行登录工具
chmod +x xiaohongshu-login-darwin-arm64
./xiaohongshu-login-darwin-arm64

# 2. 然后启动 MCP 服务
chmod +x xiaohongshu-mcp-darwin-arm64
./xiaohongshu-mcp-darwin-arm64

⚠️ 重要提示：首次运行时会自动下载无头浏览器（约 150MB），请确保网络连接正常。后续运行无需重复下载。

方式二：源码编译

# 配置 GOPROXY 环境变量，以下三选一

# 1. 七牛 CDN
go env -w  GOPROXY=https://goproxy.cn,direct

# 2. 阿里云
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

# 3. 官方
go env -w  GOPROXY=https://goproxy.io,direct

方式三：使用 Docker 容器（最简单）

# 拉取最新镜像
docker pull xpzouying/xiaohongshu-mcp

# 下载 docker-compose.yml
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml

# 或者如果已经克隆了项目，进入 docker 目录
cd docker

# 启动服务
docker compose up -d

# 查看日志
docker compose logs -f

# 停止服务
docker compose stop

# 在项目根目录运行
docker build -t xpzouying/xiaohongshu-mcp .

Windows 遇到问题首先看这里：Windows 安装指南

1.2. ログイン

初回は手動でログインし、小红书のログイン状態を保存する必要があります。

バイナリファイルを使用する場合：

# 运行对应平台的登录工具
./xiaohongshu-login-darwin-arm64

ソースコードを使用する場合：

go run cmd/login/main.go

1.3. MCP サービスの起動

xiaohongshu-mcp サービスを起動します。

バイナリファイルを使用する場合：

# 默认：无头模式，没有浏览器界面
./xiaohongshu-mcp-darwin-arm64

# 非无头模式，有浏览器界面
./xiaohongshu-mcp-darwin-arm64 -headless=false

ソースコードを使用する場合：

# 默认：无头模式，没有浏览器界面
go run .

# 非无头模式，有浏览器界面
go run . -headless=false

プロキシの設定（任意）：

プロキシ経由でアクセスする場合は、XHS_PROXY 環境変数を設定します。

# 设置代理后启动
XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64

# 或使用源码
XHS_PROXY=http://proxy:port go run .

HTTP/HTTPS/SOCKS5 プロキシに対応しており、ログではプロキシの認証情報が自動的に非表示になります。

アクセス認証（任意）：

認証はデフォルトで無効です。本番環境では、AUTH_TOKEN 環境変数を使った設定を推奨します。空でない起動引数は環境変数より優先され、空の場合は AUTH_TOKEN を読み込みます。

# 环境变量
AUTH_TOKEN=your-secret-token ./xiaohongshu-mcp-darwin-arm64
AUTH_TOKEN=your-secret-token go run .

# 非空启动参数（优先于环境变量）
./xiaohongshu-mcp-darwin-arm64 -token=your-secret-token
go run . -token=your-secret-token

認証を有効にすると、すべての MCP クライアントでカスタムリクエストヘッダー Authorization: Bearer <token> を設定する必要があります。コマンドライン引数はプロセス一覧から見える場合があるため、デプロイ環境では AUTH_TOKEN を優先して使用してください。

たとえば、カスタムリクエストヘッダーに対応した MCP クライアントでは、以下の設定を使用できます。

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "headers": { "Authorization": "Bearer your-secret-token" }
    }
  }
}

1.4. MCP の検証

npx @modelcontextprotocol/inspector

実行後、赤いマークが付いたリンクを開き、MCP inspector を設定します。http://localhost:18060/mcp を入力し、Connect ボタンをクリックします。

注意： 左側の枠内のオプションが正しく設定されていることを確認してください。

上記の手順で MCP inspector を設定したら、List Tools ボタンをクリックして、すべてのツールを確認します。

1.5. MCP を使った投稿

ログイン状態の確認

画像とテキストの投稿

例では、テスト用に https://unsplash.com/ からランダムに画像を選んでいます。

コンテンツの検索

検索機能を使って、キーワードから小红书のコンテンツを検索します。

2. MCP クライアントの接続

このサービスは標準の Model Context Protocol (MCP) に対応しており、さまざまな MCP 対応 AI クライアントに接続できます。

2.1. クイックスタート

MCP サービスの起動

# 启动服务（默认无头模式）
go run .

# 或者有界面模式
go run . -headless=false

サービスは http://localhost:18060/mcp で実行されます。

サービスの状態の確認

# 测试 MCP 连接
curl -X POST http://localhost:18060/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-secret-token" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

Claude Code CLI の接続

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

# 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）
claude mcp list

2.2. 対応クライアント

# 添加 HTTP MCP 服务器
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

# 检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）
claude mcp list

opencode mcp add

┌  Add MCP server
│
◇  Enter MCP server name
│  xiaohongshu-mcp
│
◇  Select MCP server type
│  Remote
│
◇  Enter MCP server URL
│  http://localhost:18060/mcp
│
◇  Does this server require OAuth authentication?
│  No
│
◆  MCP server "xiaohongshu-mcp" added to C:\Users\admin\.config\opencode\opencode.json
│
└  MCP server added successfully

opencode mcp list

┌  MCP Servers
│
●  ✓ xiaohongshu-mcp connected

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "description": "小红书内容发布服务 - MCP Streamable HTTP"
    }
  }
}

{
  "servers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

{
  "mcpServers": {
    "xiaohongshu": {
      "httpUrl": "http://localhost:18060/mcp",
      "timeout": 30000
    }
  }
}

# 启动 MCP Inspector
npx @modelcontextprotocol/inspector

# 在浏览器中连接到：http://localhost:18060/mcp

{
  "xiaohongshu-mcp": {
    "url": "http://localhost:18060/mcp",
    "type": "streamableHttp",
    "autoApprove": [],
    "disabled": false
  }
}

帮我检查小红书登录状态

帮我发布一篇关于春天的图文到小红书，使用这张图片：/path/to/spring.jpg

搜索小红书上关于"美食"的内容

npm i -g mcporter
npx mcporter config add xiaohongshu-mcp http://localhost:18060/mcp
npx mcporter list xiaohongshu-mcp

{
  "name": "xiaohongshu-mcp",
  "url": "http://localhost:18060/mcp",
  "type": "http"
}

2.3. 利用可能な MCP ツール

接続に成功すると、以下の MCP ツールを使用できます。

• check_login_status - 小紅書のログイン状態を確認します（パラメーターなし）
• get_login_qrcode - ログイン用 QR コードを取得します。Base64 画像とタイムアウト時間を返します（パラメーターなし）
• delete_cookies - cookies ファイルを削除してログイン状態をリセットします。削除後は再ログインが必要です（パラメーターなし）
• publish_content - 小紅書に画像とテキストのコンテンツを投稿します（必須：title, content, images）
  • images: 画像パスのリスト（1枚以上）。HTTP リンクまたはローカルの絶対パスに対応しています。ローカルパスを推奨します
  • tags: ハッシュタグのリスト（任意）。例：["美食", "旅行", "生活"]
  • schedule_at: 投稿予約日時（任意）。ISO8601 形式で、1時間後から14日後まで指定できます
  • is_original: オリジナルであることを宣言するかどうか（任意）。デフォルトでは宣言しません
  • visibility: 公開範囲（任意）。公開（デフォルト）、自分のみ、相互フォローの友達のみに対応しています
  • products: 商品キーワードのリスト（任意）。商品を紐付けるために使用します。商品名または商品IDを入力すると、システムが自動的に検索し、最初に一致した結果を選択します。アカウントで商品機能が有効になっている必要があります。例: [フェイスマスク, 日焼け止め SPF50]
• publish_with_video - 小紅書に動画コンテンツを投稿します（必須：title, content, video）
  • video: ローカル動画ファイルの絶対パス（動画ファイルは1つのみ対応）
  • tags: ハッシュタグのリスト（任意）。例：["美食", "旅行", "生活"]
  • schedule_at: 投稿予約日時（任意）。ISO8601 形式で、1時間後から14日後まで指定できます
  • visibility: 公開範囲（任意）。公開（デフォルト）、自分のみ、相互フォローの友達のみに対応しています
  • products: 商品キーワードのリスト（任意）。商品を紐付けるために使用します。商品名または商品IDを入力すると、システムが自動的に検索し、最初に一致した結果を選択します。アカウントで商品機能が有効になっている必要があります。例: [フェイスマスク, 日焼け止め SPF50]
• list_feeds - 小紅書のホームページに表示されるおすすめ一覧を取得します（パラメーターなし）
• search_feeds - 小紅書のコンテンツを検索します（必須：keyword）
  • filters: 絞り込み条件（任意）
    • sort_by: 並べ替え基準 - 総合（デフォルト）| 最新 | いいね数が多い順 | コメント数が多い順 | お気に入り数が多い順
    • note_type: 投稿の種類 - 指定なし（デフォルト）| 動画 | 画像とテキスト
    • publish_time: 投稿日時 - 指定なし（デフォルト）| 過去1日 | 過去1週間 | 過去半年
    • search_scope: 検索範囲 - 指定なし（デフォルト）| 閲覧済み | 未閲覧 | フォロー中
    • location: 距離 - 指定なし（デフォルト）| 同じ都市 | 近く
• get_feed_detail - 投稿の詳細（エンゲージメントデータとコメントを含む）を取得します（必須：feed_id, xsec_token）
  • load_all_comments: コメントをすべて読み込むかどうか（任意）。デフォルトは false で、最初の10件のトップレベルコメントのみを返します
  • limit: 読み込むトップレベルコメント数の上限（任意）。load_all_comments=true の場合のみ有効です。デフォルトは20です
  • click_more_replies: 二次返信を展開するかどうか（任意）。load_all_comments=true の場合のみ有効です。デフォルトは false です
  • reply_limit: 返信数が多すぎるコメントをスキップするための上限（任意）。click_more_replies=true の場合のみ有効です。デフォルトは10です
  • scroll_speed: スクロール速度（任意）。slow | normal | fast。load_all_comments=true の場合のみ有効です
• post_comment_to_feed - 小紅書の投稿にコメントします（必須：feed_id, xsec_token, content）
• reply_comment_in_feed - 投稿の指定したコメントに返信します（必須：feed_id, xsec_token, content、および comment_id または user_id のいずれか1つ以上）
• like_feed - いいね、またはいいねを取り消します（必須：feed_id, xsec_token）
  • unlike: いいねを取り消すかどうか（任意）。true はいいねを取り消し、デフォルトではいいねを付けます
• favorite_feed - お気に入り登録、または登録を解除します（必須：feed_id, xsec_token）
  • unfavorite: お気に入り登録を解除するかどうか（任意）。true は登録を解除し、デフォルトでは登録します
• user_profile - ユーザーのプロフィール情報を取得します（必須：user_id, xsec_token）

2.4. 使用例

Claude Code を使って小紅書にコンテンツを投稿します。

例 1：HTTP 画像リンクを使用

帮我写一篇帖子发布到小红书上，
配图为：https://cn.bing.com/th?id=OHR.MaoriRock_EN-US6499689741_UHD.jpg&w=3840
图片是："纽西兰陶波湖的Ngātoroirangi矿湾毛利岩雕（© Joppi/Getty Images）"

使用 xiaohongshu-mcp 进行发布。

例 2：ローカル画像パスを使用（推奨）

帮我写一篇关于春天的帖子发布到小红书上，
使用这些本地图片：
- /Users/username/Pictures/spring_flowers.jpg
- /Users/username/Pictures/cherry_blossom.jpg

使用 xiaohongshu-mcp 进行发布。

例 3：動画コンテンツを投稿

帮我写一篇关于美食制作的视频发布到小红书上，
使用这个本地视频文件：
- /Users/username/Videos/cooking_tutorial.mp4

使用 xiaohongshu-mcp 的视频发布功能。

投稿結果：

⚠️ 以下是使用 OpenClaw + MCPorter 时的已知风险，使用前请充分了解：

• OpenClaw 的 AI 自动部署行为不在本项目的维护范围内，部署结果无法保证
• MCPorter 作为中间层可能引入额外的兼容性问题，与 xiaohongshu-mcp 本身无关
• 若遇到连接失败、工具调用异常等问题，请先排查 MCPorter 自身的配置，而非提交 Issue
• 在提问社区或群组前，请先确认问题是否能在不使用 OpenClaw 的情况下复现

如果你没有强烈的 OpenClaw 使用需求，强烈建议改用 Claude Code CLI、Cursor 或 Cline 等原生支持 HTTP MCP 的客户端，体验会更稳定。

Q: 为什么检查登录用户名显示 xiaghgngshu-mcp？ A: 用户名是写死的。

Q: 显示发布成功后，但实际上没有显示？ A: 排查步骤如下：

1. 使用 非无头模式 重新发布一次。
2. 更换 不同的内容 重新发布。
3. 登录网页版小红书，查看账号是否被 风控限制网页版发布。
4. 检查 图片大小 是否过大。
5. 确认 图片路径中没有中文字符。
6. 若使用网络图片地址，请确认 图片链接可正常访问。

Q: 在设备上运行 MCP 程序出现闪退如何解决？ A:

1. 建议 从源码安装。
2. 或使用 Docker 安装 xiaohongshu-mcp，教程参考：
   • 使用 Docker 安装 xiaohongshu-mcp
   • X-MCP 项目页面

Q: 使用 http://localhost:18060/mcp 进行 MCP 验证时提示无法连接？ A:

• 在 Docker 环境 下，请使用 👉 http://host.docker.internal:18060/mcp
• 在 非 Docker 环境 下，请使用 本机 IPv4 地址 访问。

3. 🌟 实战案例展示 (Community Showcases)

💡 强烈推荐查看：这些都是社区贡献者的真实使用案例，包含详细的配置步骤和实战经验！

📚 完整教程列表

1. n8n 完整集成教程 - 工作流自动化平台集成
2. Cherry Studio 完整配置教程 - AI 客户端完美接入
3. Claude Code + Kimi K2 接入教程 - Claude Code 门槛太高，那么就接入 Kimi 国产大模型吧～
4. AnythingLLM 完整指南 - AnythingLLM 是一款 all-in-one 多模态 AI 客户端，支持 workflow 定义，支持多种大模型和插件扩展。

🎯 提示: 点击上方链接查看详细的图文教程，快速上手各种集成方案！

📢 欢迎贡献: 如果你有新的集成案例，欢迎提交 PR 分享给社区！

4. 小红书 MCP 互助群

重要：在群里问问题之前，请一定要先仔细看完 README 文档以及查看 Issues。

微信群

微信群 26 群	微信群 27 群

飞书群

飞书 2 群	飞书 3 群	飞书 4 群	飞书 5 群

注意：

1. 微信群的二维码有时间限制，有时候忘记更新，麻烦等待更新或者提交 Issue 催我更新。
2. 飞书群，如果有的群满了，可以尝试扫一下另外一个群，总有坑位。

🙏 致谢贡献者 ✨

感谢以下所有为本项目做出贡献的朋友！（排名不分先后）

zy 💻 🤔 📖 🎨 🚧 🚇 👀	clearwater 💻	Zhongpeng 💻	Duong Tran 💻	Angiin 💻	Henan Mu 💻	Journey 💻
Eve Yu 💻	CooperGuo 💻	Banghao Chi 💻	varz1 💻	Melo Y Guan 💻	lmxdawn 💻	haikow 💻
Carlo 💻	hrz 💻	Ctrlz 💻	flippancy 💻	Yuhang Lu 💻	Bryan Thompson 💻	tan jun 💻
coldmountain 💻	mamage 💻 📖	Runyang YOU 💻 📖	e0_7 💻 📖	prehisle 💻 📖	Xinhao Chen 💻 📖	qiuxsgit 💻
openlts 💻	galois1983 💻	Peip 💻

✨ 特别感谢

@wanpengxie

@tanxxjun321

@Angiin

本项目遵循 all-contributors 规范。欢迎任何形式的贡献！

📄 许可证

本项目采用 Apache License 2.0 开源。

你可以自由地使用、修改和分发本项目，包括用于商业用途，只需保留原始的版权声明和许可证文件。详细条款以 LICENSE 文件为准。

向本项目提交的贡献，默认按同一许可证授权。