Careerjet MCPv2

🚀 Careerjet Job Search MCP Server

本項目是一個使用 Careerjet API 提供求職功能的 MCP（Model Context Protocol）服務器。它能幫助用戶通過關鍵詞和地點搜索工作，還支持高級過濾和多語言。

✨ 主要特性

• 求職功能：可通過關鍵詞和地點進行求職搜索。
• 高級過濾：支持按合同類型、工作時長、薪資排序等進行篩選。
• 多語言支持：支持 50 多個國家和語言。
• MCP 兼容：便於與 AI 助手集成。

📦 安裝指南

要求

• Python 3.11 及以上版本
• pip
• 有效的 Careerjet API 密鑰

步驟

1. 安裝依賴項：

pip install -r requirements.txt

2. 配置 API 密鑰：

   • 默認 API 密鑰：371d48447450886ce16b718533cca6f2
   • 若要獲取自己的 API 密鑰，請訪問：Careerjet Partners

3. 啟動 MCP 服務器：

python server.py

使用 Docker 安裝

# 構建 Docker 鏡像
docker build -t careerjet-mcp .

# 運行容器
docker run -it careerjet-mcp

💻 使用示例

MCP 工具

1. search_jobs_tool

求職功能。

參數：

• keywords（必填）：要搜索的關鍵詞
• location（必填）：工作地點
• locale：語言/國家代碼（默認：en_US）
• affid：Careerjet API 密鑰（默認：371d48447450886ce16b718533cca6f2）
• sort：排序類型（relevance, date, salary）
• pagesize：每頁結果數量
• contracttype：合同類型（p=永久合同, c=合同工, t=臨時工）
• contractperiod：工作時長（f=全職, p=兼職）

示例：

# 在倫敦搜索 Python 開發人員的工作
result = search_jobs_tool(
    keywords="python developer",
    location="London",
    locale="en_GB",
    affid="371d48447450886ce16b718533cca6f2",
    sort="salary",
    pagesize=20
)

2. get_job_details_tool

獲取工作詳情（基本實現）。

支持的地區

• en_US - 美國
• en_GB - 英國
• de_DE - 德國
• fr_FR - 法國
• es_ES - 西班牙
• it_IT - 意大利
• tr_TR - 土耳其
• 還有更多...

📚 詳細文檔

Smithery.yaml

MCP 客戶端可使用 smithery.yaml 文件進行配置：

startCommand:
  type: stdio
  configSchema:
    type: object
    properties:
      affid:
        type: string
        description: "Careerjet 聯盟 ID"
        default: "371d48447450886ce16b718533cca6f2"
      locale:
        type: string
        description: "默認語言代碼"
        default: "en_US"

聯盟 ID

使用 Careerjet API 需要一個聯盟 ID。若要創建免費賬戶，請按以下步驟操作：

1. 訪問 Careerjet Partners 頁面。
2. 創建合作伙伴賬戶。
3. 使用獲取到的聯盟 ID。

默認 API 密鑰：371d48447450886ce16b718533cca6f2

🔧 技術細節

API 限制

• Careerjet API 有使用頻率限制。
• 若需大量使用，請與 Careerjet 聯繫。
• 可能會應用速率限制。

項目結構

├── app.py              # 主要業務邏輯
├── server.py           # MCP 服務器實現
├── requirements.txt    # Python 依賴項
├── smithery.yaml      # MCP 配置
├── Dockerfile         # Docker 配置
├── test_samsun.py     # 測試文件
└── README.md          # 本文件

測試

# 針對 Samsun 進行測試
python test_samsun.py

# 簡單測試
python -c "from app import search_jobs; print(search_jobs('python', 'London'))"

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻指南

1. Fork 本倉庫。
2. 創建功能分支。
3. 提交更改。
4. 發送 Pull 請求。

📞 聯繫信息

本項目在 GitHub 上進行開發。

📜 版本歷史

• v2.0：更新了 API 密鑰並進行了改進。
• v1.0：初始版本。