Agent skill

Xhs APIs

A skill your agent uses when you need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data or creator-platform publishing data.

No licenceAuto-check passed

Install Xhs APIs

skills CLI

$ npx skills add cv-cat/XhsSkills --skill xhs-apis -a claude-code

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

GitHub CLI

$ gh skill install cv-cat/XhsSkills xhs-apis --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/cv-cat/XhsSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xhs-apis .claude/skills/xhs-apis && 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/

Paste into Claude Code

Install the "xhs-apis" agent skill from https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis into .claude/skills/xhs-apis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-apis", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add cv-cat/XhsSkills --skill xhs-apis -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install cv-cat/XhsSkills xhs-apis --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/cv-cat/XhsSkills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/xhs-apis .agents/skills/xhs-apis && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "xhs-apis" agent skill from https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis into .agents/skills/xhs-apis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-apis", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add cv-cat/XhsSkills --skill xhs-apis -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install cv-cat/XhsSkills xhs-apis --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/cv-cat/XhsSkills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/xhs-apis .cursor/skills/xhs-apis && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "xhs-apis" agent skill from https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis into .cursor/skills/xhs-apis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-apis", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/cv-cat/XhsSkills.git --path skills/xhs-apis

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add cv-cat/XhsSkills --skill xhs-apis -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install cv-cat/XhsSkills xhs-apis --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/cv-cat/XhsSkills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/xhs-apis .gemini/skills/xhs-apis && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "xhs-apis" agent skill from https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis into .gemini/skills/xhs-apis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-apis", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install cv-cat/XhsSkills xhs-apis

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add cv-cat/XhsSkills --skill xhs-apis -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/cv-cat/XhsSkills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/xhs-apis .github/skills/xhs-apis && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "xhs-apis" agent skill from https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis into .github/skills/xhs-apis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-apis", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add cv-cat/XhsSkills --skill xhs-apis -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install cv-cat/XhsSkills xhs-apis --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/cv-cat/XhsSkills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/xhs-apis .opencode/skills/xhs-apis && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "xhs-apis" agent skill from https://github.com/cv-cat/XhsSkills/tree/master/skills/xhs-apis into .opencode/skills/xhs-apis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs-apis", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: xhs-apis
GitHub stars: 222
Token cost: ~605 tokens
SKILL.md length: 216 words
Files: 22 (incl. scripts, references)
Skills in repo: 1
Repo updated: Aug 18, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

A skill your agent uses when you need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data or creator-platform publishing data.

Works in 4 steps: Install Python dependencies → Install Node dependencies → Inspect available methods → …
You need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data
SKILL.md covers Overview, Quick Start, Workflow and Parameter Rules, plus 2 more sections
Runs JavaScript and Python scripts from its folder; calls npm, python and pip; reaches xiaohongshu.com

What it does

Xhs APIs is an agent skill from cv-cat/XhsSkills. Use this skill when you need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data or creator-platform publishing data. This skill only wraps the APIs in xhspcapis.py and xhscreatorapis.py, including note, user, search, comment, topic, location, media upload, note publishing, and creator published-note queries.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 28 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/api-index.md` and `scripts/package.json`).

It works with Xiaohongshu. The repository describes itself as: 小红书平台全部接口SKILLS，包含数据爬虫，发送作品.

When your agent uses it

You need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data
Creator-platform publishing data

Example prompts

“/xhs-apis”

Requirements

Python 3
Node.js

Workflow steps

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

Install Python dependencies
Install Node dependencies
Inspect available methods
Call an API

What it can do on your machine

Read from SKILL.md and the folder at commit 138288d. 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 11 files in scripts/ (JavaScript and Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- npm
- python
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- xiaohongshu.com
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

Xhs APIs loads about 605 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 86 tokens; SKILL.md has 216 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 216 words (~605 tokens).

“Use this skill to run the vendored Spider_XHS APIs for XHS PC and creator-platform workflows. This skill only exposes the methods defined in xhs_pc_apis.py and xhs_creator_apis.py.”

— opening of SKILL.md by cv-cat

name: xhs-apis

Read the full SKILL.md on GitHub

Files

SKILL.md and 21 other files (scripts, references) in skills/xhs-apis of cv-cat/XhsSkills.

SKILL.md
agents/openai.yaml
references/api-index.md
scripts/package.json
scripts/requirements.txt
scripts/runtime/spider_xhs_core/apis/__init__.py
scripts/runtime/spider_xhs_core/apis/xhs_creator_apis.py
scripts/runtime/spider_xhs_core/apis/xhs_pc_apis.py
scripts/runtime/spider_xhs_core/static/xhs_creator_260411.js
scripts/runtime/spider_xhs_core/static/xhs_creator_sign.js
scripts/runtime/spider_xhs_core/static/xhs_creator_sign_other.js
scripts/runtime/spider_xhs_core/static/xhs_creator_signature.js
scripts/runtime/spider_xhs_core/static/xhs_main_260411.js
scripts/runtime/spider_xhs_core/static/xhs_xray.js
… and 8 more

Open the folder on GitHubat commit 138288d

Compare with similar skills

Xhs APIs 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.

Xhs APIs compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Xhs APIs this skillcv-cat/XhsSkills	222	—	~605	Automated safety check: Pass	None	1 mo ago
Agent ReachPanniantong/Agent-Reach	95k	—	~1.4k	Automated safety check: Pass	MIT	2 days ago
Guizang Social Cardsop7418/guizang-social-card-skill	7.4k	1 repos	~7.8k	Automated safety check: Pass	AGPL-3.0	3 mo ago
Yuwen Publish Precheckyuwen-cool/yuwen-publish-precheck	777	1 repos	~1.8k	Automated safety check: Pass	MIT	2 days ago
Video Podcast MakerAgents365-ai/video-podcast-maker	1.7k	—	~4.9k	Automated safety check: Pass	MIT	8 days ago
Xhs Note Creatorcomeonzhj/Auto-Redbook-Skills	2.3k	—	~580	Automated safety check: Notes	None	1 mo ago

Similar skills

Agent Reach
Panniantong/Agent-Reach
Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.
95k GitHub stars~1.4k tokensUpdated 2 days ago
Productivity & AutomationAuto-check passed
Guizang Social Cards
op7418/guizang-social-card-skill
Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.
7.4k GitHub starsUsed in 1 repo~7.8k tokens
Media & CreativeAuto-check passed
Yuwen Publish Precheck
yuwen-cool/yuwen-publish-precheck
国内自媒体发布前风险自审与保意修复：审口播稿、文章、图文笔记、字幕、封面文字能不能发抖音/小红书/微信视频号，给出具体位置、依据和可直接替换的改稿；被限流/删除/处罚后帮你复盘归因；你的行业敏感词、误报白名单和踩坑案例会沉淀成个人规则库，越用越准。Use when…
777 GitHub starsUsed in 1 repo~1.8k tokens
Productivity & AutomationAuto-check passed
Video Podcast Maker
Agents365-ai/video-podcast-maker
A skill your agent uses when the user gives a topic and wants an automated topic-driven narrated explainer, podcast, or knowledge-summary video (Bilibili / YouTube / Xiaohongshu / Douyin / WeChat…
1.7k GitHub stars~4.9k tokensUpdated 8 days ago
Media & CreativeAuto-check passed
Xhs Note Creator
comeonzhj/Auto-Redbook-Skills
小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含：根据用户的需求和提供的资料，撰写小红书笔记内容（标题+正文），生成图片卡片（封面+正文卡片），以及发布小红书笔记。支持 8 种精美排版主题和 4 种智能分页模式。
2.3k GitHub stars~580 tokensUpdated 1 mo ago
Auto-check: notes
Xhs Virtual Product
chenjin-cmd/xhs-virtual-product
This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.
729 GitHub stars~862 tokensUpdated 9 days ago
Knowledge ManagementAuto-check passed

Works with

Xiaohongshu

Questions about Xhs APIs

What does Xhs APIs do?

A skill your agent uses when you need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data or creator-platform publishing data. Xhs APIs is an agent skill from cv-cat/XhsSkills. Use this skill when you need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data or creator-platform publishing data.

When should I use Xhs APIs?

Xhs APIs fits situations like: you need to call the vendored Xiaohongshu/XHS APIs from SpiderXHS for PC web data; creator-platform publishing data.

How do I install Xhs APIs in Claude Code?

Run `npx skills add cv-cat/XhsSkills --skill xhs-apis -a claude-code`. Or copy the skill folder (skills/xhs-apis in cv-cat/XhsSkills) into .claude/skills/xhs-apis in your project. Claude Code loads it when a task matches its description.

How do I install Xhs APIs in Codex?

Run `npx skills add cv-cat/XhsSkills --skill xhs-apis -a codex`. Or copy the skill folder (skills/xhs-apis in cv-cat/XhsSkills) into .agents/skills/xhs-apis in your project. Codex loads it when a task matches its description.

Can I use Xhs APIs 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 cv-cat/XhsSkills --skill xhs-apis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xhs-apis, .gemini/skills/xhs-apis, .github/skills/xhs-apis and .opencode/skills/xhs-apis in your project.

What does Xhs APIs need to run?

Going by SKILL.md and its folder, Xhs APIs needs JavaScript and Python for the scripts in its folder and the command-line tools its instructions call (npm, python and pip). Our summary lists: Python 3; Node.js.

Does Xhs APIs access the network?

SKILL.md names 1 domain. In commands or code: xiaohongshu.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Xhs APIs 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 Xhs APIs use?

No licence was found for Xhs APIs or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Xhs APIs use?

About 605 tokens (SKILL.md is roughly 2.4k 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 Xhs APIs?

Skills that share tags, products or a category with Xhs APIs: Agent Reach (Panniantong/Agent-Reach, 95k stars), Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars), Yuwen Publish Precheck (yuwen-cool/yuwen-publish-precheck, 777 stars) and Video Podcast Maker (Agents365-ai/video-podcast-maker, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xhs APIs?

cv-cat (a GitHub user) maintains it in cv-cat/XhsSkills, which has 222 GitHub stars. The repository was last updated on August 18, 2026.

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

Install Xhs APIs

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Agent Reach

Guizang Social Cards

Yuwen Publish Precheck

Video Podcast Maker

Xhs Note Creator

Xhs Virtual Product

Related

Questions about Xhs APIs