Xiaohongshu Video Finder

v1.0.1

Find fresh, viral Xiaohongshu videos by niche with filters for type, date, and popularity, and extract URLs with valid xsec_token for repurposing.

0· 500·1 current·1 all-time
byTravis Li@travislius
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
medium confidence
Purpose & Capability
Name/description match the instructions: the skill uses a managed browser to search Xiaohongshu, apply filters, pick videos, and extract URLs containing xsec_token. It does not request unrelated binaries, env vars, or installs.
Instruction Scope
SKILL.md explicitly instructs the managed browser to log in (QR scan), search, apply filters, open videos, and copy full URLs including the xsec_token. This is within the stated purpose but involves extracting session/token data from a logged-in session and copying links to the clipboard — actions that are sensitive and should be limited to intended workflows.
Install Mechanism
Instruction-only skill with no install spec and no code files — lowest-risk install surface. Nothing is downloaded or written to disk by the skill package itself.
Credentials
No environment variables, credentials, or config paths are requested. The instructions do rely on an authenticated managed browser session, which is necessary for the described functionality.
Persistence & Privilege
always:false and no install means the skill does not request elevated persistence. However, because it expects to operate in a logged-in managed browser, allowing autonomous invocation could let the agent use that session to perform actions or extract tokens; consider limiting autonomous runs or ensuring the managed browser session is appropriately scoped.
Assessment
This skill appears to do what it says: automate a logged-in browser to find Xiaohongshu videos and grab URLs that include xsec_token. Before installing, confirm you trust the skill source (no homepage provided), avoid long-lived/multi-purpose logins in the managed browser while the skill is enabled, and consider disabling autonomous invocation or testing in a sandbox. Be aware that xsec_token values are session-linked and can enable downstream download tools — only extract/share them if you have the right to repurpose the content and it complies with service terms and copyright.

Like a lobster shell, security has layers — review code before you run it.

latestvk9798hcyhawfv3whh7jabxhayh81ymwm

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

SKILL.md

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)SettingMeaning
排序依据最新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

ProblemFix
JSON parse error in creator toolToken expired — get a fresh URL from Xiaohongshu
Filter not visibleScroll up to the top of search results
No videos shownCheck filter — make sure 笔记类型 = 视频, not 图文
Video won't loadTry a different video; some have regional restrictions
Search results are emptyTry 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

Files

2 total
Select a file
Select a file to preview.

Comments

Loading comments…