MBTI Personality Test - MBTI性格测试

\r \r

极速数据 MBTI 性格测试（Jisu Character / MBTI）\r

\r

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r

• 获取题目（/character/questions），支持 full（93 题）与 simple（28 题）\r
• 提交答案获取结果（/character/answer）\r
• 逐题推进模式：每次返回 1 道题，用户选择 A/B 后继续下一题，最后自动提交并返回 MBTI 结果\r \r

前置配置：获取 API Key\r

\r

1. 前往 极速数据官网 注册账号\r
2. 进入 MBTI 性格测试 API 页面，点击「申请数据」\r
3. 在会员中心获取 AppKey\r
4. 配置 Key：\r \r \r

# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/character/character.py`\r
\r
## 使用方式与请求参数\r
\r
### 1. 获取题目列表（/character/questions）\r
\r
```bash\r
# full（默认）\r
python3 skills/character/character.py questions\r
\r
# simple\r
python3 skills/character/character.py questions '{"version":"simple"}'\r
```\r
\r
请求 JSON：\r
\r
```json\r
{\r
  "version": "full"\r
}\r
```\r
\r
| 字段名   | 类型   | 必填 | 说明                 |\r
|----------|--------|------|----------------------|\r
| version  | string | 否   | `full` / `simple`，默认 `full` |\r
\r
### 2. 逐题返回题目并作答（推荐）\r
\r
这个模式用于「拿到题目以后，一个个返回题目让用户做；用户完成以后，再拼接选项拿到结果」。\r
\r
#### 2.1 获取第一题\r
\r
```bash\r
python3 skills/character/character.py next '{"version":"full"}'\r
```\r
\r
返回里会包含：\r
\r
- `cursor`：当前题索引（0 开始）\r
- `total`：题目总数\r
- `picked`：已选择的选项编码数组（用于下一次调用原样带回）\r
- `question`：当前题（包含 `answer1/answer2` 文案）\r
\r
#### 2.2 用户选择 A/B 后拿下一题\r
\r
把上一轮返回的 `cursor` 与 `picked` 带上，再附加 `choice`（A 或 B）：\r
\r
```bash\r
python3 skills/character/character.py next '{"version":"full","cursor":0,"picked":[],"choice":"A"}'\r
```\r
\r
当最后一题完成后，返回将包含：\r
\r
- `done: true`\r
- `answer`：拼接后的答案字符串（逗号分隔）\r
- `result`：MBTI 结果（type/name/summary/characteristic/field/job 等）\r
\r
请求 JSON（逐题模式）：\r
\r
```json\r
{\r
  "version": "full",\r
  "cursor": 0,\r
  "picked": ["x1", "y2"],\r
  "choice": "A"\r
}\r
```\r
\r
| 字段名  | 类型          | 必填 | 说明 |\r
|--------|---------------|------|------|\r
| version | string       | 否   | `full` / `simple`，默认 `full` |\r
| cursor  | int          | 否   | 当前题索引（0 开始），默认 0 |\r
| picked  | array\x3Cstring>| 否   | 已选编码数组（原样回传） |\r
| choice  | string       | 否   | 当前题选择：`A` 或 `B`（不传则仅返回当前题） |\r
\r
### 3. 直接提交答案拿结果（/character/answer）\r
\r
如果你已经在对话里收集到所有编码（例如 `x1,y1,x2,...`），可直接提交：\r
\r
```bash\r
python3 skills/character/character.py answer '{"version":"simple","answer":"x1,y1,x2,y2"}'\r
```\r
\r
也支持传数组：\r
\r
```bash\r
python3 skills/character/character.py answer '{"version":"simple","answers":["x1","y1","x2","y2"]}'\r
```\r
\r
### 4. 本地交互模式（终端逐题输入）\r
\r
适合你自己在命令行里跑一遍测试（会逐题提示输入 A/B）：\r
\r
```bash\r
python3 skills/character/character.py quiz '{"version":"full"}'\r
```\r
\r
## 常见错误码\r
\r
来自 [极速数据性格测试文档](https://www.jisuapi.com/api/character/) 的业务错误码：\r
\r
| 代号 | 说明     |\r
|------|----------|\r
| 201  | 答案不足 |\r
| 210  | 没有信息 |\r
\r
系统错误码：\r
\r
| 代号 | 说明                 |\r
|------|----------------------|\r
| 101  | APPKEY 为空或不存在  |\r
| 102  | APPKEY 已过期        |\r
| 103  | APPKEY 无请求权限    |\r
| 104  | 请求超过次数限制     |\r
| 105  | IP 被禁止            |\r
| 106  | IP 请求超过限制      |\r
| 107  | 接口维护中           |\r
| 108  | 接口已停用           |\r
\r
## 推荐用法\r
\r
1. 用户提问：「给我做一个 MBTI 测试（简单版）。」  \r
2. 代理调用：`python3 skills/character/character.py next '{"version":"simple"}'`，把返回的 `question` 展示给用户，只让用户回答 A 或 B。  \r
3. 用户每回答一次，代理把上一轮的 `cursor/picked` 带回，再加上 `choice` 调用 `next`，继续拿下一题。  \r
4. 当返回 `done: true` 时，把 `result` 里的 `type/name/summary/characteristic` 等字段整理成自然语言结果，并给出适合的职业建议（`field/job`）。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r