Rednote Mac

v1.3.7

Control the RedNote (Xiaohongshu) Mac app via macOS Accessibility API. Fills the gap headless tools can't: read/reply to comments on video posts, send DMs, g...

1· 639· 13 versions· 0 current· 0 all-time· Updated 13h ago· MIT-0
byRunhui Huang@huangrh99

Install

openclaw skills install rednote-mac

rednote-mac

Control RedNote's Mac app directly — no browser, no API tokens. Uses macOS Accessibility API to drive the native App.

Headless tools (xiaohongshu-mcp) can't reach DMs, comment replies, or video comment lists — this skill can.

⚠️ Requires: Terminal → Accessibility permission + RedNote App visible on screen. No network access. No credentials stored.

Setup

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

Enable in System Settings → Privacy & Security → Accessibility → Terminal.

Navigate

xhs_navigate(tab="home")          # home / messages / profile
xhs_navigate_top(tab="discover")  # follow / discover / video
xhs_back()
xhs_search(keyword="AI paper")
xhs_screenshot()                  # always verify after navigation

Browse feed

xhs_scroll_feed(direction="down", times=5)
xhs_open_note(col=0, row=0)   # col: 0=left, 1=right  row: 0=first
xhs_screenshot()

Interact with a note

xhs_like()
xhs_collect()
xhs_follow_author()
xhs_get_note_url()   # returns xhslink.com short URL

Comments (video posts — fully reliable)

xhs_open_comments()
xhs_get_comments()
# → [{"index": 0, "author": "alice", "cx": 1450, "cy": 368}, ...]

xhs_post_comment(text="Great post!")
xhs_reply_to_comment(index=0, text="Thanks!")
xhs_delete_comment(index=0)   # ⚠️ irreversible — your comments only
xhs_scroll_comments(times=3)

Direct messages

xhs_open_dm(index=0)           # 0 = first conversation in list
xhs_send_dm(text="Hello!")
xhs_screenshot()               # confirm sent

Author stats

xhs_navigate(tab="profile")
xhs_get_author_stats()
# → {"following": "2", "followers": "29", "likes": "302", "bio": "..."}

Reference docs (load on demand)

Need to...Read
Navigate / search detailsdocs/ref-navigation.md
Feed & note openingdocs/ref-feed.md
Comment workflowsdocs/ref-note.md
DM detailsdocs/ref-dm.md
Profile & statsdocs/ref-profile.md
Limits & workaroundsdocs/ref-limits.md

Version tags

latestvk971qx3w8wte7arad69cpxecnh823aq0

Runtime requirements

OSmacOS
Binscliclick, python3