# JobAI

MCP: https://jobai.hk/api/v1/mcp
OAuth discovery:
https://jobai.hk/.well-known/oauth-protected-resource
https://jobai.hk/.well-known/oauth-authorization-server
OpenAPI: https://jobai.hk/openapi.json
Guide: https://jobai.hk/agents

## 廣東話
JobAI 係香港求職平台，幫你搜尋公開職位、準備履歷同求職信，以及查看申請進度。
MCP 連接器貼入以下網址，經 OAuth 登入 JobAI，再核對同意頁嘅權限。支援 authorization code + PKCE S256；代理可由以下兩個 discovery 網址取得授權資料。唔好喺對話貼密碼或 token。
冇 MCP 都可以用公開 HTTP API，唔使登入。GET /api/v1/public/jobs?q=engineer&page=1 搜尋職位；GET /api/v1/public/insights 睇公開薪酬同刊登統計。每頁 20 個結果；每個 IP 每 5 分鐘最多 150 次，遇到 429 請稍後再試。參數同回應見 OpenAPI。
代理只可協助搜尋同準備。更改資料或準備申請要由用戶喺 JobAI 確認；送出申請一定由用戶親自喺 JobAI 撳，唔可以由代理代撳。

## English
JobAI helps Hong Kong job seekers search public vacancies, prepare CVs and cover letters, and track applications.
Paste the MCP URL into your connector, sign in to JobAI with OAuth, and review the consent screen. Authorization code with PKCE S256 is supported; agents can discover authorization details at the two discovery URLs below. Never paste passwords or tokens into chat.
Without MCP, use the public HTTP API without signing in. GET /api/v1/public/jobs?q=engineer&page=1 searches jobs; GET /api/v1/public/insights returns public salary and posting statistics. Pages contain up to 20 jobs. The limit is 150 requests per IP per 5 minutes; wait before retrying a 429 response. See OpenAPI for parameters and responses.
Agents may help search and prepare. Users must confirm data changes and application preparation in JobAI. Only the user may click to submit an application in JobAI; agents must not click on their behalf.

## 简体中文
JobAI 帮助香港求职者搜索公开职位、准备简历和求职信，以及查看申请进度。
在 MCP 连接器中填入以下网址，通过 OAuth 登录 JobAI 并核对授权页面。支持 authorization code + PKCE S256；代理可通过以下两个 discovery 网址获取授权信息。不要在对话中粘贴密码或 token。
没有 MCP 也可以使用公开 HTTP API，无须登录。GET /api/v1/public/jobs?q=engineer&page=1 搜索职位；GET /api/v1/public/insights 查看公开薪酬和刊登统计。每页最多 20 个结果；每个 IP 每 5 分钟最多 150 次，遇到 429 请稍后重试。参数和响应见 OpenAPI。
代理只可协助搜索和准备。修改资料或准备申请须由用户在 JobAI 确认；提交申请必须由用户亲自在 JobAI 点击，代理不可代为点击。