shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程无需 API Key

liepin-jobs

猎聘求职工具 — 在猎聘上搜索职位、投递简历、查看/编辑简历。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

猎聘求职工具 (liepin-jobs)

在猎聘平台上搜索职位、投递简历、查看和编辑简历。基于猎聘官方 MCP Server，零外部依赖。

脚本位置: 本 skill 目录下的 liepin_mcp.py

!! 首次使用必读：获取 Token

使用此工具前，用户必须先获取猎聘的两个认证 Token。没有 Token 无法使用任何功能。

获取步骤

  1. 打开猎聘 MCP 配置页: 引导用户在浏览器访问 https://www.liepin.com/mcp/server
  2. 登录猎聘账号: 用户需要有猎聘账号并登录
  3. 获取两个 Token:
    • Gateway Token: 格式为 mcp_gateway_token_xxxx（页面上的 Authorization Bearer 值）
    • User Token: 格式为 liepin_user_token_xxxx（页面上的 x-user-token 值）
  4. 配置 Token: 运行 setup 命令保存 token
python3 "<skill_dir>/liepin_mcp.py" setup
# 按提示输入两个 token

或通过环境变量配置

export LIEPIN_GATEWAY_TOKEN="mcp_gateway_token_xxxx"
export LIEPIN_USER_TOKEN="liepin_user_token_xxxx"

Token 过期

  • Token 有效期 90 天
  • 过期后会收到认证错误，需引导用户重新访问上述页面获取新 Token
  • 重新生成 Token 会立即使旧 Token 失效

如果用户还没有配置 Token，必须先引导他们完成上述步骤，再执行任何操作。

命令速查

SCRIPT="<skill_dir>/liepin_mcp.py"

# 搜索职位
python3 "$SCRIPT" search-job --jobName "AI产品经理" --address "上海"
python3 "$SCRIPT" search-job --jobName "前端开发" --address "北京" --salary "30-50k"
python3 "$SCRIPT" search-job --jobName "数据分析" --companyName "字节跳动" --json

# 投递职位（需要先搜索获取 jobId 和 jobKind）
python3 "$SCRIPT" apply-job --jobId "JOB_ID" --jobKind "JOB_KIND"

# 查看简历
python3 "$SCRIPT" my-resume
python3 "$SCRIPT" my-resume --json

# 更新简历
python3 "$SCRIPT" update-resume --module basic --data '{"name": "张三", "phone": "138xxx"}'
python3 "$SCRIPT" update-resume --module experience --data '{"company": "xxx", "title": "产品经理"}'
python3 "$SCRIPT" update-resume --module expectations --data '{"salary": "30-50k", "city": "上海"}'
python3 "$SCRIPT" update-resume --module self-assessment --data '{"content": "5年产品经验..."}'

# 列出所有可用工具（查看猎聘最新 API 能力）
python3 "$SCRIPT" list-tools
python3 "$SCRIPT" list-tools --json

# 通用调用（适用于猎聘新增的工具）
python3 "$SCRIPT" call <tool-name> -a '{"key": "value"}' --json

典型求职流程

当用户说"帮我找工作"、"搜一下猎聘上的XX职位"时，按以下流程执行：

  1. 检查 Token → 如果未配置，先引导用户获取（见上方"首次使用必读"）
  2. 查看简历 (my-resume) → 确认简历信息完整，提醒用户补充缺失项
  3. 搜索职位 (search-job) → 根据用户意向搜索，用表格展示结果
  4. 分析匹配度 → 结合简历和职位要求，帮用户筛选最合适的
  5. 投递职位 (apply-job) → 必须先向用户展示职位详情并获得明确确认后再投递

搜索参数

| 参数 | 说明 | 示例 | |------|------|------| | --jobName | 职位名称关键词 | "AI产品经理"、"前端开发"、"数据分析师" | | --address | 工作地点 | "上海"、"北京"、"深圳"、"杭州" | | --salary | 薪资范围 | "20-30k"、"30-50k" | | --education | 学历要求 | 本科、硕士 | | --experience | 工作经验 | "3-5年"、"5-10年" | | --companyType | 公司类型 | 外企、国企、民企 | | --companyName | 公司名称 | "字节跳动"、"阿里巴巴"、"腾讯" |

简历模块

| 模块 | 说明 | |------|------| | basic | 基本信息（姓名、手机、邮箱等） | | experience | 工作/项目经历 | | expectations | 求职期望（期望薪资、城市、岗位等） | | self-assessment | 自我评价 |

输出格式

  • 默认输出人类可读格式
  • 加 --json 输出原始 JSON，方便程序化处理
  • 搜索结果建议以表格形式展示给用户，包含：职位名、公司、薪资、地点、经验要求

注意事项

  • 投递不可撤回: 执行 apply-job 前必须获得用户明确确认
  • 频率限制: 所有操作共享 60 次/分钟，避免短时间批量调用
  • Token 安全: 不要在日志或对话中暴露完整的 Token 内容
  • 数据来源: 所有数据来自猎聘平台，实时获取

错误处理

| 错误 | 原因 | 解决方案 | |------|------|---------| | "未配置 token" | 没有运行 setup | 引导用户获取 Token 并运行 setup | | HTTP 401 | Token 过期或无效 | 引导用户重新访问配置页获取新 Token | | HTTP 429 | 频率限制 | 等待 1 分钟后重试 | | 网络超时 | 网络问题 | 重试一次 |