← Back to Skills Marketplace
justoneapi

Xiaohongshu (RedNote) API

by justoneapi · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ✓ Security Clean
188
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install justoneapi-xiaohongshu
Description
Search Xiaohongshu notes, inspect creator profiles, resolve share links, and drill into note comments, replies, and note detail endpoints through JustOneAPI.
README (SKILL.md)

Xiaohongshu (RedNote)

Use this skill for Xiaohongshu note discovery, creator benchmarking, comment mining, and RedNote share-link resolution. It fits workflows where the user starts from a keyword, a note ID, a shared link, or an author ID and wants structured platform data rather than a generic summary.

When To Use It

  • The user wants Xiaohongshu note search, keyword expansion, or creator discovery around a topic.
  • The task is about a specific note, comment thread, reply chain, or creator page on Xiaohongshu.
  • The user can provide keyword, noteId, userId, shareUrl, or cursor-style pagination values such as lastCursor.
  • The user needs note metadata, engagement context, creator signals, or comment text sourced directly from Xiaohongshu endpoints.

Representative Operations

  • getSearchNoteV3: Note Search — Search Xiaohongshu notes by keyword for topic discovery, competitor tracking, and content collection.
  • getNoteDetailV7: Note Details — Pull note metadata, media, and engagement fields for deep inspection of a single post.
  • getUserV4: User Profile — Inspect creator profile data for account research and benchmark comparisons.
  • shareUrlTransferV1: Share Link Resolution — Convert a copied Xiaohongshu share link into note identifiers before running detail or comment queries.

Request Pattern

  • 15 read-only GET operations are available in this skill.
  • Common inputs are keyword, noteId, userId, lastCursor, page, commentId, and shareUrl.
  • Several endpoints are versioned variants for note detail, comments, and user data; prefer the smallest endpoint that matches the user request.
  • If the user only has a shared Xiaohongshu URL, resolve it first and then continue with detail or comment endpoints.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: getSearchNoteV3, getNoteDetailV7, getUserV4, shareUrlTransferV1.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

  • Required: JUST_ONE_API_TOKEN
  • This skill uses JUST_ONE_API_TOKEN only for authenticated Just One API requests.
  • Keep JUST_ONE_API_TOKEN private. Do not paste it into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Rules

  • Lead with the concrete Xiaohongshu outcome: note match, creator insight, resolved note ID, or comment finding.
  • For search-driven requests, restate the keyword, page, sort mode, and any note-type filter before summarizing results.
  • For note detail requests, surface title text, author, media type, engagement signals, and any obvious commercial or trend cues before raw JSON.
  • For creator-profile or published-note requests, highlight follower-facing signals and the most relevant recent notes first.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill appears internally consistent: it bundles an OpenAPI-driven node script that calls JustOneAPI endpoints and only needs your JUST_ONE_API_TOKEN. Before installing: 1) Confirm you trust JustOneAPI (https://api.justoneapi.com) and understand any billing or rate limits tied to your token; 2) Never paste the token into chat or public logs—store it as an environment variable; 3) Be aware the agent will run the included node script locally and make outbound requests to api.justoneapi.com when invoked; if you want to audit behavior, inspect bin/run.mjs before use. If you need stricter guarantees, ask the vendor for documentation about token scope/permissions or run the script in an isolated environment.
Capability Analysis
Type: OpenClaw Skill Name: justoneapi-xiaohongshu Version: 1.0.3 The skill bundle is a standard API wrapper for the JustOneAPI service to interact with Xiaohongshu (RedNote). The execution script (bin/run.mjs) uses the built-in fetch API to communicate with a hardcoded, legitimate base URL (https://api.justoneapi.com) and contains no logic for shell execution, file system access, or data exfiltration. The instructions in SKILL.md are well-aligned with the tool's stated purpose and include appropriate warnings regarding the protection of the API token.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description describe Xiaohongshu lookups and the skill requires JUST_ONE_API_TOKEN and the node runtime; the included operations, paths, and parameters all map to read-only Xiaohongshu endpoints on api.justoneapi.com, which is consistent with the stated purpose.
Instruction Scope
SKILL.md instructs the agent to pick an operation and run the provided node script with the JUST_ONE_API_TOKEN and JSON params. The instructions reference only operation docs and the token for authentication; they do not request unrelated files, system state, or other credentials.
Install Mechanism
No install spec is present (instruction-only), which is low risk. The package does include a node script (bin/run.mjs) and generated OpenAPI artifacts; these are invoked directly by the agent (node is a required binary). This is expected but users should note code will run locally when invoked.
Credentials
Only a single environment variable (JUST_ONE_API_TOKEN) is required and is the declared primary credential; this is proportionate for an API-wrapper skill and the SKILL.md explicitly states the token is used only for JustOneAPI requests.
Persistence & Privilege
always is false and the skill does not request persistent system-level privileges or modify other skills. It can be invoked autonomously (platform default), which is normal for a skill of this type.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-xiaohongshu
  3. After installation, invoke the skill by name or use /justoneapi-xiaohongshu
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Updated internal operation references in bin/run.mjs and generated docs. - Documentation regenerated for operations, with no changes to user-facing instructions or usage guidelines. - No changes to endpoints, authentication, or parameter requirements.
v1.0.2
justoneapi-xiaohongshu v1.0.2 - Updated external authentication and documentation URLs in the environment and setup instructions for consistency and improved guidance. - No changes to code or core functionality.
v1.0.1
- Updated the Just One API Dashboard link to use a referral URL with tracking parameters. - No changes to API functionality or endpoints. - Documentation and usage instructions remain the same except for the updated dashboard link.
v1.0.0
Initial publish
Metadata
Slug justoneapi-xiaohongshu
Version 1.0.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Xiaohongshu (RedNote) API?

Search Xiaohongshu notes, inspect creator profiles, resolve share links, and drill into note comments, replies, and note detail endpoints through JustOneAPI. It is an AI Agent Skill for Claude Code / OpenClaw, with 188 downloads so far.

How do I install Xiaohongshu (RedNote) API?

Run "/install justoneapi-xiaohongshu" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Xiaohongshu (RedNote) API free?

Yes, Xiaohongshu (RedNote) API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Xiaohongshu (RedNote) API support?

Xiaohongshu (RedNote) API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Xiaohongshu (RedNote) API?

It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.3.

💬 Comments