mcpField
T
Taiwan Jobs 台灣求職

Taiwan Jobs 台灣求職

ローカル
github.comビジネス・マーケティング01 週間前に更新

Taiwan Jobs 台灣求職 について

Taiwan Jobs 台灣求職は、中国語または英語で台湾の求人を探す求職者向けの読み取り専用MCPサーバーです。現地の求人サイトと一部企業の採用ページを横断し、求人、企業、給与の情報を提供します。

主な機能

  1. 01104、Yourator、Greenhouse、Lever、Workdayを検索
  2. 02勤務地、給与、経験年数などで絞り込み
  3. 03求人と企業の詳細を取得
  4. 04104の応募者と給与の統計を表示
  5. 05情報源の稼働状況を確認

活用シーン

  1. 01希望地域と給与条件でリモート求人を検索
  2. 02求人サイトと企業採用ページの募集を比較
  3. 03104の求人で応募者の属性を確認
  4. 04該当する104求人から給与水準を推定

MCP 対応

MCPクライアントに、`search_jobs`、`get_job`、`get_company`、`salary_overview`、`sources`、`lookup_code`の6つの読み取り専用ツールを提供します。アカウントやAPIキーは不要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"hsuanc0921-tw-jobs": {
"command": "uvx",
"args": [
"tw-jobs-mcp"
]
}
}
}
起動コマンドuvx tw-jobs-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypitw-jobs-mcp1.2.1

ツール

6

掲載時のツール一覧 · 1 週間前に更新

パラメーター型必須説明
areaarrayいいえ
pageintegerいいえ
sortenumいいえrelevance | newest | salary
jobcatarrayいいえ
sourceenumいいえ104 | yourator | boards | workday | all
keywordstringいいえ
job_typeenumいいえ全職 | 兼職 | 高階 | 派遣
my_yearsintegerいいえ
new_onlybooleanいいえ
per_pageintegerいいえ
educationenumいいえ高中職 | 專科 | 大學 | 碩士 | 博士
keyword_enstringいいえ
salary_minintegerいいえ
remote_onlybooleanいいえ
salary_unitenumいいえ月薪 | 年薪 | 日薪 | 時薪

詳細

tw-jobs-mcp

英語 · 繁體中文

test PyPI License: MIT Python 3.11+

あらゆる AI アシスタントから台湾の求人情報を検索できます。tw-jobs-mcp は、104 人力銀行、Yourator、および海外企業の採用サイト(Greenhouse、Lever、Workday を利用する38社)に掲載された台湾の求人をカバーする、読み取り専用の MCP サーバーです。中国語または英語で自然に質問すると、アシスタントがリクエストを正確なフィルターに変換します。

アカウントも API キーも不要です。

claude mcp add tw-jobs -s user -- uvx tw-jobs-mcp

非公式です。 104 や、情報を取得するその他のサイトとは提携しておらず、承認も受けていません。各サイトのページで使用されているものと同じ公開エンドポイントを呼び出します。リクエスト頻度を低く保ち、各サイトの利用規約に従ってください。このプロジェクトに求人データは含まれていません。

質問の例

台北で月給50,000以上の.NETバックエンド求人を探し、市場の給与相場を教えてください。

経験は2年です。新北市のリモートバックエンド求人を表示し、上位3件を読んで企業を比較してください。

この求人に応募する価値はありますか?応募者は何人で、どのような経歴ですか?

新竹でハードウェアエンジニアを募集している海外の半導体企業はどこですか?

この企業に、職種名には明記されていないものも含めて、データ関連の職種はありますか?

裏側では、アシスタントがツールを連携させています。以下の出力は説明用の例であり、企業名と ID は架空のものです。

search_jobs(keyword="後端工程師", keyword_en="backend engineer", area=["台北市"], salary_min=50000)
共 812 筆,第 1/41 頁
id|company_id|職稱|公司|薪資|地點|學歷|技能|刊登
a1b2c|x9y8z7|後端工程師 Backend Engineer|甲科技股份有限公司|月55000~80000|台北市信義區|大學~碩士|C#/.NET/MS SQL|10-18
d3e4f|w6v5u4|資深後端工程師|乙數位股份有限公司|月70000~100000|台北市內湖區|大學|Go/PostgreSQL/Docker|10-17
…

get_job("a1b2c", applicants=true)
後端工程師 Backend Engineer|甲科技股份有限公司|電腦軟體服務業 50人
…
HR:2 天內處理過履歷
應徵分析(近兩週):至少 12 人(由比例推算)
學歷:大學 66.7%、碩士 33.3%
年資:1~3年 41.7%、3~5年 33.3%、無工作經驗 25%
技能:C# 58.3%、MS SQL 41.7%、Docker 25%

このサーバーを選ぶ理由

  • 104では見つからない職種にも対応します。 外資系企業は、台湾の求人を自社の採用サイトにしか掲載しないことがよくあります。source="all"で1回検索するだけで、104、Yourator、Greenhouse、Leverの求人掲示板(Appier、Stripe、MongoDB、Pinkoiなど)と、半導体、ハードウェア、製薬、金融各社のWorkdayサイト(NVIDIA、Micron、Applied Materials、KLA、Cisco、Intel、NXP、GSKなど)を検索できます。すべてのソースの結果をまとめて順位付けします。
  • うろ覚えの求人を見つけます。 タイトルと企業名に検索語がいくつ含まれているかに基づいて、結果の順序を並べ替えます。実際の求人情報を使って作成した40件のテスト検索では、目的の求人が35回1位になりました。104本来の並び順では18回でした。
  • 応募状況がわかります。 104の求人情報では、get_job(applicants=true)を使うと、過去2週間の応募者数と、学歴、経験、年齢、専攻、言語、スキル、資格ごとの内訳を確認できます。すべての求人情報に、雇用主が最後に履歴書を処理した時期も表示されるため、応募書類が読まれているかどうかを判断する目安になります。
  • 確実に機能する絞り込み。 キーワード、勤務地、職種、最低給与(月給、年給、日給、時給)、経験年数、学歴、雇用形態、リモート勤務、過去7日以内の掲載で絞り込めます。すべてのフィルターを実際のサイトで検証しており、適用できないフィルターがある場合は、結果の下にその旨を表示します。
  • 高性能なモデル向けに設計されています。 使用可能な値はすべてスキーマに記載されています。サーバーの指示は、長いケース一覧ではなく、原則を示します。モデルからは見えない部分のみをサーバーが処理します。曖昧な地名を広げ、一致する職種がない場合はキーワードに変換し、検索結果がない場合はフィルターを1つずつ緩めます。こうした前提は、いずれも結果の下に記載されます。
  • コンテキストをあまり消費しません。 返信はJSONではなく、簡潔な表形式です。求人情報20件で約2,000文字となり、同じデータをJSONで表した場合の5分の1未満です。6つのツール定義を合わせても3,000文字未満です。fullを指定しない限り、長いテキストは省略されます。
  • 読み取り専用で、サイトに配慮しています。 ログイン、応募、保存は一切行いません。各サイトへのリクエスト頻度を調整し(104では1秒に1回)、レスポンスを5分間キャッシュし、104が各ページに固定表示する有料求人2件は除外します。

インストール

uvが必要です。以下のコマンドは、PyPIで公開されているパッケージを実行します。公式MCP Registryにもio.github.HsuanC0921/tw-jobs-mcpとして登録されています。

Claude Code

claude mcp add tw-jobs -s user -- uvx tw-jobs-mcp

OpenAI Codex CLI

codex mcp add tw-jobs -- uvx tw-jobs-mcp

または、~/.codex/config.tomlに記述します。

[mcp_servers.tw-jobs]
command = "uvx"
args = ["tw-jobs-mcp"]
startup_timeout_sec = 60   # the first run downloads dependencies

Claude Desktop:Releasesからtw-jobs-mcp-<version>.mcpbをダウンロードして開くか、以下のJSONを使用します。

Gemini CLI、Cursor、Windsurf、ClineなどのmcpServers対応クライアント:~/.gemini/settings.json、~/.cursor/mcp.json、Windsurfのmcp_config.json、またはクライアントに対応する設定ファイルに追加します。

{
  "mcpServers": {
    "tw-jobs": { "command": "uvx", "args": ["tw-jobs-mcp"] }
  }
}

VS Code(GitHub Copilot):.vscode/mcp.jsonではserversを使用し、typeの指定が必要です。

{
  "servers": {
    "tw-jobs": { "type": "stdio", "command": "uvx", "args": ["tw-jobs-mcp"] }
  }
}

リモート(HTTP)およびDocker:URLで接続するクライアントや、チームで共有するサーバー向けです。

uvx tw-jobs-mcp --transport streamable-http --port 8000   # http://127.0.0.1:8000/mcp
docker build -t tw-jobs-mcp . && docker run --rm -p 8000:8000 tw-jobs-mcp

HTTPサーバーには認証機能がありません。localhostまたはプライベートネットワーク上で実行するか、認証機能を備えたリバースプロキシを前段に配置してください。

未リリースのコード:uvx --from git+https://github.com/HsuanC0921/tw-jobs-mcp tw-jobs-mcp。

エージェントスキル

このサーバーは、モデルに使い方をすでに伝えています。skills/tw-jobsを使うと、スキルを読み込むエージェントにさらに詳しいガイダンスを提供できます。リクエストから引数への変換、ソースの選択、注記の読み取り、誠実な報告の方法を説明します。オープンなAgent Skills形式に準拠しています。

  • Claude Code:/plugin marketplace add HsuanC0921/tw-jobs-mcpを実行し、続けて/plugin install tw-jobs@tw-jobs-mcpを実行します(サーバーとスキルがバンドルされています)。または、skills/tw-jobsを~/.claude/skills/にコピーします。
  • Codexおよびその他のスキル対応エージェント:skills/tw-jobsを~/.agents/skills/にコピーします。

ツール

ツール機能
search_jobs求人情報を検索します。次の項目を含む表を返します:id、company_id、職種名、会社名、給与、勤務地、学歴、スキル、掲載日。
get_job求人情報の全文を取得します:仕事内容、応募条件、給与、勤務時間、休暇、福利厚生、人事担当者が履歴書を処理した時期。104 のみ:applicants=trueを指定すると応募者数と属性の内訳が追加され、similar=trueを指定すると類似求人が追加されます。
get_company会社概要を取得します。with_openings=trueを指定すると募集中の求人が追加されます。keywordを指定すると一致する求人のみが表示され、104 では仕事内容も検索対象になります。
salary_overview104 の検索結果の1~5ページについて、給与単位ごとに給与統計(中央値、四分位数、最小値、最大値)を表示します。
sources各情報源にアクセス可能か、またはブロックされているかをリアルタイムで確認します。
lookup_code名前から104の地域コードまたは職種カテゴリコードを検索するか、ツリーを参照します。

search_jobsの引数はすべて任意です:

引数意味
keyword、keyword_en1~3個の短い検索語です。104ではkeywordに中国語、海外サイトではkeyword_enに英語を指定し、互いに翻訳した語句を入力します。アシスタントが両方を補完するため、中国語で検索しても海外の求人が見つかります。
source104(デフォルト)、yourator、boards、workday、またはall
area、jobcat中国語の名称。例:["台北市", "新北市"]、["軟體工程師"]
salary_min、salary_unit最低給与とその単位:月薪(デフォルト)、年薪、日薪、時薪
include_negotiablesalary_minと併用すると、給与を明記していない求人も表示します(104ではデフォルトで除外されます)。
my_yearsユーザーの経験年数です。経験年数の上限がユーザーの年数以下の求人を表示します。經驗不拘も含まれます。
education高中職、專科、大學、碩士、博士
job_type全職、兼職、高階、派遣
remote_only、new_onlyリモート勤務のみ、掲載から7日以内
sortrelevance(デフォルト)、newest、salary
page、per_pageページ設定。1ページあたり最大30件

情報源

source対象適用されるフィルター
104台湾最大の求人サイトすべて
youratorスタートアップ企業および外資系企業のオフィスkeyword、area、sort=newest
boards企業の Greenhouse および Lever 採用ページに掲載された台湾の求人keyword、area、remote_only
workdayWorkday を利用する外資系企業38社の台湾の求人keyword、area
all上記すべてを統合し、順位付けします情報源ごとに適用。情報源が利用できない場合はその旨を表示しますが、処理は続行します。

IDから求人の掲載元がわかります。接頭辞のないIDは104、y:はYourator、g: / l:はGreenhouse / Lever、w:はWorkdayです。表示されたとおりのIDを渡してください。

TW_JOBS_BOARDS(g:gitlab,l:kraken,-g:stripe)とTW_JOBS_WORKDAY(acme.wd1/External,-micron)を使って、求人サイトを追加または削除できます。先頭の-は対象を削除します。Workdayでは検索ごとに各企業の先頭60件を読み込むため、詳細な検索ではキーワードを指定してください。

意図的に対象外としているサイト:1111(104と同種の求人サイトですが規模は小さめ)、Cake(リクエストのたびにCloudflareのチャレンジが表示されます)、LinkedIn(利用規約で自動アクセスが禁止されています)。

設定

変数デフォルト意味
TW_JOBS_TRANSPORTstdiostdioまたはstreamable-http(--transportと同じ)
TW_JOBS_HOST、TW_JOBS_PORT127.0.0.1、8000HTTP のバインドアドレス
TW_JOBS_CACHE_TTL300レスポンスを保持する秒数。0にするとキャッシュが無効になります。
TW_JOBS_BOARDS、TW_JOBS_WORKDAY組み込みリスト追加または削除する求人サイト(「情報源」を参照)
TW_JOBS_FORMATtextjsonを指定すると、すべての項目をコンパクトな JSON で返します。

仕組みと制限

104はCloudflareの背後にあり、通常のHTTPクライアントには403を返します。curl_cffiは実際のChromeのTLSフィンガープリントを提示するため、アクセスできます。地域名とカテゴリ名は、104の公開コードテーブルを参照してローカルで解決されます。

  • **読み取り専用です。**ログイン、応募、ブックマークはできません。AIに求人サイトのパスワードを渡すリスクを冒す価値はありません。
  • **企業名では検索できません。**104はスクリプトからのこのエンドポイントへのアクセスをブロックします。求人のcompany_idから企業を探すか、keywordに企業名を指定してください。
  • **応募者数は推定値です。**104が公開しているのは割合のみなので、その割合に当てはまる最小の人数を算出しています。正確な数ではなく、下限値です。
  • salary_overviewはサイト全体ではなく、関連性の高い求人をサンプルとして抽出します。また、多くの求人には給与が掲載されていません。

開発

uv sync
uv run pytest                  # offline unit and protocol tests
uv run pytest -m live          # against the real sites
uv run python scripts/update_codes.py   # refresh 104's area and category tables

ライセンス

MIT。現状有姿で提供され、保証はありません。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。