Skip to main content

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.

candidate_search 是最常用的 skill。它支持两种用法：
  1. 关键词搜：“Python 后端 5 年” / “互联网大厂技术总监”
  2. JD 匹配候选人：直接把整段 JD 文本作为 query，会用 embedding 相似度返回匹配候选人

​
参数

字段类型必填说明
querystring (1-2000 字符)是关键词或 JD 文本片段
top_kinteger (1-50, 默认 10)否返回数量上限

​
返回

{
  "query": "...",
  "total": 42,
  "items": [
    {
      "candidate_id": "uuid",
      "full_name": "张三",
      "current_title": "高级后端工程师",
      "current_company": "字节跳动",
      "current_city": "北京",
      "similarity_score": 0.87,
      "match_summary": "..."
    }
  ]
}

​
示例

curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_search/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params": {"query": "Python 后端 5 年大厂", "top_k": 5}}'

​
常见用法

JD 匹配候选人： 
curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_search/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "query": "招聘高级后端工程师，要求 Python / Go 5 年以上经验，熟悉分布式系统...",
      "top_k": 20
    }
  }'

​
权限

不需要 write 权限。