# Xiaohongshu Data through toolfare

> Public Xiaohongshu (RedNote) data — note details, comments, creator profiles, a creator’s notes, and keyword search across notes and users — answered inside Claude, ChatGPT, Codex or Cursor. No Xiaohongshu developer account or scraping setup of your own: each call is quoted before it runs and paid from one toolfare balance.

Page: https://toolfare.ai/xiaohongshu-data

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to search Xiaohongshu for the most-collected notes about “防晒霜” and summarise what people recommend

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server,
create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in.
Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above
that many credits (1,000 credits = $3).

## Tools

### The public details of one note

Tool: `xiaohongshu_data_note`

Details of a note

Optional parameters: note_id, share_url

Cost: From $0.03

Ask:
- What does this Xiaohongshu note say, and how much engagement did it get?
- Here’s a RedNote share link — summarise the post for me.

### What commenters say under a note

Tool: `xiaohongshu_data_note_comments`

Comments on a note

Optional parameters: cursor, note_id, share_url, sort

Cost: From $0.03

Ask:
- What are people complaining about in the comments of this note?
- Show me the most-liked comments on this Xiaohongshu post.

### A creator’s public profile

Tool: `xiaohongshu_data_profile`

Public profile of a user

Optional parameters: share_url, user_id

Cost: From $0.03

Ask:
- Pull the public profile of this Xiaohongshu creator.
- How big is this RedNote account, and what do they post about?

### Notes on any topic, sorted the way you need

Tool: `xiaohongshu_data_search_notes`

Notes matching a keyword

Required parameters: keyword

Optional parameters: note_type, page, search_id, search_session_id, sort, time_range

Cost: From $0.03

Ask:
- Find the most-collected Xiaohongshu notes about Kyoto travel.
- What video notes are trending for “露营装备” right now?
- Search RedNote for reviews of our new serum, newest first.

### Creators who match a keyword

Tool: `xiaohongshu_data_search_users`

Users matching a keyword

Required parameters: keyword

Optional parameters: page, search_id

Cost: From $0.03

Ask:
- Find Xiaohongshu creators who post about home coffee brewing.
- Which RedNote accounts come up for “母婴测评”?

### What a creator has been posting

Tool: `xiaohongshu_data_user_notes`

Notes published by a user

Optional parameters: cursor, share_url, user_id

Cost: From $0.03

Ask:
- List the latest notes from this Xiaohongshu creator.
- What topics has this KOL covered in their recent notes?
## Price

From $0.03 Quoted before each call; the final charge follows the returned usage. Pay per call from one balance.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- You want to know what Xiaohongshu users say about a product, brand or place before a launch or campaign.
- You are shortlisting creators (KOLs/KOCs) and want their public profiles and recent notes side by side.
- You need the comments under a specific note — feedback, complaints, questions — summarised rather than scrolled.
- You are tracking which notes on a keyword get the most collects, comments or engagement, or what was posted most recently.

## Look elsewhere when

- You want short-video data from Douyin rather than Xiaohongshu notes.
- You need private data — messages, follower lists of an account you don’t control, or anything behind a login. Only public data is available.
- You want to post, reply or like. These tools only read.

## Limits

- Public data only — nothing that requires being signed in to Xiaohongshu.
- Note and user lookups take a 24-character id or a share link; keyword search is the way in when you have neither.
- Results come a page at a time; the agent passes the cursor or search id from the previous response to go further.
- Each call is a snapshot at the moment it runs. There is no historical archive of how a note’s numbers changed.
- Pay as you go from your toolfare balance, in US dollars; there is no subscription. A call runs when your balance covers its quote.