API Development stdio

XHS Downloader

Name: XHS Downloader
Author: JoeanAmier

Created by JoeanAmier

Extracts and downloads content from XiaoHongShu (RedNote), including user posts, collections, likes, albums, and search results, while removing watermarks.

How to Connect & Install

Select your client or environment below to copy the verified, ready-to-run installation configuration.

1-line autonomous agent setup instruction. Paste into Claude Code, Codex CLI, or Cursor Agent:

Fetch and configure Model Context Protocol (MCP) server XHS Downloader from https://www.fastmcp.dev/server/xhs-downloader

Agents automatically discover, install, and execute the server spec without manual token setup.

Connect via direct Stateless MCP v2 / Streamable HTTP endpoint or JSON-RPC:

https://github.com/joeanamier/xhs-downloader

Stateless edge endpoint compliant with MCP 2024-11-05 and v2 draft protocol specs.

Includes server instructions and tool definitions for Claude:

claude mcp add xhs-downloader -- npx -y xhs-downloader

Run in terminal to register server in current project or pass --scope user for global availability.

Configures server instructions and tools for OpenAI Codex & ChatGPT Desktop:

[mcp_servers.xhs_downloader]
command = "npx"
args = ["-y","xhs_downloader"]

Applies to ChatGPT Desktop app, Codex CLI, and IDE extension across your Codex host.

Add to Cursor project settings (.cursor/mcp.json) or Cursor Settings > Features > MCP:

{
  "mcpServers": {
    "xhs-downloader": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "xhs-downloader"
      ]
    }
  }
}

Commit to version control to allow teammates to connect immediately.

Install as an autonomous Agent Skill using the standard skills CLI:

npx skills add https://github.com/joeanamier/xhs-downloader

Standard agent skill installer compatible with Claude Code, Cursor, and agy harnesses.

Server Guidance & Instructions OpenAI & Claude Spec Compliant

XHS Downloader: Extracts and downloads content from XiaoHongShu (RedNote), including user posts, collections, likes, albums, and search results, while removing watermarks. Key capabilities: Collects detailed XiaoHongShu post information and persistent storage; Offers flexible deployment options via standalone executable, source code, or Docker; Downloads watermark-free XiaoHongShu images and videos.

Codex and Claude read this instruction prompt during initialization to orchestrate cross-tool workflows and rate limits.

Top Core Functions

01 Extract media from social posts

02 Remove watermarks from downloaded files

03 Gather metadata for saved content