如何使用 xiaohongshu-mcp 来简化小红书内容发布

你是否在想，如何通过编程工具来管理小红书上的内容发布？或许你是一个开发者，希望自动化一些社交媒体任务，比如上传图文帖子，而不需要每次手动操作。今天，我们来聊聊 xiaohongshu-mcp 这个项目。它是一个基于 Model Context Protocol (MCP) 的工具，专门为小红书设计，能帮助你登录账户并发布图文内容。别担心，我会一步步解释清楚，从基础设置到实际应用，全都基于这个项目的实际功能。

想象一下，你有一个想法，想快速在小红书上分享一篇带图片的帖子，但又不想每次都打开app手动编辑。xiaohongshu-mcp 就是为此而生的。它支持登录和发布图文，后续可能还会扩展更多功能，比如搜索。但现在，我们重点关注它现有的能力。

什么是 xiaohongshu-mcp？

如果你是第一次听到这个名字，别慌。xiaohongshu-mcp 是一个开源项目，旨在通过 MCP 协议连接小红书的服务。MCP 是一种协议，能让模型或工具上下文交互更顺畅，这里它被用来处理小红书的登录和内容发布。

简单说，这个项目有两大核心功能：

• 登录：确保你的小红书账户安全连接。
• 发布图文：上传文字和图片到小红书。

它还计划添加搜索功能，但目前还没实现。我们会基于现有的工具来讨论。

为什么选择这个工具？因为它用 HTTP JSON-RPC 协议提供服务，让开发者容易集成。服务端点包括 HTTP API 和 MCP 协议，运行在本地端口上。

准备工作：安装和环境设置

在开始使用前，你需要设置环境。假设你有基本的 Go 语言知识（因为项目是用 Go 写的），我们从头来。

你需要什么？

• Go 语言环境：项目是用 Go 开发的，所以确保你的机器上安装了 Go。
• 命令行工具：像 bash 或终端，能运行命令。
• 小红书账户：用于登录。

没有额外的包需要安装，一切都在项目代码中。

如何启动？

先克隆项目（假设你已经下载了代码）。然后，跟着这些步骤走。

步骤1：登录小红书账户

你可能会问：“我怎么登录小红书？需要浏览器吗？”是的，第一次登录是手动的，以保存状态。

运行这个命令：

go run cmd/login/main.go

这会打开一个界面，让你输入小红书凭证。登录后，状态会被保存，以后就不用重复了。

为什么需要这一步？因为小红书要求认证，没有登录，你没法发布内容。这就像在app上登录一样，但通过代码实现。

如果登录失败，怎么办？检查你的网络，或者确保命令路径正确。项目中提到，这是必须的第一步。

这里是一张动图，展示了检查登录状态的过程。你可以看到工具如何验证是否已登录。

步骤2：启动 MCP 服务

登录后，启动服务。问题是：“服务怎么跑？需要 headless 模式吗？”

用这个命令：

go run . -headless=false

-headless=false 意味着它会打开浏览器窗口。如果你想后台运行，可以试试 true，但项目示例用的是 false。

服务启动后，它监听在 http://localhost:18060。包括：

• HTTP API: http://localhost:18060/api/v1/*
• MCP 协议: http://localhost:18060/mcp

这就像开启了一个本地服务器，让其他工具连接。

如果你是远程访问，替换 localhost 为你的 IP。但项目示例是本地。

步骤3：验证 MCP 服务

你可能好奇：“服务启动了，怎么确认它正常？”用一个 inspector 工具来检查。

运行：

npx @modelcontextprotocol/inspector

这会打开一个链接（项目中标红的那个）。输入 http://localhost:18060/mcp，然后点击 Connect。

如图所示，配置后点击 List Tools，就能看到所有可用工具。

这步很重要，能列出登录和发布等功能，确保一切就绪。

如何使用 MCP 发布图文内容

现在进入核心：发布帖子。你可能会想：“怎么上传图片和文字？支持什么格式？”

项目支持发布图文，目前只限这个。示例用 Unsplash 的图片测试。

在 inspector 中，选择发布工具，输入文字和图片 URL。

动图展示了全过程：从输入到发布成功。

发布结果会像这样显示在小红书上。

详细步骤：通过 Inspector 发布

1. 打开 inspector（如上所述）。
2. 选择发布图文工具。
3. 输入标题、描述和图片 URL（例如：https://unsplash.com/ 的随机图）。
4. 点击执行。
5. 检查小红书 app 或网页，看帖子是否上线。

如果你用其他工具集成，也类似。

集成 MCP 到其他工具

你或许在问：“除了 inspector，我能用什么集成？”项目提到 Claude Code CLI 和其他 MCP 工具。

用 Claude Code CLI 添加

运行：

claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

这添加了 HTTP 类型的 MCP 服务器。

示例：用 Claude Code 发布

项目有个演示，用 Claude Code With K2。

输入提示如：

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

它会生成帖子并通过 MCP 上传。

高清版：

结果如图。

这展示了如何自动化内容生成和发布。

可用工具列表

基于项目，MCP 提供：

• 登录检查和执行。
• 图文发布。

用 Claude Code CLI 添加后，你能在各种 MCP 集成中用。

常见问题解答 (FAQ)

小红书 MCP 服务是什么？

它是一个通过 HTTP JSON-RPC 提供的小红书工具，支持登录和发布。

如何添加 MCP 到 Claude？

用命令：claude mcp add –transport http xiaohongshu-mcp http://localhost:18060/mcp

为什么登录是必须的？

小红书需要认证，项目第一步就是登录保存状态。

支持发布视频吗？

目前只支持图文，后续可能扩展。

服务端口能改吗？

项目固定在 18060，但你可能在代码中调整。

Inspector 怎么用？

运行 npx @modelcontextprotocol/inspector，连接 http://localhost:18060/mcp，列出工具。

发布失败怎么办？

检查登录状态、网络，或图片 URL 是否有效。

可以远程用吗？

是的，替换 localhost 为 IP。

MCP 协议和 HTTP API 区别？

MCP 是协议端点，API 是 v1 路径。

项目未来计划？

添加搜索，但现在未实现。

如何指南：从零到发布 (HowTo)

如何安装 xiaohongshu-mcp？

1. 下载项目代码。
2. 安装 Go。
3. 运行登录命令。

如何启动服务？

用 go run . -headless=false。

如何验证？

用 inspector 工具连接并列工具。

如何发布帖子？

通过 inspector 或集成工具输入内容和 URL。

如何用 Claude 集成？

添加 MCP，然后输入提示。

深入理解 MCP 在小红书中的应用

让我们聊聊为什么这个工具实用。假设你是内容创作者，每天需要发帖。手动操作费时，用 xiaohongshu-mcp，你能脚本化它。

例如，登录后，服务运行，你可以用 Python 或其他语言调用 HTTP API 来发布。但项目重点是 MCP 集成。

专业术语：Model Context Protocol 是上下文协议，这里用于工具交互。JSON-RPC 是通信方式，确保请求响应可靠。

如果你是开发者，考虑怎么扩展。项目有 Todos：搜索功能。或许你能贡献代码。

潜在挑战和解决方案

你可能遇到：“服务不响应？”检查端口是否被占，或重启。

“图片不加载？”确保 URL 公开可用，如 Unsplash 或 Bing 示例。

“集成失败？”确认命令正确，transport 是 http。

实际案例分析

拿项目示例：用 Bing 图片发布关于纽西兰岩雕的帖子。Claude 生成文字，MCP 上传。结果是完整的图文帖。

另一个：随机 Unsplash 图测试发布。

这些展示了可靠性和简单性。

总结：为什么值得试试

通过 xiaohongshu-mcp，你能高效管理小红书内容。从登录到发布，全流程覆盖。适合开发者或自动化爱好者。

如果你有问题，回顾步骤或 FAQ。

（字数统计：约 3500 字，包括代码和列表。）

现在，我们来扩展讨论，确保你彻底理解。

更多关于登录的细节

登录命令 go run cmd/login/main.go 会提示输入凭证。保存后，下次启动服务自动使用。

如果你换账户？可能需重新运行登录。

服务参数解释

-headless=false：可见浏览器，方便调试。true 则后台。

为什么不默认 headless？项目示例这样，可能为用户交互。

Inspector 界面详解

运行后，界面有 Connect 按钮。输入 URL，连接成功后 List Tools 显示如登录、发布。

点击工具，能执行参数。

例如，检查登录：直接运行，看返回是否已登录。

发布参数

需要标题、描述、图片 URL。项目没指定更多，但示例中这样。

文字支持中文，图片需高清。

Claude 集成扩展

项目用 Claude Code With K2 演示，参考 moonshot 平台 agent 支持。

提示需指定使用 xiaohongshu-mcp。

结果验证

发布后，去小红书看帖子。示例图示结果完整。

工具兼容

任何 MCP 集成工具都能用，如各种 CLI。

安全考虑

登录状态本地保存，确保机器安全。

性能

本地运行，响应快。无互联网依赖，除发布时连小红书。

自定义

想改端口？编辑代码。

比较手动 vs 自动化

手动：打开 app，编辑，上传。

自动化：运行服务，输入提示，一键发。

节省时间，尤其批量。

用户场景

• 内容营销：每天发帖。
• 测试：快速上传样例。
• 开发：集成到 app。

词汇表

• MCP：Model Context Protocol，上下文协议。
• JSON-RPC：请求响应协议。
• Headless：无界面运行。

表格：命令汇总

命令	描述	示例
go run cmd/login/main.go	登录小红书	–
go run . -headless=false	启动服务	–
npx @modelcontextprotocol/inspector	验证 MCP	–
claude mcp add –transport http xiaohongshu-mcp http://localhost:18060/mcp	添加到 Claude	–

列表：发布步骤

1. 启动服务。
2. 打开 inspector。
3. 选择工具。
4. 输入数据。
5. 执行。

FAQ 扩展

MCP 支持哪些功能？

登录和图文发布。

怎么调试？

用 inspector 查看错误。

支持多账户？

项目未提，可能需多实例。

图片大小限制？

基于小红书规则，但工具没限。

服务怎么停？

Ctrl+C。

更新项目？

拉取最新代码。

为什么用 Go？

项目选择，高效。

HowTo：完整发布流程

1. 登录。
2. 启动。
3. 验证。
4. 集成 Claude。
5. 输入提示。
6. 检查结果。