Skill: travislius/xhs-video-finder (version 1.0.1)

# xhs-video-finder Find fresh, viral videos on Xiaohongshu (小红书 / RedNote) for repurposing to YouTube Shorts or other platforms. Uses browser automation to search, filter by type and publish date, and extract video URLs. ## When to Use - You need a fresh Xiaohongshu video to repurpose (e.g., for a YouTube Shorts cron) - You want to find trending content by niche (food, travel, crafts, etc.) - You need a URL with a valid `xsec_token` for downstream tools (creator.octodance.com, etc.) ## Step-by-Step Workflow ### 1. Open Xiaohongshu in the Managed Browser ``` browser action=open profile=openclaw url=https://www.xiaohongshu.com ``` Wait for the page to fully load. ### 2. Search for Content Use the search bar with a niche keyword. Examples by channel: - **Chinese food:** `中国美食` `家常菜` `街头小吃` `火锅` - **Travel:** `旅行` `旅游攻略` `小众景点` `城市打卡` - **Crafting/DIY:** `手工DIY` `手工制作` `手工教程` - **Curiosities:** `冷知识` `涨知识` `神奇` `你不知道的` Take a snapshot, find the search input, and type your keyword. ### 3. Apply Filters (Top-Right Corner) After search results load, tap the **filter icon** (top-right — shows "已筛选" when active). Set these options in the filter panel: | Filter (Chinese) | Setting | Meaning | |-----------------|---------|---------| | 排序依据 | **最新** | Sort: Newest first | | 笔记类型 | **视频** | Type: Videos only | | 发布时间 | **一周内** | Posted: Within 1 week | | 搜索范围 | 不限 | Scope: All | Tap **收起** to close the filter panel. ### 4. Browse Results & Pick a Video Look for: - ✅ **1,000+ likes** (❤️ count shown under each card) - ✅ **Under 6 minutes** (check duration indicator on the thumbnail) - ✅ **Clear, engaging visuals** - ✅ **No heavy watermarks** blocking the subject - ❌ Skip static image posts (图文) — filter should exclude these already Post timestamps are shown as relative time: `2小时前` = 2 hours ago, `1天前` = 1 day ago. ### 5. Open the Video & Get the URL Click a video card to open it. Copy the full URL from the address bar: ``` https://www.xiaohongshu.com/explore/VIDEO_ID?xsec_token=ABxxxxxx&xsec_source=pc_search ``` **⚠️ Always include the full URL with `xsec_token`** — this token is required for video download tools. Tokens expire, so get a fresh URL each time. ### 6. Alternative: Use the Share Link If you prefer a cleaner URL: 1. Click the **Share** button (分享) inside the video — bottom right 2. The share link is **auto-copied to clipboard** 3. Format: `https://www.xiaohongshu.com/discovery/item/VIDEO_ID?source=webshare&xhsshare=...` Both formats work with creator.octodance.com / lazyai.octodance.com. ## Troubleshooting | Problem | Fix | |---------|-----| | JSON parse error in creator tool | Token expired — get a fresh URL from Xiaohongshu | | Filter not visible | Scroll up to the top of search results | | No videos shown | Check filter — make sure 笔记类型 = 视频, not 图文 | | Video won't load | Try a different video; some have regional restrictions | | Search results are empty | Try a broader keyword or remove time filter | ## ⚠️ Login Required Xiaohongshu **requires login to view search results** in the browser. Before using this skill, make sure the managed browser is logged into XHS: 1. Open `https://www.xiaohongshu.com` in the managed browser 2. If a login modal appears, scan the QR code with the XHS mobile app (WeChat scan also works) 3. Once logged in, the session persists — you won't need to log in again unless it expires **If you can't log in via the managed browser:** Use the XHS mobile app to find a video manually, copy the share link, and paste it directly into the creator tool. ## Notes - `explore/` URLs and `discovery/item/` URLs both work — use whichever the browser gives you - The filter state persists across searches in the same session, so you only need to set it once - Login sessions may expire periodically — if search results are blocked, re-scan the QR code

path: _meta.json
content: ownerId: kn7e0hw5gdmrgx4v68927xskax81ywag
slug: xhs-video-finder
version: 1.0.0
publishedAt: 1772208078116

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)