Files
xiaohongshu-mcp/README.md
zy aa09687751 feat: 添加搜索功能 (#16)
- 新增 SearchFeeds 服务方法,支持关键词搜索小红书内容
- 添加 search_feeds MCP 工具,提供搜索接口
- 新增 /api/v1/feeds/search API 端点
- 实现搜索页面的浏览器自动化操作
- 优化 MCP 协议支持,处理 notifications/initialized 和 notifications/cancelled 通知
- 更新文档,添加搜索功能说明和使用示例
- 重构类型定义,优化数据结构

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>
2025-08-17 23:35:22 +08:00

2.9 KiB
Raw Blame History

xiaohongshu-mcp

MCP for xiaohongshu.com

功能:

  1. 登录。第一步必须,小红书需要进行登录。
  2. 发布图文。目前只支持发布图文,后续支持更多的发布功能。
  3. 获取推荐列表。
  4. 搜索内容。根据关键词搜索小红书内容。

1. 使用教程

1.1. 登录

第一次需要手动登录,需要保存小红书的登录状态。

运行

go run cmd/login/main.go

1.2. 启动 MCP 服务

启动 xiaohongshu-mcp 服务。


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

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

1.3. 验证 MCP

npx @modelcontextprotocol/inspector

运行 Inspector

运行后,打开红色标记的链接,配置 MCP inspector输入 http://localhost:18060/mcp ,点击 Connect 按钮。

配置 MCP inspector

按照上面配置 MCP inspector 后,点击 List Tools 按钮,查看所有的 Tools。

1.4. 使用 MCP 发布

检查登录状态

检查登录状态

发布图文

示例中是从 https://unsplash.com/ 中随机找了个图片做测试。

发布图文

搜索内容

使用搜索功能,根据关键词搜索小红书内容:

搜索内容

2. MCP 客户端接入

本服务支持标准的 Model Context Protocol (MCP),可以接入各种支持 MCP 的 AI 客户端。

📖 详细接入指南MCP_README.md

2.1. 快速开始

# 启动 MCP 服务
go run .

# 使用 Claude Code CLI 接入
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp

2.2. 支持的客户端

  • Claude Code CLI - 官方命令行工具
  • Claude Desktop - 桌面应用
  • Cursor - AI 代码编辑器
  • VSCode - 通过 MCP 扩展支持
  • MCP Inspector - 调试工具
  • 其他支持 HTTP MCP 的客户端

2.3. 可用 MCP 工具

  • check_login_status - 检查登录状态
  • publish_content - 发布图文内容
  • list_feeds - 获取推荐列表
  • search_feeds - 搜索小红书内容(前提:用户已登录)

2.4. 使用示例

使用 Claude Code 发布内容到小红书:

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

使用 xiaohongshu-mcp 进行发布。

claude-cli 进行发布

发布结果:

xiaohongshu-mcp 发布结果

Star History

Star History Chart