spike-faye-lei Xiaohongshu (小红书)
Overview
Chinese social media / lifestyle platform — Instagram + Pinterest hybrid. Archetype: Social Media.
Workflows
Search and read notes
searchNotes(keyword)→noteId,xsecToken,user.userIdgetNoteDetail(noteId, xsecToken)→title,desc,interactInfo,tagList, top commentsgetNoteComments(noteId, xsecToken)→comments[],hasMore,cursor
Explore trending content
getHotSearch()→keyword,score,ranksearchNotes(keyword)→noteId,xsecTokengetNoteDetail(noteId, xsecToken)→ full note detail
Browse explore feed
getExploreFeed()→noteId,xsecToken,displayTitlegetNoteDetail(noteId, xsecToken)→ full note detail →user.userIdgetRelatedNotes(noteId, xsecToken)→ similar/recommendednoteIdlist
Research a user
searchNotes(keyword)→user.userIdfrom resultsgetUserProfile(userId)→nickname,desc, follower counts, location tagsgetUserNotes(userId)→ posted notes →noteIdgetUserCollections(userId)→ bookmarked notes (if public)getUserLiked(userId)→ liked notes (if public)
Interact with content (requires login)
searchNotes(keyword)→noteId,xsecToken,user.userIdlikeNote(noteId, xsecToken)→ like it (idempotent)bookmarkNote(noteId, xsecToken)→ bookmark it (idempotent)commentNote(noteId, content, xsecToken)→commentIdfollowUser(userId ← searchNotes user.userId)→ follow the author (idempotent)
Operations
| Operation | Intent | Key Input | Key Output | Notes |
|---|---|---|---|---|
| searchNotes | search posts by keyword | keyword | noteId, xsecToken, user.userId, displayTitle, likedCount | entry point |
| getNoteDetail | get full note + comments | noteId ← searchNotes, xsecToken ← searchNotes | title, desc, interactInfo, tagList, user.userId, comments | includes top 20 comments |
| getNoteComments | get comments for a note | noteId ← searchNotes, xsecToken ← searchNotes | comments[], hasMore, cursor | paginated, dedicated comment fetch |
| getUserProfile | get user profile | userId ← searchNotes user.userId / getNoteDetail user.userId | nickname, desc, gender, interactions, tags | CAPTCHA risk under rapid access |
| getUserNotes | user's posted notes | userId ← searchNotes user.userId / getNoteDetail user.userId | notes[].noteId, displayTitle, likedCount | first page from SSR |
| getUserCollections | user's bookmarked notes | userId ← searchNotes user.userId / getNoteDetail user.userId | notes[].noteId, displayTitle, likedCount | empty if private |
| getUserLiked | user's liked notes | userId ← searchNotes user.userId / getNoteDetail user.userId | notes[].noteId, displayTitle, likedCount | empty if private |
| getExploreFeed | trending/recommended feed | — | noteId, xsecToken, displayTitle, likedCount | entry point, ~70 notes |
| getHotSearch | trending search terms | — | keyword, score, rank | entry point |
| getRelatedNotes | related notes for a note | noteId ← searchNotes, xsecToken ← searchNotes | notes[].noteId, displayTitle, likedCount | from recommend API or SSR |
| likeNote | like a note | noteId ← searchNotes/getExploreFeed, xsecToken ← searchNotes/getExploreFeed | liked, action | SAFE: idempotent, requires login |
| bookmarkNote | bookmark a note | noteId ← searchNotes/getExploreFeed, xsecToken ← searchNotes/getExploreFeed | bookmarked, action | SAFE: idempotent, requires login |
| followUser | follow a user | userId ← searchNotes user.userId / getNoteDetail user.userId | followed, action | SAFE: idempotent, requires login |
| commentNote | comment on a note | noteId ← searchNotes/getExploreFeed, content, xsecToken ← searchNotes/getExploreFeed | commentId, action | CAUTION: creates content, requires login |
Quick Start
# Search for coffee-related notes
openweb xiaohongshu exec searchNotes '{"keyword": "咖啡"}'
# Get full note detail with comments
openweb xiaohongshu exec getNoteDetail '{"noteId": "6912d7eb000000000402a319"}'
# Get comments for a note
openweb xiaohongshu exec getNoteComments '{"noteId": "6912d7eb000000000402a319"}'
# Get trending search terms
openweb xiaohongshu exec getHotSearch '{}'
# Browse explore feed
openweb xiaohongshu exec getExploreFeed '{}'
# Get user profile
openweb xiaohongshu exec getUserProfile '{"userId": "661358f70000000003030d89"}'
# Get user's posted notes
openweb xiaohongshu exec getUserNotes '{"userId": "661358f70000000003030d89"}'
# Get user's bookmarked notes
openweb xiaohongshu exec getUserCollections '{"userId": "661358f70000000003030d89"}'
# Get related notes for a note
openweb xiaohongshu exec getRelatedNotes '{"noteId": "6912d7eb000000000402a319"}'
# Like a note (requires login)
openweb xiaohongshu exec likeNote '{"noteId": "6912d7eb000000000402a319"}'