{"_id":"@chanmeng666/google-jobs-server","name":"@chanmeng666/google-jobs-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@chanmeng666/google-jobs-server","version":"1.0.0","description":"MCP server for Google Jobs search via Serp API","type":"module","engines":{"node":">=16"},"bin":{"google-jobs-server":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","watch":"tsc --watch","typecheck":"tsc --noEmit"},"dependencies":{"@modelcontextprotocol/sdk":"1.0.4","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^20.10.0","@types/node-fetch":"^2.6.11","shx":"^0.3.4","typescript":"^5.6.2"},"_id":"@chanmeng666/google-jobs-server@1.0.0","gitHead":"faa5c645a60292dc52f0e32de1fb013131884f53","_nodeVersion":"20.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-CIl4NhfAIseYvXdzhY8V7cdBEjwWHHlkDJcguEVO3AklkxLeMnvWXQJhX4tZlmaC/eaTc5qD3hC9D2C3+VbUYA==","shasum":"e258ea116adb2021de247c255f3029bfcf31c3bd","tarball":"https://registry.npmjs.org/@chanmeng666/google-jobs-server/-/google-jobs-server-1.0.0.tgz","fileCount":4,"unpackedSize":22105,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCICSDCTyqX0fKYYkfbaOtfaX66hzI3h3xM0wP7lnR4OKFAiEAgnskN8cMqqT6y7qL+ahqXDO4cbrh6ovC1wBlSpNsFLk="}]},"_npmUser":{"name":"chanmeng666","email":"tomoko230311@outlook.com"},"directories":{},"maintainers":[{"name":"chanmeng666","email":"tomoko230311@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-jobs-server_1.0.0_1735816493986_0.44545015086947193"},"_hasShrinkwrap":false}},"time":{"created":"2025-01-02T11:14:53.826Z","1.0.0":"2025-01-02T11:14:54.159Z","modified":"2025-01-02T11:14:54.495Z"},"maintainers":[{"name":"chanmeng666","email":"tomoko230311@outlook.com"}],"description":"MCP server for Google Jobs search via Serp API","readme":"
\r\n


Google Jobs MCP Server

\r\n \r\n \r\n \r\n \r\n
\r\n\r\n
\r\n\r\nA Model Context Protocol (MCP) server implementation that provides Google Jobs search capabilities via SerpAPI integration. Features multi-language support, flexible search parameters, and smart error handling.\r\n\r\n\r\nhttps://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72\r\n\r\n![屏幕截图 2024-12-31 183813](https://github.com/user-attachments/assets/fd02f916-7ba0-4d92-8970-79ccecdb1115)\r\n\r\n![屏幕截图 2024-12-31 183754](https://github.com/user-attachments/assets/22f497f5-381e-40d1-b082-d13d13239677)\r\n\r\n![屏幕截图 2024-12-31 180734](https://github.com/user-attachments/assets/19f74219-5059-4c49-95e9-3a1741d866d2)\r\n\r\n![屏幕截图 2024-12-31 182106](https://github.com/user-attachments/assets/5e88ec38-66cd-4f02-95b3-118007736dbd)\r\n\r\n\r\n# ✨ Features\r\n\r\n### 🌍 Multi-Language Support\r\nFull localization support for English, Chinese, Japanese and Korean with automatic language detection and fallback.\r\n\r\n### 🔍 Flexible Search Options\r\nComprehensive search parameters including:\r\n- Job title and keywords\r\n- Location with radius filtering\r\n- Employment type (full-time, part-time, etc.)\r\n- Salary range filters\r\n- Post date filtering\r\n- Results sorting\r\n\r\n### 💡 Smart Error Handling\r\n- Comprehensive input validation\r\n- Helpful error messages and suggestions\r\n- Automatic search refinement suggestions\r\n- Rate limit handling\r\n\r\n### 📊 Rich Job Details\r\n- Detailed job information formatting\r\n- Company benefits and highlights\r\n- Salary information when available\r\n- Direct application links\r\n- Job posting timestamps\r\n\r\n### 🔄 Advanced Features\r\n- Pagination support\r\n- Multiple sorting options\r\n- Geographic radius search\r\n- Employment type filtering\r\n\r\n# 🔑 SERP API Setup Guide\r\n\r\nBefore getting started, you'll need to obtain a SERP API key:\r\n\r\n1. Visit [SERP API website](https://serpapi.com/) and create an account\r\n\r\n2. After registration, go to your Dashboard:\r\n - Locate the \"API Key\" section\r\n - Copy your API key\r\n - New users get 100 free API calls\r\n\r\n3. API Usage Details:\r\n - Free tier: 100 searches per month\r\n - Paid plans start at $50/month for 5000 searches\r\n - Billing based on successful API calls\r\n - Multiple payment methods: Credit Card, PayPal, etc.\r\n\r\n4. Usage Limits:\r\n - Request Rate: 2 requests/second\r\n - IP Restrictions: None\r\n - Concurrent Requests: 5\r\n - Response Cache Time: 1 hour\r\n\r\n# 👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM\r\n\r\nClick to view my configuration solution 👉 https://github.com/modelcontextprotocol/servers/issues/76\r\n\r\n# 🚀 Quick Start\r\n\r\n1. Install dependencies:\r\n```bash\r\nnpm install\r\n```\r\n\r\n2. Configure environment:\r\n```json\r\n{\r\n \"google-jobs\": {\r\n \"command\": \"D:\\\\Program\\\\nvm\\\\node.exe\",\r\n \"args\": [\"D:\\\\github_repository\\\\path_to\\\\dist\\\\index.js\"],\r\n \"env\": {\r\n \"SERP_API_KEY\": \"your-api-key\"\r\n }\r\n }\r\n}\r\n```\r\n\r\n3. Build the server:\r\n```bash\r\nnpm run build\r\n```\r\n\r\n4. Start the server:\r\n```bash\r\nnpm start\r\n```\r\n\r\n## Troubleshooting\r\n\r\n1. API Key Issues:\r\n- Verify key in configuration\r\n- Check key status in SERP API dashboard\r\n- Confirm key has remaining quota\r\n\r\n2. Search Issues:\r\n- Validate search parameters format\r\n- Check network connectivity\r\n- Verify country/language code support\r\n\r\n# 💻 Tech Stack\r\n\r\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white)\r\n![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge&logo=node.js&logoColor=white)\r\n![MCP](https://img.shields.io/badge/MCP-SDK-blue?style=for-the-badge)\r\n\r\n# 📖 API Documentation\r\n\r\nThe server implements the Model Context Protocol and exposes a job search tool with the following parameters:\r\n\r\n- `query`: Search query string (required)\r\n- `location`: Job location (optional)\r\n- `posted_age`: Post date filter (optional)\r\n- `employment_type`: Job type filter (optional)\r\n- `salary`: Salary range filter (optional)\r\n- `radius`: Geographic search radius (optional)\r\n- `hl`: Language code (optional)\r\n- `page`: Pagination number (optional)\r\n- `sort_by`: Sort order (optional)\r\n\r\n# 🔧 Development\r\n\r\n```bash\r\n# Run in development mode\r\nnpm run dev\r\n\r\n# Run type checking\r\nnpm run typecheck\r\n\r\n# Build for production\r\nnpm run build\r\n```\r\n\r\n# 📝 License\r\n\r\nThis project is [MIT licensed](./LICENSE).\r\n\r\n# 🙋‍♀ Author\r\n\r\nCreated and maintained by [Chan Meng](https://chanmeng.live/).\r\n[![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=normal&logo=github&logoColor=white)](https://github.com/ChanMeng666)\r\n[![LinkedIn](https://img.shields.io/badge/linkedin-%230077B5.svg?style=normal&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/chanmeng666/)\r\n\r\n","readmeFilename":"README.md"}