Integrate XHS Downloader
Use only for content the user owns or is explicitly allowed to download. Treat the GPL-3.0 file and additional README restrictions as a license-clarification requirement for distribution or commercial use.
Workflow
- Read references/integration.md before installation, download, API, MCP, Docker, or Cookie use.
- Record the authorization basis for every target URL and the allowed output purpose.
- Resolve and verify remote, pinned commit, license files, README restrictions, and worktree.
- Choose one mode: static inspection, local TUI/CLI, one authorized download, loopback API, loopback MCP, or Docker evaluation.
- Preview dependency, server, port, volume, download, and persistent database effects.
- Default services to
127.0.0.1; never expose 0.0.0.0 without explicit network-scope approval and access controls.
- Keep Cookie optional. Never collect it automatically or print it; prefer unauthenticated access when sufficient.
- Run one bounded request/download, verify destination and count, then stop.
Hard Stops
- Refuse copyrighted media without permission, bulk account/keyword collection, automated scrolling, private data, or risk-control evasion.
- Do not enable clipboard monitoring, background servers, browser userscripts, proxies, or persistent containers implicitly.
- Do not redistribute builds or derivative packages until the GPL/additional-term conflict is reviewed.
Agent Output
Return authorization, repository pin, mode, exact input count, commands, bound address/port, artifacts, persistent state, and license limitations.
1---2name: integrate-xhs-downloader3description: Audit, install, configure, or invoke the pinned JoeanAmier/XHS-Downloader repository for authorized Xiaohongshu/RedNote link extraction, owned-media download, local API, or local MCP evaluation. Use only when the user explicitly names XHS-Downloader or supplies Xiaohongshu content they own or have permission to download. Do not trigger for generic Xiaohongshu research, competitor scraping, or unauthorized media acquisition.4---5
6# Integrate XHS Downloader
7
8Use only for content the user owns or is explicitly allowed to download. Treat the GPL-3.0 file and additional README restrictions as a license-clarification requirement for distribution or commercial use.
9
10## Workflow
11
121. Read [references/integration.md](references/integration.md) before installation, download, API, MCP, Docker, or Cookie use.
132. Record the authorization basis for every target URL and the allowed output purpose.
143. Resolve and verify remote, pinned commit, license files, README restrictions, and worktree.
154. Choose one mode: static inspection, local TUI/CLI, one authorized download, loopback API, loopback MCP, or Docker evaluation.
165. Preview dependency, server, port, volume, download, and persistent database effects.
176. Default services to `127.0.0.1`; never expose `0.0.0.0` without explicit network-scope approval and access controls.
187. Keep Cookie optional. Never collect it automatically or print it; prefer unauthenticated access when sufficient.
198. Run one bounded request/download, verify destination and count, then stop.
20
21## Hard Stops
22
23- Refuse copyrighted media without permission, bulk account/keyword collection, automated scrolling, private data, or risk-control evasion.
24- Do not enable clipboard monitoring, background servers, browser userscripts, proxies, or persistent containers implicitly.
25- Do not redistribute builds or derivative packages until the GPL/additional-term conflict is reviewed.
26
27## Agent Output
28
29Return authorization, repository pin, mode, exact input count, commands, bound address/port, artifacts, persistent state, and license limitations.
30