Agent skill

Xiaohongshu MCP

by tsingyuai in tsingyuai/growth-lab

使用本机 browser-first xiaohongshu-mcp 只读搜索小红书、下载候选首图、补全用户选择的笔记详情,并把脱敏证据写入调用方 Memory。用于 xhs-replicate 的选题和视觉参考研究,取代小红书 MediaCrawler 路径。

Apache-2.0Auto-check passedAgent Workflows

Install Xiaohongshu MCP

skills CLI
$ npx skills add tsingyuai/growth-lab --skill xiaohongshu-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tsingyuai/growth-lab xiaohongshu-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tsingyuai/growth-lab.git skills-src && mkdir -p .claude/skills && cp -r skills-src/collectors/xiaohongshu-mcp .claude/skills/xiaohongshu-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
xiaohongshu-mcp
GitHub stars
2k
Token cost
~822 tokens
SKILL.md length
362 words
Files
12 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
Apache-2.0

At a glance

使用本机 browser-first xiaohongshu-mcp 只读搜索小红书、下载候选首图、补全用户选择的笔记详情,并把脱敏证据写入调用方 Memory。用于 xhs-replicate 的选题和视觉参考研究,取代小红书 MediaCrawler 路径。

  • Works in 6 steps: Persist the 20-30 item search response… → Download all covers from the first batch… → Score promotional layout quality before… → …
  • Tasks that involve MCP servers
  • SKILL.md covers First-run conversation, Runtime, Visual selection and Data boundary, plus 1 more section
  • Runs Python and PowerShell scripts from its folder; calls python

What it does

Xiaohongshu MCP is an agent skill from tsingyuai/growth-lab. 使用本机 browser-first xiaohongshu-mcp 只读搜索小红书、下载候选首图、补全用户选择的笔记详情,并把脱敏证据写入调用方 Memory。用于 xhs-replicate 的选题和视觉参考研究,取代小红书 MediaCrawler 路径。

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/cover-screening.md` and `references/runtime.md`).

It sits in Agent Workflows, covering MCP servers. It works with Xiaohongshu and Model Context Protocol. The repository describes itself as: An end-to-end growth tool that understands the product, fetch the data it needs, researches the market, executes campaigns, and reviews results to improve the next round of… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/xiaohongshu-mcp”

Requirements

  • Python 3
  • PowerShell

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Persist the 20-30 item search response immediately as one batch. Do not wait for page-wide stability after the response is complete.
  2. Download all covers from the first batch and inspect every contact sheet.
  3. Score promotional layout quality before engagement. Fetch full details only for 3-8 passing candidates.
  4. Show every passing candidate with its actual representative image, title, score, and risk. If inline image rendering is unavailable or…
  5. If the user rejects all candidates, record the reasons and run a new product/workflow-oriented query. Do not force the best item from a…
  6. Select exactly one external visual learning sample. Write and validate visual-reference-selection.json

What it can do on your machine

Read from SKILL.md and the folder at commit 2d0807c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 8 files in scripts/ (Python and PowerShell), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xiaohongshu MCP loads about 822 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 37 tokens; SKILL.md has 362 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~822
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from tsingyuai/growth-lab at commit 2d0807c, republished under its Apache-2.0 licence (© tsingyuai). 362 words, ~822 tokens.

Download SKILL.mdSave it as .claude/skills/xiaohongshu-mcp/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
xiaohongshu-mcp
description
使用本机 browser-first xiaohongshu-mcp 只读搜索小红书、下载候选首图、补全用户选择的笔记详情,并把脱敏证据写入调用方 Memory。用于 xhs-replicate 的选题和视觉参考研究,取代小红书 MediaCrawler 路径。

Xiaohongshu browser-first collection

Read runtime.md before startup and cover-screening.md before visual selection.

First-run conversation

Before collection, tell the user:

  • the recommended first-run batch is 25 notes;
  • the count is adjustable, but 25 is recommended;
  • collection is read-only and saves sanitized research evidence and requested images locally;
  • login does not authorize likes, saves, comments, follows, uploads, or publication.

If required settings are missing, stop and invoke onboard-growth-lab. Give the user the exact configuration file and fields from CONFIGURATION.md; never ask them to paste a key, cookie, or signed URL into the conversation.

Runtime

powershell
powershell -ExecutionPolicy Bypass -File collectors/xiaohongshu-mcp/scripts/start_xiaohongshu_service.ps1
python collectors/xiaohongshu-mcp/scripts/collect_xiaohongshu.py "<topic>" `
  --limit 25 --cover-pool 25 `
  --out "memory/xhs-replicate/<run>/xiaohongshu-search.json"

The service must be local HTTP only. If it is not logged in, explain the boundary, ask before opening the visible login window, run login_xiaohongshu.ps1, verify once, and resume. Stop on timeout, risk-control, login loss, or repeated empty responses; do not loop around platform controls.

Visual selection

  1. Persist the 20-30 item search response immediately as one batch. Do not wait for page-wide stability after the response is complete.
  2. Download all covers from the first batch and inspect every contact sheet.
  3. Score promotional layout quality before engagement. Fetch full details only for 3-8 passing candidates.
  4. Show every passing candidate with its actual representative image, title, score, and risk. If inline image rendering is unavailable or cannot be confirmed, include the clean public note URL in the same response.
  5. If the user rejects all candidates, record the reasons and run a new product/workflow-oriented query. Do not force the best item from a weak batch.
  6. Select exactly one external visual learning sample. Write and validate visual-reference-selection.json:
Show full SKILL.md (101 more words)Show less
powershell
python collectors/xiaohongshu-mcp/scripts/validate_visual_reference_selection.py `
  --selection <run>/visual-reference-selection.json `
  --candidates <run>/visual-candidates.json

Use the selected reference for analysis only. Do not copy its wording, logo, proprietary UI, exact composition, or visual identity.

Data boundary

Write search evidence, candidate images, selection, and detail summaries only under the calling Model's ignored memory/xhs-replicate/ run directory. Persist clean note IDs and public URLs, never xsec tokens, cookies, signed media URLs, avatars, or raw response fields containing credentials.

Handoff

Return the query, batch size, collection time, access limits, candidates, visible engagement, selection status, clean public URLs, missing evidence, and one recommended next action. The user must be able to see the candidate image or public source before choosing.

© tsingyuai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references) in collectors/xiaohongshu-mcp of tsingyuai/growth-lab.

  • SKILL.md
  • agents/openai.yaml
  • references/cover-screening.md
  • references/runtime.md
  • scripts/collect_selected_xiaohongshu_note.py
  • scripts/collect_xiaohongshu.py
  • scripts/login_xiaohongshu.ps1
  • scripts/start_xiaohongshu_service.ps1
  • scripts/test_collect_xiaohongshu.py
  • scripts/test_minimal_continuous_flow.py
  • scripts/test_validate_visual_reference_selection.py
  • scripts/validate_visual_reference_selection.py

Open the folder on GitHubat commit 2d0807c

Compare with similar skills

Xiaohongshu MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xiaohongshu MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xiaohongshu MCP this skilltsingyuai/growth-lab2k—~822Automated safety check: PassApache-2.0
Sandbasesandbaseai/cli188—~3.1kAutomated safety check: PassApache-2.0
Setup Xhs MCPautoclaw-cc/xiaohongshu-mcp-skills272—~678Automated safety check: PassMIT
Linkdigest Social Link Readersickn33/agentic-awesome-skills47k—~3.4kAutomated safety check: PassMIT
Xiaohongshu MCPLeoYeAI/openclaw-master-skills2.2k—~957Automated safety check: PassMIT
Xiaohongshu Content Researchjumodada/Drissionpage-MCP-Server487—~768Automated safety check: PassCustom licence

Similar skills

  • Sandbase

    sandbaseai/cli

    Discover better ways to complete tasks. An agent skill from sandbaseai/cli.

    188 GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Setup Xhs MCP

    autoclaw-cc/xiaohongshu-mcp-skills

    安装部署 xiaohongshu-mcp 服务并配置 MCP 连接,引导用户完成从零到可用的全流程. An agent skill from autoclaw-cc/xiaohongshu-mcp-skills.

    272 GitHub stars~678 tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed
  • Linkdigest Social Link Reader

    sickn33/agentic-awesome-skills

    Read one public Xiaohongshu, Douyin, TikTok, YouTube, X or WeChat article link into text an agent can use (transcript, image text, key points) via the LinkDigest API or MCP server.

    47k GitHub stars~3.4k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Xiaohongshu MCP

    LeoYeAI/openclaw-master-skills

    Automate Xiaohongshu (RedNote) content operations using a Python client for the xiaohongshu-mcp server.

    2.2k GitHub stars~957 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Xiaohongshu Content Research

    jumodada/Drissionpage-MCP-Server

    A skill your agent uses for authorized, read-only research on public Xiaohongshu content or the local Xiaohongshu-like playground fixture.

    487 GitHub stars~768 tokensUpdated 27 days ago
    Productivity & AutomationAuto-check passed
  • Qiaomu Codex Imagegen

    joeseesun/qiaomu-codex-imagegen

    Generate or edit images with Codex's built-in image generation from any agent, through an MCP tool or a plain CLI.

    125 GitHub stars~2.3k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed

More from tsingyuai/growth-lab

All 22 skills in this repo
  • Screenshot Assets

    tsingyuai/growth-lab

    Capture authenticated product screenshots through the repository-owned Playwright CDP script and archive them in the invoking loop's Memory.

    2k GitHub stars~583 tokensUpdated 12 days ago
    Auto-check passed
  • Media Crawler

    tsingyuai/growth-lab

    Install, authenticate, configure, operate, and troubleshoot the external MediaCrawler client shared by Douyin, Kuaishou, Bilibili, Weibo, Tieba, and Zhihu collectors.

    2k GitHub stars~731 tokensUpdated 12 days ago
    Auto-check passed
  • Run SEO Page Loop

    tsingyuai/growth-lab

    Run an SEO page observation-action-review loop with persistent Memory by coordinating demand research, page creation, adversarial review, image generation, IndexNow submission, and performance review.

    2k GitHub stars~1.2k tokensUpdated 12 days ago
    Auto-check passed
  • Wechat Article Compose

    tsingyuai/growth-lab

    把一个已确认的选题写成微信公众号长文。锁定复刻锚与用户价值、写出 article.md / wechat.yml / review.md,并通过公众号通用合规检查和人工预览前自检。准备、改写或核验公众号文章时使用;不负责发布,也不产出小红书卡片。

    2k GitHub stars~860 tokensUpdated 12 days ago
    Auto-check passed
  • Wechat Mp Publish

    tsingyuai/growth-lab

    通过微信公众号官方 API 把公众号文章生产单元渲染为微信排版 HTML、生成阅读页预览、上传封面与正文图片并创建草稿;在三重确认下提交发布并查询状态。支持本机直连与固定 IP 远程发布服务两种模式。用户要求预览公众号、同步微信草稿、发布公众号或查询发布状态时使用。

    2k GitHub stars~797 tokensUpdated 12 days ago
    Auto-check: notes
  • Xhs Render Cards

    tsingyuai/growth-lab

    把已批准的小红书草稿、单一分析参考和真实产品素材变成可审查卡片:先完成 DAI 与 image plan,再按确定性、完整效果或可分离图层模式制作,机械验证 PNG 与清单并运行合规检查。精确文字和真实 UI 不交给模型猜测;AI 生图需要单独配置和授权。

    2k GitHub stars~1k tokensUpdated 12 days ago
    Auto-check passed

Categories

Questions about Xiaohongshu MCP

What does Xiaohongshu MCP do?

使用本机 browser-first xiaohongshu-mcp 只读搜索小红书、下载候选首图、补全用户选择的笔记详情,并把脱敏证据写入调用方 Memory。用于 xhs-replicate 的选题和视觉参考研究,取代小红书 MediaCrawler 路径。. Xiaohongshu MCP is an agent skill from tsingyuai/growth-lab.

When should I use Xiaohongshu MCP?

Xiaohongshu MCP fits situations like: tasks that involve MCP servers.

How do I install Xiaohongshu MCP in Claude Code?

Run `npx skills add tsingyuai/growth-lab --skill xiaohongshu-mcp -a claude-code`. Or copy the skill folder (collectors/xiaohongshu-mcp in tsingyuai/growth-lab) into .claude/skills/xiaohongshu-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Xiaohongshu MCP in Codex?

Run `npx skills add tsingyuai/growth-lab --skill xiaohongshu-mcp -a codex`. Or copy the skill folder (collectors/xiaohongshu-mcp in tsingyuai/growth-lab) into .agents/skills/xiaohongshu-mcp in your project. Codex loads it when a task matches its description.

Can I use Xiaohongshu MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tsingyuai/growth-lab --skill xiaohongshu-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xiaohongshu-mcp, .gemini/skills/xiaohongshu-mcp, .github/skills/xiaohongshu-mcp and .opencode/skills/xiaohongshu-mcp in your project.

What does Xiaohongshu MCP need to run?

Going by SKILL.md and its folder, Xiaohongshu MCP needs Python and PowerShell for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3; PowerShell.

Does Xiaohongshu MCP access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Xiaohongshu MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Xiaohongshu MCP use?

Xiaohongshu MCP is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xiaohongshu MCP use?

About 822 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Xiaohongshu MCP?

Skills that share tags, products or a category with Xiaohongshu MCP: Sandbase (sandbaseai/cli, 188 stars), Setup Xhs MCP (autoclaw-cc/xiaohongshu-mcp-skills, 272 stars), Linkdigest Social Link Reader (sickn33/agentic-awesome-skills, 47k stars) and Xiaohongshu MCP (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xiaohongshu MCP?

tsingyuai (a GitHub organization) maintains it in tsingyuai/growth-lab, which has 2,000 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on September 28, 2026.

Source: tsingyuai/growth-lab on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.