✨ 特性

🌍 多语言支持

完全本地化支持英语、中文、日语和韩语，具有自动语言检测和回退功能。

🔍 灵活的搜索选项

全面的搜索参数，包括：

• 职位名称和关键词
• 带有半径过滤的位置
• 雇佣类型（全职、兼职等）
• 薪资范围过滤器
• 发布日期过滤
• 结果排序

💡 智能错误处理

• 全面的输入验证
• 有用的错误消息和建议
• 自动搜索优化建议
• 速率限制处理

📊 丰富的职位详情

• 详细的职位信息格式
• 公司福利和亮点
• 可用的薪资信息
• 直接申请链接
• 职位发布时间戳

🔄 高级功能

• 分页支持
• 多种排序选项
• 地理半径搜索
• 雇佣类型过滤

🔑 SERP API 设置指南

开始之前，您需要获取一个 SERP API 密钥：

1. 访问 SERP API 网站 并创建一个帐户

2. 注册后，转到您的仪表板：

   • 找到“API 密钥”部分
   • 复制您的 API 密钥
   • 新用户可获得 100 次免费 API 调用

3. API 使用详情：

   • 免费套餐：每月 100 次搜索
   • 付费计划起价为每月 50 美元，可进行 5000 次搜索
   • 根据成功的 API 调用收费
   • 多种付款方式：信用卡、PayPal 等

4. 使用限制：

   • 请求速率：2 个请求/秒
   • IP 限制：无
   • 并发请求：5
   • 响应缓存时间：1 小时

👩‍🔧 解决 NVM/NPM 导致的 MCP 服务器连接问题

点击查看我的配置解决方案 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 快速开始

1. 安装依赖项：

npm install

2. 配置环境： 使用以下内容修改您的 claude_desktop_config.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"
    }
  }
}

3. 构建服务器：

npm run build

4. 启动服务器：

npm start

故障排除

1. API 密钥问题：

• 验证配置中的密钥
• 检查 SERP API 仪表板中的密钥状态
• 确认密钥有剩余配额

2. 搜索问题：

• 验证搜索参数格式
• 检查网络连接
• 验证国家/地区代码支持

📦 安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Google Jobs：

npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude

手动安装

<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-jobs-server">@chanmeng666/google-jobs-server</a>

# 使用 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

💻 技术栈

📖 API 文档

该服务器实现了模型上下文协议，并公开了一个具有以下参数的职位搜索工具：

• query: 搜索查询字符串（必需）
• location: 工作地点（可选）
• posted_age: 发布日期过滤器（可选）
• employment_type: 工作类型过滤器（可选）
• salary: 薪资范围过滤器（可选）
• radius: 地理搜索半径（可选）
• hl: 语言代码（可选）
• page: 分页号（可选）
• sort_by: 排序方式（可选）

🔧 开发

# 在开发模式下运行
npm run dev

# 运行类型检查
npm run typecheck

# 构建用于生产
npm run build

📝 许可证

本项目已获得 MIT 许可。

🙋‍♀ 作者

由 Chan Meng 创建和维护。