xhs-search

小红书内容搜索技能。使用已登录的小红书账号，通过 MCP 服务搜索和提取小红书内容。

前置条件

1. 安装 xiaohongshu-mcp

bash

下载 macOS amd64 版本（其他系统替换文件名）

curl -L -o ~/Downloads/xhs-mcp.tar.gz \
https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-amd64.tar.gz

cd ~/Downloads && tar -xzf xhs-mcp.tar.gz
mkdir -p ~/.local/bin
mv xiaohongshu-login xiaohongshu-mcp ~/.local/bin/
chmod +x ~/.local/bin/xiaohongshu-*

2. 扫码登录（一次性）

在 Mac/有显示器的 Linux 上运行：

bash
~/.local/bin/xiaohongshu-login -bin /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

• - 弹出浏览器窗口 → 小红书 App 扫码授权
• 登录状态保存在本地 Cookie 文件中，长期有效

3. 启动 MCP 服务

bash
~/.local/bin/xiaohongshu-mcp -bin /Applications/Google Chrome.app/Contents/MacOS/Google Chrome -port :18060

服务常驻后台，开机自动启动（可加入 launchd/systemd）。

---

使用方法

基本搜索

用户提供关键词 → 调用 MCP search_feeds → 返回结果

可用工具（MCP tools）

工具名	用途
checkloginstatus	检查登录状态
search_feeds

关键词搜索笔记 | | list_feeds | 获取首页推荐 | | getfeeddetail | 获取帖子详情（需 feedid + xsectoken）| | userprofile | 获取用户主页（需 userid）| | like_feed | 点赞/取消点赞 | | favorite_feed | 收藏/取消收藏 | | publish_content | 发布图文笔记 |

---

Python 调用示例

python
import urllib.request, json

MCP_URL = http://localhost:18060/mcp

def mcp_init():
payload = json.dumps({jsonrpc:2.0,id:1,method:initialize,
params:{protocolVersion:2024-11-05,capabilities:{},
clientInfo:{name:agent,version:1.0}}}).encode()
req = urllib.request.Request(MCP_URL, data=payload,
headers={Content-Type:application/json,Accept:application/json, text/event-stream})
sid = urllib.request.urlopen(req, timeout=30).headers.get(Mcp-Session-Id,)

# 发送 initialized 通知
notif = json.dumps({jsonrpc:2.0,method:notifications/initialized,params:{}}).encode()
nr = urllib.request.Request(MCP_URL, data=notif,
headers={Content-Type:application/json,Accept:application/json, text/event-stream,Mcp-Session-Id:sid})
urllib.request.urlopen(nr, timeout=10)
return sid

def mcp_call(tool, args, sid):
payload = json.dumps({jsonrpc:2.0,id:2,method:tools/call,
params:{name:tool,arguments:args}}).encode()
req = urllib.request.Request(MCP_URL, data=payload,
headers={Content-Type:application/json,Accept:application/json, text/event-stream,Mcp-Session-Id:sid})
resp = urllib.request.urlopen(req, timeout=60)
return json.loads(resp.read().decode())

使用

sid = mcp_init() r = mcpcall(searchfeeds, {keyword:关键词,filters:{sort_by:最新}}, sid) feeds = json.loads(r[result][content][0][text])[feeds]

---

搜索结果字段说明

每个笔记包含：

字段	说明
id	笔记ID（用于获取详情）
noteCard.displayTitle

标题 |
| noteCard.user.nickName | 作者昵称 |
| noteCard.interactInfo.likedCount | 点赞数 |
| noteCard.interactInfo.collectedCount | 收藏数 |
| noteCard.interactInfo.commentCount | 评论数 |
| xsecToken | 访问令牌（获取详情时需要）|

---

注意事项

• - 排序选项仅支持 最新（其他值会返回错误）
• 部分笔记详情因隐私设置可能不可访问
• 搜索结果每次最多约44条
• Cookie 过期后重新运行登录工具扫码即可

免责声明

1. 1. 仅供个人研究学习使用，不得用于商业数据采集、批量内容抓取，或任何违反小红书平台服务条款的活动。
2. 本技能依赖第三方开源工具 xiaohongshu-mcp，该工具的版权归原作者所有。
3. 用户使用本技能产生的任何行为及后果，由用户自行承担。
4. 本技能发布者与小红书平台无任何关联。