YubHub MCP Server
Turn any careers page into a structured job feed. Straight from Claude, Cursor or any MCP client.
______________________________________________________________________
快速开始
你需要一个 YubHub帐户 第一。前往您的 帐户页面 抓住你的 用户ID 和 API密钥 (必填)。
克劳德桌面版
打开您的Claude Desktop配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json
在内部添加此块 "mcpServers":
{
"mcpServers": {
"yubhub": {
"command": "npx",
"args": ["-y", "@houtini/yubhub"],
"env": {
"YUBHUB_USER_ID": "your-user-id",
"YUBHUB_API_KEY": "yh_your_api_key_here"
}
}
}
}重新启动克劳德桌面。就是这样。让克劳德“列出我的YubHub订阅源”,你应该会看到你的数据回来。
光标/VS代码
同样的想法。将配置放入MCP设置中,并指向 npx -y @houtini/yubhub 具有相同的env变量。
它的作用
YubHub关注职业页面。将其指向公司的职位URL,它将发现每个空缺职位,抓取列表,用人工智能(职位标准化、类别标记、薪资提取、公司研究)丰富列表,并将其发布为XML提要。
此MCP服务器使您可以从AI助手内部完全控制该管道。创建订阅源、触发运行、检查工作、查看仪表板、浏览市场统计数据。不需要浏览器选项卡。
管道
Careers page URL
→ Discovery (ATS API / sitemap / crawl)
→ Scraping (page content extraction)
→ Enrichment (AI structuring + company research)
→ XML feed (ready for job boards, aggregators, your own site)支持的ATS平台包括Greenhouse、Lever、Workable、Workday、Oracle HCM、SmartRecruiters、Ashby、Pinpoint、Phenom等。对于具有公共API(Greenhouse、Lever、Workable、Pinpoint)的平台,发现完全跳过了抓取,直接进行了丰富。
工具
涵盖四个领域的21种工具。
饲料管理
| 工具 | 它做什么 |
|---|---|
list_feeds | 获取所有工作信息 |
create_feed | 从职业页面URL创建订阅源 |
get_feed | 馈送详细信息,包括运行历史和作业计数 |
show_feed_dashboard | 用于单个提要的交互式可视化仪表板 |
show_all_feeds_dashboard | 包含所有提要、统计数据和XML链接的概览仪表板 |
trigger_feed_run | 立即开始作业查找 |
update_feed | 更改源名称、标签或源URL |
delete_feed | 删除提要及其所有作业 |
delete_jobs | 清除提要的所有作业(保留提要) |
调度
| 工具 | 它做什么 |
|---|---|
get_feed_schedule | 检查自动运行时间表和下一次运行时间 |
enable_feed_auto_run | 启用自动运行(默认值:每周) |
disable_feed_auto_run | 关闭自动运行 |
乔布斯
| 工具 | 它做什么 |
|---|---|
list_jobs | 列出提要的作业,可选择按状态筛选 |
get_job | 完整的工作详细信息:职位、公司、地点、工资、技能、描述 |
retry_failed_jobs | 将失败的作业重新排队,以便再次尝试 |
市场统计
| 工具 | 它做什么 |
|---|---|
get_stats_overview | 高级数字:总工作岗位、公司、活跃订阅源 |
get_top_companies | 按最近活动的就业人数排名的公司 |
get_categories | 按行业和经验水平细分的工作岗位数量 |
get_top_titles | 按数量划分的最常见职位 |
get_title_trends | 需求增加或减少的标题(2周比较) |
get_work_arrangements | 远程配送、混合配送与现场配送 |
get_experience_levels | 入门级、中级、高级分布 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
YUBHUB_USER_ID | 是 | 您的YubHub用户ID |
YUBHUB_API_KEY | 是 | 您的API密钥 帐户页面 |
YUBHUB_ADMIN_API_URL | 没有 | API终结点(默认为 https://api.yubhub.co) |
示例对话
你: 为梅赛德斯F1职业生涯创建订阅源https://www.mercedesamgf1.com/careers 克劳德: 完成。使用ID创建的订阅源 feed_abc123要我触发跑步吗? 你: 好的,请。 克劳德: 发现开始。我过几分钟再查。 你: 进展如何? 克劳德: 找到47个工作。42个成功富集,5个仍在处理中。这是按类别细分的。..提示: 为了获得最佳效果,请在创建提要时提供示例作业URL。这有助于YubHub识别该网站上职位列表的URL模式,从而显著提高发现准确性。您可以将其作为可选项传递 exampleJobUrl 参数在 create_feed.
发展
git clone https://github.com/houtini-ai/yubhub.git
cd yubhub
npm install
npm run build服务器将TypeScript编译为 dist/ 并作为stdio MCP服务器运行。来源生活在 src/:
src/
├── index.ts # MCP server, tool definitions and handlers
├── api-client.ts # REST client for the YubHub API
├── dashboard-generator.ts # React-based interactive dashboard builder
└── types.ts # TypeScript interfaces在本地运行
YUBHUB_USER_ID=your-id YUBHUB_API_KEY=yh_your_key node dist/index.js或者将MCP客户端指向构建的输出,而不是使用npx。
贡献
欢迎问题和拉取请求。如果您要添加工具或更改行为,请使用真实的YubHub帐户进行测试。
链接
许可证
麻省理工学院——见 许可证 了解详情。
