elempleo

mcp-elempleo

elempleo.com（コロンビア）向けのMCPサーバーです。次のことができます。

• 求人を検索し、詳細を確認して、自分のプロフィールに合っているか評価できます。
• 明示的に確認したうえで、1件ずつ求人に応募できます。
• データをまとめた1つのファイル、マスタープロフィールをもとに、履歴書を最新の状態に保てます。

elempleoのどのアカウントでも動作します。個人データがコードに書き込まれることはありません。すべてマスタープロフィール、またはelempleoに登録済みの履歴書から取得します。

インストール

必要条件：Node.js 20以上と、Chromiumベースのブラウザー（Chrome、Edge、Brave、Chromium）。ブラウザーはログイン時にのみ使用します。

MCPクライアント（たとえば ~/.cursor/mcp.json やClaude Desktopの設定）に登録してください。npx がnpmからダウンロードし、最新の状態に保ちます。

{
  "mcpServers": {
    "elempleo": {
      "command": "npx",
      "args": ["-y", "mcp-elempleo"],
      "env": { "PERFIL_MAESTRO": "/ruta/a/mi/perfil-maestro.json" }
    }
  }
}

単独で動作し、マスタープロフィールの標準規格（src/perfil-maestro.js、perfil-maestro.schema.json、PERFIL-MAESTRO.md）を含みます。他の求人MCPにも同じものが含まれているため、すべてのMCPで同じプロフィールを共有できます。

ソースコードからインストールすることもできます。

git clone https://github.com/Jucamhc/mcp-elempleo.git
cd mcp-elempleo
npm install

その場合は、"command": "node" と "args": ["/ruta/a/mcp-elempleo/src/index.js"] を使用してください。

環境変数（すべて任意）

変数	デフォルト	用途
PERFIL_MAESTRO	~/.perfil-maestro/perfil-maestro.json	マスタープロフィールへのパス（すべてのMCPで共通）
RAIZ_ARCHIVOS	マスタープロフィールのフォルダー	fotoとcv_pdfの相対パスの基準
ELEMPLEO_DATA_DIR	~/.elempleo	セッション（Cookie）、カタログのキャッシュ、ブラウザープロフィール、バックアップ
CHROME_PATH	自動検出	ブラウザーが通常の場所にない場合の実行ファイルへのパス

セッションとバックアップは、同期対象のフォルダー外にある~/.elempleo/に保存されます。MCPがCookieや認証情報を表示することはありません。

はじめに

1. iniciar-sesion：elempleoのログイン画面をブラウザーで開きます。手動でログインすると（reCAPTCHAと2段階認証があります）、MCPがセッションを保存します。

2. マスタープロフィールがまだない場合は、construir-perfil-maestroで情報源を指定します。

   • LinkedInのURL。 LinkedInではプロフィールの自動読み取りができないため、MCPが「その他 → PDFとして保存」でエクスポートする方法を案内します。
   • PDF形式の履歴書と写真。 MCPがテキストを抽出し、アシスタントが標準規格に沿ってプロフィールを作成するので、内容を確認できます。
   • elempleoに登録済みの情報（desde_portal: true）。

   承認したら、guardar-perfil-maestroで内容を検証し、写真と履歴書とともに保存します。

3. comparar-perfil：マスタープロフィールと照らし合わせ、elempleoで不足している情報、古くなっている情報、不要な情報を表示します。

4. セクションごとにactualizar-perfilを実行します。まずaplicarを指定せずに実行して、変更前と変更後の計画を確認し、その後aplicar: trueを指定します。

マスタープロフィール

唯一の信頼できる情報源として機能するJSONで、共通規格に準拠しています。MCPはこれを読み取り、情報を捏造しません。elempleoが使用するフィールドについては、perfil-maestro.ejemplo.jsonを参照してください。

フィールド	用途
datos_personales	ciudad、pais、zona_horaria、リンク（linkedin、github、portafolioなど）、およびfoto（相対パスまたは絶対パス）
titular.es、resumen.es	職務プロフィールと、雇用主へのメッセージの冒頭文
profesion	任意：elempleoのカタログにある正確な職種名。省略した場合は、最も高い学位が使用されます
experiencia[]	empresa、cargo、cargo_oficial、inicio／fin（AAAA-MM、fin: null＝現在）、ubicacion、descripcion_empresa、logros_es[]、tecnologias[]
formacion[]	institucion、titulo_es、inicio、fin、graduado、mostrar_en_cv
certificaciones[]	nombre、emisor、fecha
aptitudes、habilidades_clave	aptitudes（自由形式のグループ）とhabilidades_clave.tecnicas／blandas（elempleoでは最大20項目、各40文字）
idiomas[]	idiomaとnivel（ネイティブ、初級、中級、上級）
preferencias	modalidad（例：「リモートのみ」）、salario_minimo_laboral_cop、salario_minimo_prestacion_cop、acepta_reubicacion、puede_viajar、paises、disponibilidad
seguridad_social	pension_obligatoria、cesantias、pension_voluntaria、eps、caja_compensacion（elempleoに表示される名称）
cv_pdf	PDFのパス。複数ある場合は{ "version": "ruta" }オブジェクト
respuestas_frecuentes	再利用可能な回答（例：uso_ia）

elempleoのカタログから選択肢を選ぶ方法

elempleoでは、職種、業種、都市、学歴、コース分野、専門分野を独自のリストから選ぶ必要があります。MCPは入力データと最も多くの単語が一致する選択肢を選び、確認用にプランへ表示します。選択肢を固定する場合は、portales.elempleoにカタログの正確な名称を追加してください（ほかのMCPはこのキーを無視します）。

• experiencia[].portales.elempleo：cargo_equivalente、sector、ciudad。
• formacion[].portales.elempleo：nucleo_conocimiento。学歴レベルと都市には、標準フィールドのnivelとciudadを使用します。
• certificaciones[].portales.elempleo：area、またはルートのportales.elempleoに全般的なarea_cursosを指定します。

ツール

ツール	機能
estado-de-sesion、iniciar-sesion	セッション
buscar-ofertas、detalle-de-oferta	検索（セッション不要）
evaluar-encaje	求人を希望条件（勤務形態、契約に応じた給与、申告済みのテクノロジー、英語力）と比較します
preguntas-de-postulacion、proponer-respuestas	応募フォームを読み取り、マスタープロフィールの情報を使ってメッセージを作成します
postular-a-oferta	confirmacion: "POSTULAR <id>"が必要です。一度に1件のみで、再試行はしません。企業が質問票を要求する場合は、質問とともにrequiere_cuestionarioを返します
responder-cuestionario	応募後の選考質問票を送信します。confirmacion: "CUESTIONARIO <id>"と、ユーザーが承認した回答が必要です
mis-postulaciones	応募状況
construir-perfil-maestro、guardar-perfil-maestro、ver-perfil-maestro	マスタープロフィールの標準ツール：LinkedIn、写真付きPDF履歴書、またはelempleoから作成し、検証して保存し、確認します
ver-mi-perfil、comparar-perfil、actualizar-perfil	履歴書。セクション：perfil_profesional、experiencia、formacion、cursos、idiomas、redes_sociales、habilidades、seguridad_social
subir-foto、subir-cv、listar-mis-cv	写真とファイル

書き込みを行う前に、既存のデータを~/.elempleo/respaldos/にバックアップします。また、eliminar_idsで指定されたIDのみを削除します。

技術リファレンス

elempleoには公開APIがありません。ウェブサイトでは内部API（偽造防止トークンを使用するASP.NET MVC）が使われています。

検索（セッションなし）

1. GET /co/ofertas-empleo/?Trabajo=<palabra> で、Cookie と <span class="js-search-api-token"> のトークンを取得します。

2. ヘッダー __RequestVerificationToken と次の本文を指定して POST /co/api/joboffers/findbyfilter を送信します。

   {"query":"desarrollador","salaryInfo":[],"contractType":0,"workModality":101,
    "cities":[],"publishDate":0,"pageIndex":1,"pageSize":20,"sortExpression":"PublishDate_Desc"}
   

フィルター	値
workModality	0 すべて、100 出社、102 ハイブリッド、101 リモート
contractType	0 すべて、1 無期限、2 期間限定、3 業務委託、4 見習い、5 工事または業務、6 その他
salaryInfo（百万 COP）	2 1 未満 · 3 1～1,5 · … · 10 4,5～5,5 · 23 5,5～6 · 27 6～8 · 28 8～10 · 29 10～12,5 · 30 12,5～15 · 31 15～18 · 32 18～21 · 33 21 超
publishDate	1 今日と昨日、2 1 週間、3 2 週間、4 1 か月、6 1 か月超

詳細：GET /co/api/joboffers/getjoboffer?jobOfferId=<id>。

応募（セッションあり）

• クイック応募：Attachments.SelectedIds とともに POST /co/JobOffers/JobOfferDetail/SaveQuickApplication?JobOfferId=&CurrentAttachmentCVId= を送信します。
• 通常応募：ApplicationNote（任意、最大 2.000 文字）とともに POST /co/JobOffers/JobOfferDetail/Save?jobOfferId= を送信します。
• Response：1 送信済み、2 企業のウェブサイトで応募、3 履歴書が未完成、4 応募済み、5 追加手順にリダイレクト（要確認）。
• 応募履歴：.js-application-api-token のトークンを使用して POST /co/api/jobOffersAplication/filters を送信します。

履歴書

ページ /co/hoja-de-vida。各種カタログは .js-conf の data-* 属性（都市、職種、業界、教育機関、専門分野、コース分野、スキル、国）に含まれています。

セクション	エンドポイント
写真	/co/Persons/PersonalInformation/LoadAsyncPhoto（multipart、フィールド Image。フォーム LoadSyncPhoto のトークン）
職務プロフィール	/co/Persons/ProfessionalProfile/Save
職務経験	/co/Persons/LaboralExperience/Save（削除：/Delete）
正規教育	/co/Persons/FormalEducation/Save（削除：/Delete）
コースとディプロマ	/co/Persons/NonFormalEducation/Save（削除：/Delete）
言語	/co/Persons/LanguageKnowledge/Save。利用可能な言語：/GetAvaibleLanguages
ソーシャルネットワーク	model[i][Id]、model[i][Url] とともに /co/Persons/SocialNetwork/Save を送信します
スキル	Skills[i][id]、Skills[i][name] とともに /co/Persons/Skills/Save を送信します（id 0 は自由入力。カタログにはソフトスキルのみ含まれます）
社会保障	年金、退職金積立、EPS、家族手当基金の SelectedIds と ContributeToVoluntaryPensionFund を指定して /co/Persons/SocialSecurity/Save を送信します
ファイル（CV）	/co/Persons/Attachment/SaveAttachment（multipart、フィールド File。削除：/Delete）

日付形式は dd/mm/aaaa、フォームは jQuery.param 形式の x-www-form-urlencoded です。

確認事項

• 応募時の応答コード 5 が示す内容（追加のスクリーニング質問やテストの可能性）。