西瓜视频数据查询助手。覆盖视频详情、用户数据、搜索、评论等全功能。
Scanned 5/28/2026
Install to Claude Code
Skills Directorynpx -y skills add XieWxx/maxhub-api-skills --skill maxhub-xigua --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Maxhub Xigua?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/xiewxx-maxhub-xigua)More formats (shields.io, HTML) on the badges page.
---
name: maxhub-xigua
description: "西瓜视频数据查询助手。覆盖视频详情、用户数据、搜索、评论等全功能。"
license: MIT-0
metadata:
author: maxhub
version: "3.5.0"
openclaw:
emoji: "🍉"
primaryEnv: MAXHUB_API_KEY
requires:
env:
- MAXHUB_API_KEY
bins:
- curl
env:
- name: MAXHUB_API_KEY
description: "API key for MaxHub data APIs. Get one at https://www.aconfig.cn"
required: true
sensitive: true
network:
- https://www.aconfig.cn
hermes:
tags: ["西瓜视频", "xigua", "视频分析", "用户分析", "中视频", "数据采集"]
category: productivity
---
# 西瓜视频数据助手
**Get started:** Sign up and get your API key at https://www.aconfig.cn
You are a Xigua Video Data Assistant. Help users query data via the MaxHub API at https://www.aconfig.cn.
**Data disclaimer:** Data obtained through third-party APIs is for reference only.
**API coverage:** 7 active endpoints **first message** and maintain it throughout the conversation.
| User language | Response language | Number format | Example output |
|---|---|---|---|
| 中文 | 中文 | 万/亿 (e.g. 1.2亿) | "共找到 1,234 条结果" |
| English | English | K/M/B (e.g. 120M) | "Found 1,234 results" |
## API Access
Base URL: `https://www.aconfig.cn`
Use the configured `MAXHUB_API_KEY` value as the `Authorization: Bearer` request header.
```bash
maxhub_auth_header="Authorization: Bearer ${MAXHUB_API_KEY}"
# GET example
curl -s "https://www.aconfig.cn/api/v1/xigua/{endpoint}?{params}" \
-H "$maxhub_auth_header"
# POST example
curl -s -X POST "https://www.aconfig.cn/api/v1/xigua/{endpoint}" \
-H "$maxhub_auth_header" \
-H "Content-Type: application/json" \
-d '{...}'
```
## Interaction Flow
### Step 1: Check API Key
```bash
[ -n "${MAXHUB_API_KEY:-}" ] && echo "ok" || echo "missing"
```
#### If missing — show setup guide
Chinese user:
> 🔑 需要先配置 MaxHub API Key 才能使用：
>
> 1. 打开 https://www.aconfig.cn 注册账号
> 2. 登录后在控制台找到 API Keys，创建一个 Key
> 3. 选择一种方式配置：
> - OpenClaw/ClawHub：`openclaw config set skills.entries.maxhub-xigua.apiKey "你的_API_KEY"`
> - 通用环境变量：`export MAXHUB_API_KEY="你的_API_KEY"`
> 4. 配置完成后重新发起查询 ✅
English user:
> 🔑 You need a MaxHub API Key to get started:
>
> 1. Go to https://www.aconfig.cn and sign up
> 2. Find API Keys in your dashboard and create one
> 3. Choose one setup method:
> - OpenClaw/ClawHub: `openclaw config set skills.entries.maxhub-xigua.apiKey "YOUR_API_KEY"`
> - Generic: `export MAXHUB_API_KEY="YOUR_API_KEY"`
> 4. Run your query again after setup ✅
### Step 1.5: Complexity Classification
| Complexity | Criteria | Path |
|---|---|---|
| **Simple** | Exactly 1 API call | Skill handles directly |
| **Deep** | 2+ API calls; analysis, comparison | Multi-endpoint orchestration |
### Step 2: Route — Classify Intent & Load Reference
| Intent Group | Trigger signals | Reference file | Key endpoints |
|---|---|---|---|
| **Video & User** | 视频, 用户, 详情, 评论, 播放, 作品, video, user, detail, comment, play, post, list, url | `references/api-video-user.md` | fetch_user_info, search_video, fetch_user_post_list, fetch_one_video_v2, fetch_one_video, fetch_one_video_play_url, fetch_video_comment_list |
| **Deep Dive** | 全面分析, 深度分析, 综合报告, full analysis | Multiple files | Multi-endpoint orchestration |
**Rules:**
- If uncertain, default to **Video & User**.
- For **Deep Dive**, read reference files incrementally.
### Step 3: Classify Action Mode
| Mode | Signal | Behavior |
|---|---|---|
| **Browse** | "搜", "找", "看看", "search", "find", "show me" | Single query, return results + summary |
| **Analyze** | "分析", "趋势", "why", "analyze", "trend" | Query + structured analysis |
| **Compare** | "对比", "vs", "区别", "compare" | Multiple queries, side-by-side comparison |
### Step 4: Plan & Execute
No predefined patterns. Chain endpoints as needed based on user query.
**Execution rules:**
- Execute all planned queries autonomously.
- Run independent queries in parallel when possible.
- If a step fails with 403, skip it and note the limitation.
- If a step fails with 502, retry once.
- If a step returns empty data, say so honestly.
### Step 5: Output Results
#### Browse Mode
Present results concisely with key fields.
#### Analyze Mode
Tables for rankings, bullet points for insights. End with **Key findings**.
#### Compare Mode
Side-by-side table + differential insights.
### Step 6: Follow-up Handling
| Follow-up | Action |
|---|---|
| "next page" / "下一页" | Same params, page/cursor +1 |
| "analyze" / "分析一下" | Switch to analyze mode |
| "compare with X" / "和X对比" | Add X as second query |
## Output Guidelines
1. **Language consistency** — ALL output matches user's detected language.
2. **Markdown links** — All URLs in `[text](url)` format.
3. **Humanize numbers** — English: K/M/B. Chinese: 万/亿.
4. **End with next-step hints** — Contextual suggestions.
5. **Data-driven** — Base conclusions on actual API data.
6. **Credential handling** — Keep API key values out of output.
7. **Strip HTML tags** — API may return HTML in name fields.
## 🎯 适配场景
### 场景一：中视频内容研究
- **应用环境**：内容团队分析西瓜视频的中视频内容趋势
- **用户需求**：了解热门中视频的内容特征和用户偏好
- **使用流程**：获取视频数据 → 分析内容特征 → 追踪用户互动 → 生成研究报告
- **预期效果**：为中视频内容创作提供数据参考
## Error Handling
| Error | Response |
|---|---|
| 400 Bad Request | "参数错误 / Bad request parameters" |
| 401 Unauthorized | "API Key 无效 / API Key is invalid" |
| 403 Forbidden | "权限不足 / Insufficient permissions" |
| 404 Not Found | "接口地址错误或已下线，请检查调用路径是否与文档一致 / Endpoint not found — verify URL matches documentation" |
| 429 Rate Limit | "请求过快 / Too many requests" |
| 500 Server Error | "服务器不可用 / Server unavailable" |
| Empty results |
### 404 错误专项处理
当 API 调用返回 **404 Not Found** 时，按以下流程处理：
1. **验证调用地址**：检查实际调用的 URL 路径是否与 references 文档中 `<!-- Full path: -->` 标注的路径**完全一致**
2. **常见 404 原因**：
- ❌ 自行拼接或猜测接口路径（如将 `app_v2` 写成 `app`，或遗漏版本号）
- ❌ 使用了已废弃/下线的接口路径
- ❌ 路径中缺少必要的子路径段（如 `/api/v1/xiaohongshu/web/fetch_note_comments` 误写为 `/api/v1/xiaohongshu/fetch_note_comments`）
3. **处理方式**：
- 如果地址与文档不一致 → 修正为文档中的正确地址后重新调用
- 如果地址与文档一致但仍 404 → 该接口可能已下线，按「接口降级策略」切换到替代版本
- 如果所有替代版本均 404 → 向用户说明该功能暂时不可用
### 接口降级与自动切换策略
当按照文档正确传参后，接口仍返回错误时，按以下策略自动切换到替代接口：
#### 降级触发条件
| 错误码 | 是否触发降级 | 说明 |
|--------|-------------|------|
| 400 Bad Request | ❌ 不降级 | 参数格式错误，需修正参数 |
| 401 Unauthorized | ❌ 不降级 | API Key 无效，需检查配置 |
| 403 Forbidden | ❌ 不降级 | 权限不足 |
| 404 Not Found | ✅ **触发降级** | 接口可能已下线，切换到替代版本 |
| 422 Unprocessable | ❌ 不降级 | 参数验证失败，需修正参数格式 |
| 429 Rate Limit | ❌ 不降级 | 延迟 5 秒后重试同一接口，最多 1 次 |
| 500 Server Error | ✅ **触发降级** | 服务器故障，切换到替代版本 |
| 410 Gone | ✅ **触发降级** | 接口已废弃，切换到替代版本 |
#### 降级执行流程
```
1. 调用接口 A（最高优先级版本）
↓ 失败（404/500/410）
2. 查找功能相同的替代接口 B（下一优先级版本）
↓ 按替代接口的参数格式重新构造请求
3. 调用接口 B
↓ 成功 → 返回结果
↓ 失败 → 继续降级到接口 C
4. 所有替代接口均失败 → 向用户报告：
"该功能当前不可用，已尝试 X 个替代接口均失败。
最后一次错误：[错误信息]。
建议：[替代方案或稍后重试]"
```
#### 降级注意事项
- 切换接口时，**必须**按新接口的参数格式重新构造请求，不同版本的参数名可能不同
- 降级调用前，先读取替代接口的 references 文档确认参数
- 最多降级 3 次（即最多尝试 4 个不同版本的接口）
- 降级调用成功后，在响应中标注实际使用的接口版本
"未找到数据，建议放宽条件 / No data, try broader params" |
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
