基本能力
产品定位
Google Jobs MCP Server 是一个通过 SerpAPI 集成提供 Google Jobs 搜索功能的 MCP 服务实现。
核心功能
- 多语言支持:支持英语、中文、日语和韩语,具有自动语言检测和回退功能。
- 灵活的搜索选项:
- 职位标题和关键词
- 带半径过滤的位置
- 雇佣类型(全职、兼职等)
- 薪资范围过滤
- 发布日期过滤
- 结果排序
- 智能错误处理:
- 全面的输入验证
- 有用的错误消息和建议
- 自动搜索优化建议
- 速率限制处理
- 丰富的职位详情:
- 详细的职位信息格式化
- 公司福利和亮点
- 可用的薪资信息
- 直接申请链接
- 职位发布时间戳
- 高级功能:
- 分页支持
- 多种排序选项
- 地理半径搜索
- 雇佣类型过滤
适用场景
- 需要获取 Google Jobs 职位信息的应用或服务。
- 需要多语言支持的职位搜索功能。
- 需要灵活搜索参数和高级过滤功能的场景。
工具列表
- SerpAPI:用于获取 Google Jobs 数据的 API。
- Node.js:运行服务的 JavaScript 运行时。
- TypeScript:用于开发服务的编程语言。
常见问题解答
- API 密钥问题:
- 验证配置中的密钥
- 检查 SERP API 仪表板中的密钥状态
- 确认密钥有剩余配额
- 搜索问题:
- 验证搜索参数格式
- 检查网络连接
- 验证国家/语言代码支持
使用教程
使用依赖
- 获取 SERP API 密钥:
- 访问 SERP API 网站 并创建账户
- 注册后,转到仪表板
- 找到 "API Key" 部分
- 复制您的 API 密钥
- 新用户可获得 100 次免费 API 调用
安装教程
- 通过 Smithery 安装:
bash
npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude - 手动安装:
```bash
使用 npm
npm i @chanmeng666/google-jobs-server
或
npm install @chanmeng666/google-jobs-server
使用 yarn
yarn add @chanmeng666/google-jobs-server
使用 pnpm
pnpm add @chanmeng666/google-jobs-server
```
调试方式
- 安装依赖:
bash
npm install - 配置环境:
修改claude_desktop_config.json
文件,内容如下(根据您的系统调整路径):
json
{
"google-jobs": {
"command": "D:\\Program\\nvm\\node.exe",
"args": ["D:\\github_repository\\path_to\\dist\\index.js"],
"env": {
"SERP_API_KEY": "your-api-key"
}
}
} - 构建服务器:
bash
npm run build - 启动服务器:
bash
npm start - 开发模式运行:
bash
npm run dev - 运行类型检查:
bash
npm run typecheck