freehire

项目简介

freehire 直接从公司招聘页面索引数百万个技术职位，对其进行去重，并按技术栈、资历和地点标注。它把托管搜索站点与无需密钥的公共 HTTP API、CLI、MCP 服务器以及用于搜索和申请流程的 Chrome 侧边栏扩展结合在一起。

核心功能

• 从公司 ATS 平台和招聘站点直接抓取职位，链接到原始发布页，并对重复发布去重。提供按地区、工作模式、资历、技能和薪资筛选的全文本搜索。提供面向职位和公司的无需密钥公共 HTTP API。附带 CLI 和 MCP 服务器，让 AI 代理和终端用户无需浏览器即可搜索职位。包含 Chrome 侧边栏扩展，可读取职位页面、按 CV 评分并填写申请表。支持自托管，使用 Go、PostgreSQL（含 pgvector）、Meilisearch、Redis 和 Docker Compose。

适用场景

• 求职者浏览和筛选从公司招聘页面索引的技术职位。开发者和 AI 代理通过公共 API，或使用 CLI 和 MCP 服务器执行职位搜索。团队自托管自己的职位目录和搜索栈。候选人使用 Chrome 扩展评估并申请任意网站上的职位。

快速开始

• 运行 make up 构建并启动完整的 Docker 栈，然后检查 localhost:8080/health 健康端点和 localhost:8080/api/v1/jobs 职位 API。使用已发布的安装脚本安装 CLI；CLI 随附面向 Claude Code 和 MCP 宿主的代理技能。本地开发时，仅用 docker compose up -d db 启动数据库，并在主机上用 make run 运行服务器。

部署与要求

• 完整本地栈使用 Docker Compose，包括 api、web、postgres、meilisearch、redis 和 s3。核心依赖包括 PostgreSQL（含 pgvector）、Meilisearch、Redis 和兼容 S3 的对象存储。服务器启动需要 JWT_SECRET；OAuth 和 LLM 凭据为可选项。迁移会在首次初始化 Postgres 卷时自动应用；修改迁移后需重建卷，或运行 make migrate。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。