xhs-mac-mcp

# xhs-mac-mcp

通过 OpenClaw Plugin 调用，20 个 `xhs_*` tools 已注册，直接 call 即可。

## 安装

```bash
cd ~/.agents/skills/xhs-mac-mcp && bash install.sh
openclaw config set tools.allow '["xhs-mac"]'
openclaw gateway restart
```

⚠️ 系统设置 → 隐私与安全 → 辅助功能 → 开启 Terminal

## 按需读取的参考文件

| 需要做什么 | 读哪个文件 |
|-----------|-----------|
| 导航、截图、搜索 | `docs/ref-navigation.md` |
| 浏览 Feed、打开笔记 | `docs/ref-feed.md` |
| 点赞、收藏、评论、回复、删除 | `docs/ref-note.md` |
| 私信（发送/打开对话） | `docs/ref-dm.md` |
| 主页数据（关注/粉丝/bio） | `docs/ref-profile.md` |
| 图文帖限制 / 注意事项 | `docs/ref-limits.md` |

## 快速参考

```
xhs_screenshot          截图
xhs_navigate            切底部Tab (home/messages/profile)
xhs_navigate_top        切顶部Tab (follow/discover/video)
xhs_back                返回
xhs_search              搜索
xhs_scroll_feed         滚动Feed
xhs_open_note           打开笔记(col,row)
xhs_like / xhs_collect  点赞 / 收藏
xhs_get_note_url        获取分享链接
xhs_follow_author       关注作者
xhs_open_comments       打开评论区
xhs_scroll_comments     滚动评论
xhs_get_comments        获取评论列表
xhs_post_comment        发评论
xhs_reply_to_comment    回复评论(index,text)
xhs_delete_comment      删评论(index) ⚠️不可逆
xhs_open_dm             打开私信(index)
xhs_send_dm             发私信(text)
xhs_get_author_stats    读主页数据
```

# xhs-mac-mcp

通过 macOS Accessibility API 控制小红书（rednote）App 的 OpenClaw Plugin。

## 功能

补充 [xiaohongshu-mcp](https://github.com/...)（headless 版）无法实现的功能：

| 功能 | 说明 |
|------|------|
| 私信（send_dm） | headless 版无法做到 |
| 回复/删除评论 | 需要登录态 + App 交互 |
| 视频评论区完整读取 | AX API 可直接拿到评论列表 |
| 作者主页数据 | 关注/粉丝/获赞/bio |
| 搜索、点赞、收藏、关注 | 全部支持 |

## 前提条件

- Mac 安装了小红书（rednote）App
- Terminal 已获得辅助功能权限：**系统设置 → 隐私与安全 → 辅助功能** → 开启 Terminal
- 使用时 rednote App 必须在屏幕上**可见**（不能最小化/锁屏）
- 建议长时间任务时运行 `caffeinate -di &` 防止息屏

## 安装

```bash
# 1. 安装依赖
cd ~/.agents/skills/xhs-mac-mcp
uv sync   # 或 pip install atomacos pyobjc-framework-Quartz

# 2. 注册为 OpenClaw Plugin
ln -sf ~/.agents/skills/xhs-mac-mcp ~/.openclaw/extensions/xhs-mac

# 3. 允许 plugin 工具（加到 openclaw.json）
openclaw config set tools.allow '["xhs-mac"]'

# 4. 重启 Gateway
openclaw gateway restart
```

验证：
```bash
openclaw plugins list | grep xhs-mac
# 应显示 status: loaded
```

## 可用 Tools

| Tool | 说明 |
|------|------|
| `xhs_screenshot` | 截取当前界面截图 |
| `xhs_navigate` | 切换底部 Tab（home/messages/profile）|
| `xhs_navigate_top` | 切换顶部 Tab（follow/discover/video）|
| `xhs_back` | 返回上一页 |
| `xhs_search` | 搜索关键词 |
| `xhs_scroll_feed` | 滚动 Feed 流 |
| `xhs_open_note` | 打开 Feed 中的笔记 |
| `xhs_like` | 点赞 |
| `xhs_collect` | 收藏 |
| `xhs_get_note_url` | 获取笔记分享链接 |
| `xhs_follow_author` | 关注作者 |
| `xhs_open_comments` | 打开评论区 |
| `xhs_scroll_comments` | 滚动评论区 |
| `xhs_get_comments` | 获取评论列表 |
| `xhs_post_comment` | 发评论 |
| `xhs_reply_to_comment` | 回复评论 |
| `xhs_delete_comment` | 删除评论（只能删自己的）|
| `xhs_open_dm` | 打开私信对话 |
| `xhs_send_dm` | 发送私信 |
| `xhs_get_author_stats` | 读取主页数据 |

## 已知限制

- **图文帖评论**：小红书图文帖使用自绘渲染（Metal/Canvas），AX API 无法读...