小红书视频下载 CLI

把小红书公开视频链接交给 Agent 处理。

Fastdown.pro 面向内容团队和自动化工作流,提供 fast-download CLI、MCP stdio server 和 Cloudflare API,用于解析用户提供的公开视频分享链接。

为什么用 CLI 和 MCP

当链接解析是工作流的一环,命令行和 Agent 工具比网页按钮更容易复用、记录和自动化。

结构化

返回 JSON

解析结果包含平台、标题、作者、媒体条目、封面、时长和额度信息。

本地保存

download_video

Agent 可以把媒体保存到 ~/Downloads/fast-download 或指定目录。

额度

可控成本

Free 每天 50 次成功解析,Pro 和 Max 面向高频素材整理工作流。

Agent 调用建议

把这些规则写入团队提示词或工具说明,Agent 会更稳定地选择正确工具。

  1. 1用户要求“下载”“保存”“获取本地文件”时,优先调用 download_video。
  2. 2用户要求“解析”“拿 URL”“看元数据”时,优先调用 parse_video。
  3. 3遇到 AUTH_REQUIRED,让用户运行 fast-download auth login。

What a parse returns

A parse is not a download button. It is structured output: every rendition, whether it carries a watermark, and how much quota is left.

$ fast-download parse "http://xhslink.com/xxxx/" --json | jq '{title, media: [.media[].quality]}'
{
  "title": "周末city walk路线",
  "media": ["1080p", "720p", "audio"]
}

Coverage and limits

Stated plainly, because a tool that hides its edges is a tool you cannot build on.

CapabilityStatusNotes
Xiaohongshu note linksSupportedxhslink.com short links and full URLs
Video notesSupportedNo-watermark MP4 plus audio track
Image notesPartialOriginal images returned, no PDF assembly
Logged-in-only notesNot supportedPublic visibility required
Comment and body textMetadata onlyTitle and author, not full note copy
Batch by profileNot supportedOne link per call, deliberately

Boundaries and compliance

Four constraints that make the tool safe to put inside an automated workflow.

Questions people actually ask

Can I download Xiaohongshu videos without a watermark?

Yes, for public notes. The CLI returns the source encode, which has no platform overlay, together with a separate audio track.

Does it work with xhslink.com short links?

Yes. Paste the short link or the whole share text; the parser extracts the URL and follows the redirect server-side.

Why does a note fail to parse?

The note is private, deleted, or region-restricted. Xiaohongshu also rate-limits aggressively, so a burst of parses from one account can be refused temporarily.

Is there a Xiaohongshu MCP server?

The same stdio server covers Xiaohongshu alongside the other six platforms — you do not install a per-platform server.

Three ways people actually run it

Pick the entry that matches where the link already lives.

  1. 1From an agent session — Paste the note link and say what you want — “save this one and tell me the resolution”. The agent calls download_video and reports the saved path.
  2. 2From a scheduled script — fast-download download "$URL" --json exits non-zero on failure, so cron or a GitHub Action can branch on the result without parsing log lines.
  3. 3From a note-taking pipeline — Parse instead of download: parse_video returns the media URL, so an Obsidian or Notion workflow can embed the clip without duplicating storage.