SuperAPI AI 工具集

hh-mcp

智能体与模型

查看项目

更新于 10-15 22:17

技能介绍

用途:通过 MCP 协议把 hh.ru(HeadHunter)API 接入 AI 助手,在对话中处理职位、回应与简历。

主要能力:服务器由 hh-mcp-ru 包安装,包含 133 个 hh.ru API 方法,其中读取 93 个、写入 31 个、不可逆操作 9 个;方法目录依据官方规范 api.hh.ru/openapi/specification/public 整理。提供三个工具:hh_search_methods 用自然语言搜索方法,hh_describe_method 查看参数、分页与访问级别,hh_call_method 执行调用。读取类调用直接执行,写入与不可逆操作需要确认。

使用方式:安装命令为 uvx hh-mcp-ru。客户端(Claude Desktop、Cursor、Claude Code)配置中设置 mcpServers 的 hh 项,command 为 uvx,args 为 --from hh-mcp-ru hh-mcp,env 中填 HH_TOKEN 与 HH_APP_NAME。令牌获取:在 dev.hh.ru 的“我的应用”中创建应用并复制 access token。HH_APP_NAME 必须填写,因为 hh 会拒绝缺少明确 User-Agent 的请求,这也是出现不明 400 错误的首要原因。

适用场景:导出某段时间内的自有职位与回应并汇总成表格;按地区和职业查找竞争对手的职位;发布前查看某角色的薪资统计;先向人展示候选人列表,再用模板回复候选人。

限制:写入与不可逆操作需人工确认;资料明确提醒,未经人工明确同意不要发布或修改职位,因为这涉及雇主的资金与声誉。其余功能、收费与平台支持情况暂未提供。