From rednote-skills
Automates Xiaohongshu (Rednote) platform interactions with Playwright: search notes by keyword, extract markdown content, like/comment/collect/follow/publish. Useful for social media tasks on xiaohongshu.com.
npx claudepluginhub mrmao007/rednote-skills --plugin rednote-skillsThis skill uses the workspace's default tool permissions.
This skill allows you to fully interact with the Xiaohongshu (Little Red Book) platform. You can search for posts by keyword and return results, extract content from specific notes to structured markdown format, and perform engagement actions like liking, commenting, collecting, following users, and more.
Automates publishing long-form notes to Xiaohongshu web creator platform: opens publish page, inputs title/content, one-click formats, selects template, and submits. Triggers on 'post Xiaohongshu' phrases.
Control 16 social platforms (Twitter/X, YouTube, Reddit, Bilibili, etc.) via opencli CLI using natural language commands, reusing Chrome login sessions without API keys.
Generates AI-written Xiaohongshu-style content, renders Markdown to styled 1080x1440px images, automates publishing via Playwright RPA. For social media content workflows.
Share bugs, ideas, or general feedback.
This skill allows you to fully interact with the Xiaohongshu (Little Red Book) platform. You can search for posts by keyword and return results, extract content from specific notes to structured markdown format, and perform engagement actions like liking, commenting, collecting, following users, and more.
pip install playwright)playwright install)Before using this skill, the system will verify your login status:
python scripts/validate_cookies.py
If the output is True, you have normal access and can proceed with search operations.
If the output is False or the login button is visible, the system will automatically execute the manual login procedure:
python scripts/manual_login.py
The system will launch the login interface in a browser window. You'll need to follow the instructions in the opened browser to complete the login process manually, then close the browser after completion.
Before using this skill, ensure that:
The skill provides several search and extraction functions:
python scripts/search_note_by_key_word.py <KEYWORD> [--top_n TOP_N]python scripts/dump_note.py <NOTE_URL>The skill provides several interaction functions:
python scripts/like_note.py <NOTE_URL>python scripts/collect_note.py <NOTE_URL>python scripts/comment_note.py <NOTE_URL> <COMMENT_TEXT>python scripts/follow_user.py <NOTE_URL>python scripts/publish_note.py --image-urls <IMG1 [IMG2 ...]> --title <TITLE> --content <CONTENT> --tags <TAG1 [TAG2 ...]>python scripts/validate_cookies.pypython scripts/manual_login.pyThis skill provides the following functions for searching content on and interacting with the Xiaohongshu platform:
search_note_by_key_word.py)Purpose: Searches for Xiaohongshu notes using the provided keyword.
Parameters:
keyword (string): The keyword to search for--top_n (integer, optional): Number of return notes (default is 5)Returns: List of note URLs that match the keyword
Behavior: Launches browser, searches for the keyword on Xiaohongshu, returns matching note URLs.
dump_note.py)Purpose: Extracts specific note content and converts to formatted markdown.
Parameters:
note_url (string): The URL of the note to extract content fromReturns: Structured markdown content including author, title, media, description, tags, and interaction data
Behavior: Launches browser, accesses the note, extracts content and formats to markdown.
like_note.py)Purpose: Likes a specific note on Xiaohongshu using the note URL.
Parameters:
note_url (string): The URL of the note to likeReturns: Success or error message indicating if the like was successful
Behavior: Launches browser, navigates to the note URL, clicks the like button, then closes the browser.
collect_note.py)Purpose: Collects (saves) a specific note to the user's collection.
Parameters:
note_url (string): The URL of the note to collectReturns: Success or error message indicating if the collection was successful
Behavior: Launches browser, navigates to the note URL, clicks the collect button, then closes the browser.
comment_note.py)Purpose: Adds a comment to a specific note on Xiaohongshu.
Parameters:
note_url (string): The URL of the note to comment oncomment_text (string): The text content of the commentReturns: Success or error message indicating if the comment was published
Behavior: Launches browser, navigates to the note URL, fills in the comment text, clicks the send button, then closes the browser.
follow_user.py)Purpose: Follows the user who created a specific note by visiting a note URL.
Parameters:
note_url (string): The URL of a note by the user to followReturns: Success or error message indicating if the follow action was successful
Behavior: Launches browser, navigates to the note URL, clicks the follow button if available, then closes the browser.
validate_cookies.py)Purpose: Checks if the saved authentication tokens are valid and the user is logged in to Xiaohongshu.
Parameters: None
Returns: Boolean value indicating whether login is successful
Behavior: Launches browser, accesses Xiaohongshu homepage with stored credentials, checks for login state.
manual_login.py)Purpose: Assists in creating valid authentication cookies by opening the login interface.
Parameters: None
Returns: Success or error message after cookies are saved
Behavior: Launches browser, navigates to Xiaohongshu, allows user to log in manually, then saves cookies to storage file.
publish_note.py)Purpose: Publishes a new image-text note to the user's Xiaohongshu account with provided content, images, and tags.
Parameters:
--image-urls IMG1 [IMG2 ...]: Paths to one or more image files to upload with the note (required)--title TITLE: The title for the new note (required)--content CONTENT: The main content text for the new note (required)--tags TAG1 [TAG2 ...]: One or more tags to attach to the note (required)Returns: Success or error message indicating if the note was published successfully
Behavior: Launches browser, navigates to the Xiaohongshu publish page, fills in the note title, content, tags and uploads provided images, then clicks the publish button.
# Validate login status
python scripts/validate_cookies.py
# Search for notes about "旅行攻略"
python scripts/search_note_by_key_word.py "旅行攻略" --top_n 3
# Extract content from a specific note
python scripts/dump_note.py "https://www.xiaohongshu.com/explore/some-note-id"
# Like a specific note
python scripts/like_note.py "https://www.xiaohongshu.com/explore/some-note-id"
# Collect a specific note
python scripts/collect_note.py "https://www.xiaohongshu.com/explore/some-note-id"
# Add a comment to a specific note
python scripts/comment_note.py "https://www.xiaohongshu.com/explore/some-note-id" "Beautiful content! Thanks for sharing."
# Follow a user based on one of their posts
python scripts/follow_user.py "https://www.xiaohongshu.com/explore/some-note-by-user-id"
# Publish a new note with images, title, content, and tags
python scripts/publish_note.py \
--image-urls "/path/to/img1.jpg" "/path/to/img2.jpg" \
--title "My New Post" \
--content "Check out this amazing discovery!" \
--tags "travel" "food" "lifestyle"
# 1. Validate login
python scripts/validate_cookies.py
# 2. Search for interesting content
python scripts/search_note_by_key_word.py "美食推荐" --top_n 5
# 3. Extract detailed content from a note
python scripts/dump_note.py "https://www.xiaohongshu.com/explore/note1"
# 4. Like interesting content
python scripts/like_note.py "https://www.xiaohongshu.com/explore/note1"
# 5. Collect useful content
python scripts/collect_note.py "https://www.xiaohongshu.com/explore/note2"
# 6. Engage with community
python scripts/comment_note.py "https://www.xiaohongshu.com/explore/note3" "Awesome tutorial!"
# 7. Follow good content creators
python scripts/follow_user.py "https://www.xiaohongshu.com/explore/note-by-creator"
Validate Login First: Login status will be automatically checked using validate_cookies.py before performing any interactions to ensure smooth operations.
Rate Limiting: To avoid account restrictions, implement appropriate delays between consecutive interactions. Avoid excessive rapid interactions.
Error Handling: Check the return values from the functions to ensure operations were successful before proceeding to the next action.
User Intent: Only engage with content that matches user interest and preferences. The skill should complement user decisions.
Browser State Management: The scripts manage browser opening and closing, so ensure system resources are available for these operations.
Session Management: The skill maintains session state through cookies stored in rednote_cookies.json. Ensure this file is properly secured.
Browser Automation: The skill uses headless browsers for automation. Ensure the system has a compatible browser environment set up.
URL Format: The scripts expect properly formatted Xiaohongshu URLs. Ensure URLs are valid before passing to functions.
Content Appropriateness: Integrate this skill in a way that ensures interactions are appropriate and align with platform terms of service.
rednote_cookies.jsonBefore using the rednote skill, verify:
System Setup:
pip install playwright)playwright install)Xiaohongshu Access:
Security Setup:
❌ 未找到 cookies 文件，请先登录小红书并保存 cookies)Cause: The rednote_cookies.json file doesn't exist or is not in the correct location.
Solution: The system will automatically execute python scripts/manual_login.py to perform manual login and save cookies. The user just needs to complete the login process in the opened browser window.
❌ 未登录小红书，请先登录)Cause: Authentication tokens have expired or are invalid.
Solution: The system will re-verify login status and may execute python scripts/manual_login.py again to refresh tokens. The user just needs to complete the login process in the opened browser window if prompted.
Cause: Network connectivity issues or URL format errors. Solution: Verify URL format is correct, ensure internet connection is stable, and check if Xiaohongshu is accessible.
Cause: Xiaohongshu's UI might have changed or the page hasn't loaded completely. Solution: Retry the operation; if the issue persists, check for interface changes or wait before trying again.
rednote_cookies.json and should be secured