SRC-DEV-007：xiaohongshu-mcp——让 Claude Code 或其他 Agent 操作小红书

来源说明

这份资料汇总自 GitHub 仓库 xpzouying/xiaohongshu-mcp 的 README 与项目结构。仓库把登录、发布、搜索、读取笔记、查看互动数据、评论和收藏等能力封装为 MCP 工具，使 Claude Code、OpenClaw、n8n 等兼容客户端能够通过自然语言驱动这些操作。

作者在 README 中说明，项目来自自己长期使用的自动化程序，并在用 Claude Code 自动化运营数周后选择开源。该来源展示了一种具体的 Agent 工具开发路径：不是让模型直接“理解网页并乱点”，而是提供结构化、可测试、可复用的工具接口。

内容笔记

服务端主要使用 Go 实现。它通过浏览器登录保存会话，再向 MCP 客户端暴露发布和检索工具。用户可以提供标题、正文、标签和本地图片或视频路径，让 Agent 调用对应工具；也可以发起关键词搜索、读取笔记详情与互动数据。

README 给出三种运行方式：Docker 启动、源码本地运行，以及 MCP Inspector 测试。同时也列出在 Claude Code、OpenClaw、n8n 等不同客户端中接入服务地址的 JSON 配置示例。作者强调的工作流是：先确认服务与登录状态，再从 Inspector 或简单调用验证，最后才接入更复杂的 Agent 流程。

实际完成的结果

• 输入：自然语言任务描述、标题与正文、本地图片或视频文件、小红书登录状态、对应 MCP 客户端。
• 输出：自动发布的图文或视频笔记；关键词搜索结果；笔记详情与互动数据；评论和收藏等操作结果。
• 适用对象：希望开发第三方平台自动化工具、学习 MCP 工具封装模式，或在人工监督下减少重复运营操作的开发者。

操作过程与作者经验

1. 启动 MCP 服务并完成小红书登录（保存浏览器 Cookie）。
2. 使用 MCP Inspector 验证工具列表、参数说明与返回结果是否符合预期。
3. 在 Claude Code、OpenClaw、n8n 等客户端中配置 MCP 服务地址。
4. 从读取、搜索等低风险动作开始测试，再逐步验证草稿或正式发布流程。
5. 为本地媒体文件准备合法路径，并等待视频处理完成。
6. 监控 Cookie 是否过期、是否与其他网页端登录冲突、失败重试和平台限制。
7. 在正式发布前由人工检查事实准确性、版权、标题、标签和账号风险。

作者明确列出的限制

• 同一账号同时在多个网页端登录，可能使 MCP 会话失效。
• 视频必须使用本地绝对路径，处理相对较慢。
• 图片路径不宜包含中文字符。
• Cookie 过期后需要重新登录。
• 自动发布涉及平台规则、账号风控、垃圾内容、事实错误和凭证安全，必须由人工监督。

与现有 Wiki 的连接

• 强化 methods/method-mcp-external-tool-integration：本项目是该方法的一个完整中文开源实例。
• 强化 tools/Claude-Code：补充"通过 MCP 客户端操作第三方平台"这一典型用法。
• 注意区分：cases/书豪-小红书AI电商一人多店 是"小红书选品 + 1688 一件代发"业务场景，本项目是"Agent 操作小红书后台"，目的不同。

来源边界

"稳定运行一年多"与"Claude Code 自动化运营数周"属于作者自述，本资料未访问作者账号后台或运行日志。仓库功能与限制以 2026-07-13 可见的 README 为依据，不代表小红书官方授权，也不保证未来接口和风控规则保持不变。具备自动化能力并不等于可以绕过平台规则或实现无人监督批量发布。