Skill: admin6016/xhsmatrixmanager (version 1.0.0)

--- name: xhs-matrix-api description: 小红书矩阵系统 API 调用工具，集成红薯矩阵平台（hongshujuzhen.com）。支持：搜索小红书笔记、获取笔记详情、发布图文笔记、查询账号列表、查询 API 使用统计、批量管理小红书账号。触发词：小红书、xhs、笔记搜索、发布小红书、API 调用、红薯矩阵。 --- # xhs-matrix-api 小红书矩阵系统 API 调用工具，基于**红薯矩阵平台**（hongshujuzhen.com）。 ## 平台信息 - **官网**: https://hongshujuzhen.com - **注册获取 API Key**: 注册账号后自带 API Key - **联系购买/咨询**: 微信 admin6016 - **核心功能**: IP 代理隔离、批量发布、账号管理 ## 基础配置 - **API 域名**: `http://redapi.cn` - **认证**: 请求头 `X-[REDACTED_SECRET]`（注册后获取） - **完整 URL**: `http://redapi.cn/api/external-api/{endpoint}` ## 工作流程 1. 确认用户需求（搜索/发布/查询账号） 2. 查看 `references/api.md` 获取对应接口的请求参数和代码示例 3. 使用 `exec` 工具执行 Python 请求 ## 常用接口速查 | 接口 | 消耗 | 用途 | |------|------|------| | GET /accounts | 1次 | 获取账号列表 | | POST /search | 2次 | 搜索笔记 | | POST /note-detail | 2次 | 获取笔记详情 | | POST /publish | 5次 | 发布图文笔记 | | GET /usage | 1次 | 使用统计 | 详细参数和响应格式请参阅 `references/api.md`。

path: references/api.md
content: # 小红书矩阵系统 API 文档

## 基础信息

- **API 域名**: `http://redapi.cn`
- **完整 URL**: `http://redapi.cn/api/external-api/{endpoint}`
- **认证方式**: 请求头 `X-[REDACTED_SECRET]` 或查询参数 `?[REDACTED_SECRET]`
- **响应格式**: JSON

## 通用响应格式

```json
{
  "code": 200,
  "message": "成功",
  "data": {...}
}
```

## 错误码

| code | 说明 |
|------|------|
| 200 | 成功 |
| 400 | 请求参数错误 |
| 401 | 未授权 |
| 403 | 禁止访问 |
| 404 | 资源不存在 |
| 429 | 请求频率过高 |
| 500 | 服务器内部错误 |

---

## 接口列表

### GET /external-api/accounts（消耗 1 次）

获取账号列表

```python
import requests

url = "http://redapi.cn/api/external-api/accounts"
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
data = response.json()

if data["code"] == 200:
    accounts = data["data"]["accounts"]
    for account in accounts:
        print(f"账号ID: {account['id']}, 昵称: {account['nickname']}")
```

**响应示例**:
```json
{
  "code": 200,
  "data": {
    "accounts": [
      {"id": 123, "nickname": "小红薯用户", "red_id": "5f8a9b2c...", "status": "active"}
    ]
  }
}
```

---

### POST /external-api/search（消耗 2 次）

搜索笔记

**请求参数**:
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| keyword | string | 是 | 搜索关键词 |
| page | integer | 否 | 页码，默认1 |
| page_size | integer | 否 | 每页数量，默认20 |
| sort | string | 否 | GENERAL/MOST_POPULAR/LATEST |

```python
import requests

url = "http://redapi.cn/api/external-api/search"
headers = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
data = {"keyword": "美食推荐", "page": 1, "page_size": 20, "sort": "MOST_POPULAR"}
response = requests.post(url, headers=headers, json=data)
```

**响应示例**:
```json
{
  "code": 200,
  "data": {
    "keyword": "美食推荐",
    "total": 1000,
    "has_more": true,
    "items": [
      {
        "id": "67685c7f...",
        "title": "超好吃的蛋糕制作教程",
        "desc": "分享一个简单易学的蛋糕...",
        "author": {"nickname": "美食达人小王", "user_id": "5f8a9b2c..."},
        "like_count": 2580,
        "images": ["https://example.com/image1.jpg"]
      }
    ]
  }
}
```

---

### POST /external-api/note-detail（消耗 2 次）

获取笔记详情

**请求参数**:
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| note_id | string | 是 | 笔记ID |
| xsec_token | string | 是 | 笔记安全令牌 |

```python
import requests

url = "http://redapi.cn/api/external-api/note-detail"
headers = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
data = {"note_id": "67685c7f000000001e00f5b9", "xsec_token": ""}
response = requests.post(url, headers=headers, json=data)
```

**响应示例**:
```json
{
  "code": 200,
  "data": {
    "note_id": "67685c7f...",
    "title": "超好吃的蛋糕制作教程",
    "desc": "今天分享一个简单易学的蛋糕...",
    "type": "normal",
    "images": [{"url": "https://sns-img-qc.xhscdn.com/...", "width": 1024, "height": 768}],
    "interact_info": {"liked_count": 2580, "collected_count": 456, "comment_count": 128, "share_count": 89},
    "author": {"user_id": "5f8a9b2c...", "nickname": "美食达人小王", "avatar": "..."},
    "tags": ["美食", "烘焙", "蛋糕"],
    "publish_time": 1699123456000,
    "ip_location": "上海"
  }
}
```

---

### POST /external-api/publish（消耗 5 次）

发布图文笔记

**请求参数**:
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| account_id | integer | 是 | 小红书账号ID |
| title | string | 是 | 笔记标题（最大100字符） |
| content | string | 是 | 笔记内容（最大1000字符） |
| image_urls | array | 是 | 图片URL列表（1-9张） |
| topics | array | 否 | 话题标签列表 |
| scheduled_at | string | 否 | 定时发布时间 YYYY-MM-DD HH:MM:SS |

```python
import requests

url = "http://redapi.cn/api/external-api/publish"
headers = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
data = {
    "account_id": 123,
    "title": "分享一道超好吃的家常菜",
    "content": "今天给大家分享一道简单易做的家常菜...",
    "image_urls": ["https://example.com/image1.jpg", "https://example.com/image2.jpg"],
    "topics": ["美食", "家常菜"]
}
response = requests.post(url, headers=headers, json=data)
```

**响应示例**:
```json
{
  "code": 200,
  "data": {
    "task_id": "task_123456789",
    "status": "scheduled",
    "scheduled_at": "2024-01-15 18:00:00"
  }
}
```

---

### GET /external-api/usage（消耗 1 次）

获取使用统计

```python
import requests

url = "http://redapi.cn/api/external-api/usage"
headers = {"X-API-Key": "YOUR_API_KEY"}
params = {"page": 1, "per_page": 10}
response = requests.get(url, headers=headers, params=params)
```

**响应示例**:
```json
{
  "code": 200,
  "data": {
    "total_requests": 1000,
    "remaining_requests": 750,
    "today_usage": 25,
    "records": [{"endpoint": "/external-api/search", "cost": 2, "created_at": "2024-01-15 14:30:00"}]
  }
}
```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)