skills.rest
browser-act
browser-actOFFICIAL
Explore all skills by this author →
Website𝕏@browseractGitHub

xiaohongshu-search-full

Extract Xiaohongshu search results with full note metadata, filters, and engagement stats.

5.5k|269|Updated Feb 6, 2026
Search Tags:#social listening#Browser Automation#rednote#XiaoHongShu#Web scraping#engagement stats#search extraction
One-click install
npx skills add https://github.com/browser-act/skills --skill xiaohongshu-search-full
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xiaohongshu-search-full
Source: https://github.com/browser-act/skills/tree/main/solutions/social-listening/xiaohongshu-search-full
Command: npx skills add https://github.com/browser-act/skills --skill xiaohongshu-search-full

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually collecting Xiaohongshu (RedNote) search results with complete fields—body text, topics, image URLs, video stream URLs, exact publish timestamps, and engagement stats—requires opening every note one by one, which is slow and error-prone at scale.

Core Features & Use Cases

  • Full-field search extraction: Reads the rendered search feed from the page's Vue state to capture titles, covers, authors, and all engagement counts, then enriches each note via its detail page for body text, hashtags, image lists, video URLs, and exact timestamps.
  • Complete filter support: Applies every page filter option—sort order, note type (video/image-text), publish time range, search scope, and location distance—using verified platform-internal API values.
  • Title + body keyword matching: Performs fuzzy keyword matching (Levenshtein-based) across both titles and body text so exact-match notes are not lost to the search API's semantic expansion.
  • Use Case: A brand analyst searches "AI tools" on Xiaohongshu, filters to video notes from the past week sorted by most liked, and exports every matching note's full content and stats for a competitive monitoring report.

Quick Start

Search Xiaohongshu for the keyword "AI tools", filter to video notes published within one week, and extract full note details including body text, tags, and engagement stats.

Frequently Asked Questions about xiaohongshu-search-full

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Xiaohongshu notes by keyword and extract full data?▼

Navigate to the Xiaohongshu search results page with your keyword, then run the extract-search-feeds script to read all rendered notes from the page state. For body text, tags, and video URLs, visit each note's detail page and run the extract-note-detail script.

How to filter Xiaohongshu search results by date or note type?▼

Open the filter panel on the search page and select options for sort order, note type (video or image-text), publish time range, search scope, or location distance. The skill uses verified platform-internal Chinese API values that must be sent exactly as shown.

Does Xiaohongshu search scraping require login?▼

Yes, both search and detail extraction require a logged-in Xiaohongshu session. Without login the page shows a QR code overlay and returns no data; the skill verifies login status before executing and can hand off to the user for QR scanning.

Why do some exact-match notes missing from Xiaohongshu search API results?▼

The Xiaohongshu search API applies semantic expansion, which can omit or deprioritize exact-match notes for niche keywords. The skill's DOM-based extraction reads the rendered page state directly, which mirrors what users actually see and avoids this limitation.

What are the limitations of extracting Xiaohongshu note data?▼

Video stream URLs contain time-limited signed tokens that expire, body text and topics are only available from detail pages, and location-distance filters require browser location permission. Detail requests should be spaced 2-3 seconds apart to avoid anti-scraping triggers.

Related Skills

Explore More Marketing & Sales Skills→
AcosmiAcosmi
6

platform-login

Automate Xiaohongshu login by capturing QR codes and polling for user confirmation.

Community
Intermediate
orthogonal-shorthogonal-sh
12

social-listening

Aggregate real-time social mentions of brands and topics across platforms.

Official
Intermediate
codingSamsscodingSamss
11

xiaohongshu-session-reader

Extract Xiaohongshu profiles, notes, and comments via HTTP requests with Playwright fallback.

Community
Intermediate
PsychQuantPsychQuant

mcp-publish

Automates MCP Server project publishing and updating to registries.

Official
Advanced