xhs-operation-assistant（xhs 运营助理）

小红书运营助手

自媒体博主必备 - 获取小红书官方帐号最新笔记,也包括了网易蛋仔派对,POPMART泡泡玛特等这类官方品牌笔记 - 获取热点话题,包括话题简介.运营人员可根据热点话题进行二次创作,以获取更多的关注 - 对帐号和笔记进行打分评价,包括用户昵称,简介,笔记标题和内容

描述

1. 官方笔记查询(/xhs/get_op_note_list)：支持分页、按账号精确匹配、按类型精确匹配、按描述模糊搜索（不区分大小写）。
2. 官方帐号列表(/xhs/get_op_account_list)：返回所有运营账号及其描述，不分页、无过滤。
3. 热点话题列表(/xhs/get_hot_topic):返回平台热点话题,最多40条,无需分页。
4. 小红书评分标准提示词接口(/xhs/get_score_prompt):返回用户昵称,简介和笔记标题,内容的评价标准。

注意事项

1. 严禁编造：如果API返回数据为空或报错，请明确告知用户“暂未获取到数据”，禁止自行生成虚假的热点话题或评分。
2. 某些返回的json字段经过加密,需要用脚本'scripts/tool.py'中的xor_decrypt()进行解码

基础 URL

默认：https://qianhaistonepark.site/

1.获取小红书官方笔记列表和内容接口

- 返回数据按时间从新到旧排序 - 如果没有指定笔记类型(note_type)和笔记账号(note_account),则返回最新的官方笔记 - 由于小红书笔记详情页必须从帐号首页跳到详情页,不要使用id拼url直接跳转,只能用account_url跳到帐号首页

GET /xhs/get_op_note_list

• ### 请求参数（全部可选）

• ### 响应格式

JSON 数组，每个元素包含以下字段：

{
  "note_id": "string",
  "note_type": "string",
  "note_account": "string",
  "account_url": "string",
  "note_title": "string or null",
  "note_desc": "string or null",
  "note_date": "string or null"
}

• ### curl 示例

# 基础分页查询（第一页，每页 10 条）
curl "https://qianhaistonepark.site/xhs/get_op_note_list?page=1&page_size=10"
# 按账号精确查询
curl "https://qianhaistonepark.site/xhs/get_op_note_list?note_account=%40%E8%96%AF%E9%98%9F%E9%95%BF"
# 按类型查询 + 分页
curl "https://qianhaistonepark.site/xhs/get_op_note_list?note_type=%E5%AE%98%E6%96%B9%E5%8F%B7&page=1&page_size=20"
# 按描述模糊搜索（包含“旅游”）
curl "https://qianhaistonepark.site/xhs/get_op_note_list?note_desc=%E6%97%85%E6%B8%B8"
# 组合条件
curl "https://qianhaistonepark.site/xhs/get_op_note_list?note_account=%40%E8%96%AF%E9%98%9F%E9%95%BF&note_type=%E5%AE%98%E6%96%B9%E5%8F%B7&note_desc=%E9%BB%91%E5%AE%A2%E6%9D%BE&page=1&page_size=5"

2.获取小红书所有官方账号列表接口

op_url可直接跳转到帐号首页

GET /xhs/get_op_account_list

• ### 请求参数

无

• ### 响应格式

JSON 数组，每个元素包含：

{
  "op_account": "string",
  "op_url": "string",
  "op_desc": "string or null",
  "_field_comments": {
    "op_account": "帐号,出于习惯会带上@用于指名这是小红书帐号,如薯队长,习惯表示@薯队长",
    "op_url": "帐号首页URL,可以直接跳转",
    "op_desc": "帐号简介,来源为帐号首页的简介"
  }
}

• ### curl 示例

curl "https://qianhaistonepark.site/xhs/get_op_account_list"

3.获取热点话题

GET /xhs/get_hot_topic

• ### 请求参数

无

• ### 响应格式

JSON 数组，按热点指数降序排序,每个元素包含：

{
  "hot_title": "string",
  "hot_desc": "string",
  "hot_heat_index": "string",
  "hot_search_url": "string or null",
  "_field_comments": {
    "hot_title": "热点话题,需要解码",
    "hot_desc": "热点话题简介,需要解码",
    "hot_heat_index": "热度指数，数字加单位的方式,如200W,表示200万",
    "hot_search_url": "小红书话题搜索链接,需要解码"
  }
}

• ### curl 示例

# 获取平台热点话题
curl "https://qianhaistonepark.site/xhs/get_hot_topic"

4.小红书评分标准提示词接口

提示词:请根据如下接口返回的标准分别给用户的昵称,简介,和笔记的标题内容进行评分(10分满分),并按接口标准给出建议

GET /xhs/get_score_prompt

• ### 请求参数（全部可选）

• ### 响应格式

JSON 数组，按热点指数降序排序,每个元素包含：

{
  "score_prompt": "string",
  "_field_comments": {
    "score_prompt":"需要解码,解码后的内容为Markdown格式"
  }
}

5.健康检查接口（可选）

• ### curl 示例

curl "https://qianhaistonepark.site/health"

• ### 返回示例：

{
  "status": "ok",
  "cached_notes": 240,
  "cached_accounts": 48
}

安全说明

为了保护数据源稳定性，防止接口被恶意爬虫滥用，部分返回字段采用了轻量级加密。 本 Skill 已内置 scripts/tool.py 解密模块，Agent 会自动解密并展示明文内容，用户无需手动操作。