xiaohongshu-justoneapi

Original：🇨🇳 Chinese

Translated

5 scripts

Triggered when users need to crawl or collect Xiaohongshu (RedNote) data, including scenarios such as searching notes/content, topic discovery, searching users/bloggers, discovering KOLs/influencers, researching account information, capturing user notes, and collecting note comments/replies (public opinion, sentiment, community monitoring). Retrieve data by calling Xiaohongshu interfaces via JustOneAPI.

2installs

Sourcenoir-madlax/wantai-skills

Added on2026-04-29

NPX Install

npx skill4agent add noir-madlax/wantai-skills xiaohongshu-justoneapi

SKILL.md Content (Chinese)

View Translation Comparison →

Xiaohongshu Data Collection —— JustOneAPI

Use JustOneAPI to call Xiaohongshu interfaces for data crawling.

Prerequisite: Get Token

All interfaces are authenticated via the query parameter

token

. Obtain the token in the following priority order:

Search for
```
.env
```
files upwards from the current directory, matching
```
JUSTONEAPI_TOKEN
```
or
```
JUST_ONE_API_TOKEN
```
Read the system environment variables
```
JUSTONEAPI_TOKEN
```
or
```
JUST_ONE_API_TOKEN
```
If neither is found, exit with an error and prompt the user to add the token in
```
.env
```

When generating code, the token should be read from environment variables and not hard-coded into the code:

JUSTONEAPI_TOKEN=your_token_here

Error Codes (Applicable to All Interfaces)

⚠️
code
is in the response body, not the HTTP status code. Even if HTTP 200 is returned,
code
must be checked.

`code`	Meaning	Handling Strategy
`0`	Success	Process normally
`100`	Invalid or expired Token	Prompt user to check the token
`301`	Collection failed	Auto-retry with an interval of 2-3 seconds, maximum 3 times
`302`	Rate limit exceeded	Reduce request frequency and retry after waiting
`303`	Daily quota exceeded	Inform user that the daily quota has been used up
`400`	Parameter error	Check if required parameters are missing or formatted incorrectly
`500`	Internal server error	Retry later; if the issue persists, feedback to JustOneAPI
`600`	Insufficient permissions	Inform user that the current token has no access to this interface
`601`	Insufficient balance	Inform user to recharge on JustOneAPI

Interface Directory

Read the corresponding file according to the user's intent, do not rewrite scripts on your own.

User Intent	Interface Definition	Script
Search users / Discover bloggers / Check accounts	`apis/search_users.md`	`scripts/search_users.py`
Capture user-published notes / Content analysis / Competitor monitoring	`apis/get_user_posts.md`	`scripts/get_user_posts.py`
Search notes / Topic discovery / Keyword collection / Public opinion tracking	`apis/search_notes.md`	`scripts/search_notes.py`
Capture note comments / Comment replies / Public opinion analysis / Sentiment analysis	`apis/get_note_comments.md`	`scripts/get_note_comments.py`

Running Methods

All scripts are executed uniformly with

uv run

; no manual dependency installation is required:

bash

# Install uv (if not installed yet)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run directly, uv handles dependencies automatically
uv run scripts/search_users.py <keyword> [max_pages] [--output-dir DIR]
uv run scripts/get_user_posts.py <user_id> [user_id2 ...] [--output-dir DIR] [--since YYYY-MM-DD] [--workers N]
uv run scripts/search_notes.py <keyword> <max_pages> [--sort SORT] [--note-type TYPE] [--output-dir DIR]
uv run scripts/get_note_comments.py <note_id> [note_id2 ...] [--output-dir DIR] [--sort latest|normal] [--max-top N] [--no-replies]

# Examples
uv run scripts/search_users.py 美妆博主 5 --output-dir ./output
uv run scripts/get_user_posts.py 5b33a8556b58b74911b89949 5f279d91000000000100836c --output-dir ./output --since 2025-01-01
uv run scripts/search_notes.py 美妆 10 --sort popularity_descending --note-type _1 --output-dir ./output
uv run scripts/search_notes.py 机车骑行 20 --sort time_descending --output-dir ./output
uv run scripts/get_note_comments.py 65bf5360000000002c03f684 --output-dir ./output
uv run scripts/get_note_comments.py 65bf5360000000002c03f684 --no-replies         # Only capture top-level comments
uv run scripts/get_note_comments.py 65bf5360000000002c03f684 --max-top 100        # Stop pagination when top-level comments reach 100
uv run scripts/get_note_comments.py 65bf5360000000002c03f684 --sort normal        # Pull data in default sort order