HiPo Work 技术手册
HiPo Work 是专为 AI 检索设计的结构化人力资源平台。简历发布到平台后由 AI 自动提取结构化数据； 招聘方通过自然语言描述需求，AI 自动匹配最合适的候选人。所有接口面向 AI Agent 设计， 天然支持 MCP、OAuth 2.0 和 Function Calling。
AI Native 接口
所有接口面向 AI Agent 设计，天然支持 MCP、OAuth、Function Calling
OAuth 2.0 认证
支持 OAuth 授权码流程，无需手动配置 API Key，30 天自动续期
语义匹配引擎
基于 pgvector 语义检索，理解自然语言需求，不依赖关键词
快速开始
1. 注册/登录
通过 MCP 工具注册或登录，API Key 会自动发送到你的邮箱：
# 发送验证码到邮箱
send_verification_code(email="your@email.com")
# 注册/登录（API Key 会发送到邮箱，响应中也会返回完整 Key）
register_or_login(email="your@email.com", code="123456", role="candidate")
2. 选择角色
👤 求职者（candidate）
- • 上传简历（import_resume）
- • 填写个人档案
- • 接收岗位邀请
🏢 招聘方（employer）
- • 发布招聘岗位（publish_job）
- • 搜索候选人（match_candidates）
- • 市场分析（market_analysis）
OAuth 自动接入（推荐）
配置一次 MCP 客户端地址，首次使用时会自动弹出浏览器完成授权，无需手动配置 API Key。
配置步骤
- 在 MCP 客户端配置文件中添加 HiPo Work 服务器地址
- 首次调用工具时，浏览器会自动弹出授权页面
- 输入邮箱 → 获取验证码 → 输入验证码 → 完成授权
- 之后自动使用，无需再次配置
Claude Desktop 配置
{
"mcpServers": {
"hipo": {
"url": "https://hipowork.com/mcp"
}
}
}
Hermes Agent 配置
# ~/.hermes/config.yaml
mcp_servers:
hipo:
url: "https://hipowork.com/mcp"
API Key 手动接入
如果不支持 OAuth，可以通过 API Key header 手动认证。API Key 30 天有效，过期后需重新获取。
HTTP Header 方式
X-API-Key: fb_live_your_api_key_here
Claude Desktop 配置
{
"mcpServers": {
"hipo": {
"url": "https://hipowork.com/mcp",
"headers": { "X-API-Key": "fb_live_xxx" }
}
}
}
⚠️ 注意
API Key 30 天过期。过期后需要重新调用 register_or_login 获取新 Key。 建议使用 OAuth 方式（不需要手动管理 Key）。
工具参考
HiPo Work 提供以下 MCP 工具，供 Agent 调用：
| 工具名 | 说明 | 认证 |
|---|---|---|
| send_verification_code | 发送邮箱验证码（注册/登录前调用） | 公开 |
| register_or_login | 邮箱验证码注册/登录，返回 user_id | 公开 |
| publish_job | 发布招聘岗位（结构化条件） | employer |
| match_candidates | 匹配候选人（含评分明细+工作经历） | employer |
| match_job_requirement | 按岗位 ID 自动匹配候选人 | employer |
| search_candidates | 自然语言搜索候选人 | employer |
| get_stats | 平台统计数据 | employer |
| market_analysis | 技能/行业人才供需分析 | employer |
| import_resume | 导入简历（Agent 解析后传入结构化数据） | candidate |
主流 Agent 接入
Claude Desktop
编辑 claude_desktop_config.json：
{
"mcpServers": {
"hipo": {
"url": "https://hipowork.com/mcp"
}
}
}
首次调用工具时，Claude Desktop 会自动打开浏览器完成 OAuth 授权。
Hermes Agent
编辑 ~/.hermes/config.yaml：
# ~/.hermes/config.yaml
mcp_servers:
hipo:
url: "https://hipowork.com/mcp"
VS Code / Cursor
在设置中添加 MCP 服务器：
{
"mcp": {
"servers": {
"hipo": {
"url": "https://hipowork.com/mcp"
}
}
}
}