> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills API 总览

> DropCV 把人才库的数据能力作为 Skills 对外开放，可通过 HTTP API、MCP Server 或 CLI 调用。

DropCV Skills API 是面向开发者的对外接口。它把 DropCV 的**人才库数据能力**封装成标准化的 **skill**，配合 API Key 鉴权对外开放。

同一套 skill，三种调用方式：

<CardGroup cols={3}>
  <Card title="HTTP API" icon="globe" href="/integration/skills/protocol">
    标准 RESTful 接口，适合系统对接和脚本自动化。
  </Card>

  <Card title="MCP Server" icon="plug" href="/integration/mcp">
    在 Claude Code、Cherry Studio 等 AI 工具里用自然语言调用。
  </Card>

  <Card title="CLI" icon="terminal" href="/integration/cli">
    `@dropcv/cli` 命令行工具，终端里直接调用。
  </Card>
</CardGroup>

## 设计哲学

DropCV 专注做**最好的 AI 简历库/人才库**——把候选人数据沉淀、结构化、向量化做到极致。

Skills API 只暴露**数据访问层**：搜人、读候选人档案、解析 JD、把简历入库、更新候选人、删除候选人。业务智能（推荐语、面试题、匹配分析、沟通策略、候选人对比）由你的 AI 工具用大模型生成——DropCV 不和 GPT / Claude / Gemini 在"会写好文案"上竞争，只负责提供干净、结构化的人才数据作为输入。

如果你也想要这些业务智能能力，DropCV 把它们做成了**提示词技能（Agent Skills）**——纯提示词、跑在你自己的模型上、不消耗 DropCV 的额度。详见 [Agent Skills 技能包](/integration/agent-skills)。

## 可用 Skills

Skills API / MCP / CLI 开放 9 个数据能力：

| Skill                    | 功能                            | 类型 |
| ------------------------ | ----------------------------- | -- |
| `candidate_search`       | 人才库**语义**搜索（按 JD/画像找相似的人）     | 读  |
| `candidate_list`         | 人才库**列表/关键词**查询（翻页、按姓名/公司精确找） | 读  |
| `candidate_profile_read` | 按 ID 读取候选人完整档案                | 读  |
| `jd_parse`               | JD 文本结构化解析                    | 读  |
| `save_candidate`         | 简历入库                          | 写  |
| `candidate_update`       | 候选人字段 partial update          | 写  |
| `candidate_delete`       | 永久删除候选人档案                     | 写  |
| `candidate_note_add`     | 给候选人笔记时间线追加一条笔记               | 写  |
| `candidate_tag_add`      | 给候选人追加自定义标签（去重）               | 写  |

<Note>
  **读 skill** 用任意 API Key 即可调用；**写 skill**（`save_candidate` / `candidate_update` / `candidate_delete` / `candidate_note_add` / `candidate_tag_add` / 文件上传）需要 Key 开启 write 权限。详见 [鉴权](/integration/skills/authentication)。
</Note>

运行时随时可以用 `GET /api/external/v1/skills` 或 `dropcv skill list` 查询当前可用的 skill 列表和各自的入参 schema。

## 快速开始

1. 在 [设置 → API Keys](https://app.dropcv.work/dashboard/settings/api-keys) 生成你的 API Key
2. 复制 key 到本地（明文只显示一次）
3. 跟着 [快速开始（curl）](/integration/skills/quickstart-curl) 跑通第一次调用

## 相关阅读

* [鉴权](/integration/skills/authentication) — API Key 的生成 / 撤销 / write 权限
* [API 协议](/integration/skills/protocol) — 请求 / 响应 envelope、错误码
* [文件上传](/integration/skills/file-upload) — save\_candidate 之前的附件上传流程
* [MCP Server](/integration/mcp) — 在 AI 工具里接入
* [Agent Skills 技能包](/integration/agent-skills) — 推荐语 / 面试题等业务智能提示词技能
* [CLI 命令行](/integration/cli) — `@dropcv/cli` 用法