Xiaohongshu (RedNote) Note Search API

该 Skill 调用 JustOneAPI 的小红书笔记搜索接口，按关键词检索笔记，返回笔记片段、作者与媒体等数据，用于话题发现。支持 v2、v3 两个版本，可选时间、类型、排序与分页筛选；需配置 API Token，由 Node 脚本向外部接口发起请求。

justoneapi

热度 30.58

最近更新 2026-05-18 11:49:23

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 社交媒体 / 市场分析

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add justoneapi-xiaohongshu-search-note

Metadata

name: Xiaohongshu (RedNote) Note Search API
description: Call 2 search-note versions for Xiaohongshu (RedNote) Note Search through JustOneAPI with keyword.
author: JustOneAPI
homepage: https://api.justoneapi.com
metadata: {"openclaw":{"homepage":"https://api.justoneapi.com","primaryEnv":"JUST_ONE_API_TOKEN","requires":{"bins":["node"],"env":["JUST_ONE_API_TOKEN"]},"skillKey":"justoneapi_xiaohongshu_search_note"}}

Xiaohongshu (RedNote) Note Search

Use this focused JustOneAPI skill for note Search in Xiaohongshu (RedNote). It targets 2 versioned paths under /api/xiaohongshu/search-note. Required non-token inputs are keyword. OpenAPI describes it as: Get Xiaohongshu (RedNote) note Search data, including snippets, authors, and media, for topic discovery.

Endpoint Scope

Platform key: xiaohongshu
Endpoint key: search-note
Platform family: Xiaohongshu (RedNote)
Skill slug: justoneapi-xiaohongshu-search-note

Operation	Version	Method	Path	OpenAPI summary
`getSearchNoteV2`	`v2`	`GET`	`/api/xiaohongshu/search-note/v2`	Note Search
`getSearchNoteV3`	`v3`	`GET`	`/api/xiaohongshu/search-note/v3`	Note Search

Inputs

Parameter	In	Required by	Optional by	Type	Notes
`keyword`	`query`	all	n/a	`string`	Search keyword
`noteTime`	`query`	n/a	`getSearchNoteV2`	`string`	Note publish time filter. This parameter is for reference only and does not have much effect. Available Values: - `一天内`: Within one day - `一周内`: Within a week - `半年内`: Within half a year
`noteTime` enum	values	n/a	n/a	n/a	`一周内`, `一天内`, `半年内`
`noteType`	`query`	n/a	all	`string`	Note type filter. Available Values: - `_0`: General - `_1`: Video - `_2`: Normal
`noteType` enum	values	n/a	n/a	n/a	`_0`, `_1`, `_2`
`page`	`query`	n/a	all	`integer`	Page number for pagination
`sort`	`query`	n/a	all	`string`	Sort order for the result set. Available Values: - `general`: General - `popularity_descending`: Popularity Descending - `time_descending`: Time Descending - `comment_descending`: Comment Descending - `collect_descending`: Collect Descending
`sort` enum	values	n/a	n/a	n/a	`collect_descending`, `comment_descending`, `general`, `popularity_descending`, `time_descending`

Request body: none documented; send parameters through path or query arguments.

Version Choice

This skill groups 2 endpoint versions because their paths share search-note after removing the trailing version segment. Choose the version the user requested; if no version was requested, pick the operation whose required inputs match the data the user has.

getSearchNoteV2 (v2): required inputs keyword.
getSearchNoteV3 (v3): required inputs keyword.

Run This Endpoint

Supported operation IDs in this skill: getSearchNoteV2, getSearchNoteV3.

node {baseDir}/bin/run.mjs --operation "getSearchNoteV2" --token "$JUST_ONE_API_TOKEN" --params-json '{"keyword":"<keyword>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.

Environment

Required: JUST_ONE_API_TOKEN
Pass the token with --token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs.
Get a token from Just One API Dashboard.
Authentication details: Just One API Usage Guide.

Output Focus

State the operation ID and endpoint path used, for example getSearchNoteV2 on /api/xiaohongshu/search-note/v2.
Echo the required lookup scope (keyword) before summarizing results.
Prioritize fields that support this endpoint purpose: Get Xiaohongshu (RedNote) note Search data, including snippets, authors, and media, for topic discovery.
Return raw JSON only after the short, endpoint-specific summary.
If the backend errors, include the backend payload and the exact operation ID.