// 命令列上的 freehire
從終端機搜尋
並追蹤職缺。
freehire 是一套輕量 CLI，也提供 MCP 伺服器 ，兩者使用與本站相同的職缺 API。只要一把 API 金鑰 ，就能讓 AI 代理程式 或腳本搜尋及查看職缺、追蹤應徵進度、處理您的 應徵郵件 ，並針對職缺客製化履歷，全程不必使用瀏覽器。（您仍需在雇主網站送出申請，CLI 會記錄您的應徵狀態。）
# 安裝，不需要 Go curl -fsSL https://freehire.me/install.sh | sh # 驗證一次即可（金鑰取自 /my/api-keys） freehire auth login --token fhk_… # 先探索市場，再搜尋職缺 freehire facets freehire search "golang" --remote --region eu
// 指令
探索職缺
- freehire facets
- 列出每個篩選條件目前可用的值與數量，供您正確設定篩選。
- freehire market-fit --skills go,react
- 分析您的技能涵蓋多少即時職缺需求，以及還有哪些缺口。
- freehire search <query>
- 列出符合條件的職缺（可加上 --remote、--region、--company）。
- freehire job <slug>
- 顯示職缺的完整內容。
- freehire company <slug>
- 顯示公司資料及其目前開放的職缺。
追蹤應徵與筆記
- freehire apply <slug>
- 將職缺標記為已應徵。
- freehire save <slug>
- 收藏職缺（使用 unsave 可取消收藏）。
- freehire stage <slug> <stage>
- 設定應徵階段。
- freehire note <slug> <text>
- 附加自由格式的文字筆記。
- freehire my --filter applied
- 查看您追蹤的職缺（all|viewed|saved|applied）。
- freehire profile
- 查看已儲存的搜尋偏好，包括技能、資歷與地區。
應徵郵件
- freehire inbox push --file mail.json
- 上傳由您自己的郵件用戶端取得的批次資料（以 Message-ID 辨識，因此重新同步只會更新，不會重複建立）。
- freehire inbox list --unclassified --body
- 顯示代理程式的待處理佇列：內嵌郵件內文的未分類郵件，且不會將任何郵件標為已讀。
- freehire inbox triage <id> <signal>
- 記錄郵件的類型；判定明確時，系統會推進對應的應徵狀態。
- freehire inbox list --link suggested
- 列出等待您確認的建議關聯，可使用 inbox confirm 或 inbox reject。
- freehire inbox list --link unlinked
- 列出尚未連結應徵記錄的郵件；inbox application 可從郵件建立一筆應徵記錄。
貢獻與審核
- freehire contribute <url>
- 提交職缺連結；若是 freehire 尚未追蹤的職缺平台，您可獲得一點點數。
- freehire contributions
- 查看您貢獻的職缺平台及其處理狀態。
- freehire submissions
- 查看您提交的職缺；審核人員也可在此處理待審核、核准與拒絕。
- freehire jobs add | edit <slug>
- 建立或編輯職缺刊登內容（限審核人員）。
請先執行 freehire facets ，它會列出所有篩選條件目前可用的值，讓 search 與 market-fit 使用真實值，而不是猜測。您收藏、應徵或變更階段的所有職缺，都會顯示在 求職追蹤 看板上。 stage 僅接受指定值： preparing → applied → screening → responded → interview → offer → accepted，另外還有 rejected / withdrawn。
針對職缺客製化履歷
完成匹配分析後，可將 履歷重新聚焦 至特定職缺，所有內容都以您的真實經歷為依據，絕不捏造，最後再匯出適合 ATS 的 PDF。 cv context 是確保內容誠實的關鍵：它會把職缺需求分成「您的經歷已有但履歷未凸顯」與「目前經歷尚未涵蓋」兩類，前者可重新表述，後者應詢問您而非自行杜撰，讓編輯履歷的代理程式清楚知道如何處理。
freehire cv context <id> # 要重新聚焦的匹配分析 freehire cv get <id> # JSON 格式的履歷文件 freehire cv edit <id> --set … # 依路徑修改一處（批次修改使用 --ops） freehire cv render <id> --out cv.pdf
// mcp
同一把金鑰，適用任何 AI 主機
freehire-mcp 透過 Model Context Protocol 提供相同的搜尋、市場適配與追蹤工具，因此 Claude Desktop、Claude Code 或任何 MCP 主機都能直接操作 freehire。它透過 npx執行，不需全域安裝。
它與 CLI 共用登入資料：如果您已執行 freehire auth login，即可省略 env，系統會改為讀取 ~/.freehire/creds.json。
{
"mcpServers": {
"freehire": {
"command": "npx",
"args": ["-y", "freehire-mcp"],
"env": { "FREEHIRE_TOKEN": "fhk_…" }
}
}
}// 供 AI 代理程式使用
五個技能，各自對應一項任務
每個 代理程式技能 都依任務命名，而不是依工具命名，因此主機只會載入問題所需的功能，不必載入整套介面。您可以將技能放入 Claude Code（或相容工具）的技能目錄，也可以安裝外掛，同時取得斜線指令。
/plugin marketplace add strelov1/freehire-cli /plugin install freehire@freehire-cli
每個指令都可加上 --json 以取得原始 API 資料；結果輸出到 stdout，錯誤輸出到 stderr，失敗時會傳回非零結束碼。相同的端點也列在 API 參考文件。
- /job-search freehire-job-search
- 讀取已儲存的個人資料，以 facets 的實際值設定所有篩選條件，搜尋並建立候選清單。
- /track-applications freehire-track-applications
- 查看每筆應徵的進度、更新階段，並記錄從未收到回覆的應徵。
- /market-fit freehire-market-fit
- 依即時職缺需求評估技能組合，並量化每一項缺口。
- /tailor-cv freehire-tailor-cv
- 針對單一職缺重新聚焦履歷；每項陳述都有依據，絕不捏造。
- /triage-inbox freehire-mail-triage
- 推送郵件批次、判斷每封郵件，並清空兩個關聯處理佇列。
// 審核人員
具備 moderator 角色即可建立職缺刊登內容：
freehire jobs add --url <url> --title "Senior Go Developer" --company Acme freehire jobs edit <slug> --title "Staff Go Developer"
免費且開放原始碼，沒有追蹤，也不會將您綁定在平台上。您可以在 GitHub 查看 CLI ↗ 以及 MCP 伺服器 ↗ 的所有原始碼。