Magneto

mcp-magneto

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

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

Magneto のすべての候補者アカウントで動作します。個人データはコードに一切記載されていません。すべてマスタープロフィール、またはすでに Magneto に登録されている履歴書から取得します。

非公式プロジェクトです。 Magneto とは提携しておらず、同社からの支援も受けていません。ウェブサイトが利用する内部 API を使用しているため、予告なく変更され、ツールが動作しなくなる場合があります。Magneto の利用規約に従って使用する責任は、各ユーザーにあります。応募は実際に送信され、取り消せません。

インストール

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

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

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

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

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

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

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

環境変数（すべて任意）

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

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

はじめに

1. iniciar-sesion：Magneto のログイン画面をブラウザーで開きます。自分でログインすると（メール、Google、Microsoft、または LinkedIn のコードを使用）、MCP がトークンを保存します。トークンの有効期間は 24 時間です。MCP のブラウザーにはセッションが保持されるため、iniciar-sesion を再度呼び出すと、数秒で自動的に更新されます。
2. まだマスタープロフィールがない場合、construir-perfil-maestro で情報源を指定します。LinkedIn の URL、写真付きの PDF 履歴書、または Magneto にすでにある情報（desde_portal: true）を指定できます。内容を承認したら、guardar-perfil-maestro で検証して保存します。
3. comparar-perfil：マスタープロフィールと比較して、Magneto で不足している情報、古くなっている情報、余分な情報を表示します。
4. セクションごとに actualizar-perfil を実行します。まずは aplicar を指定せずに、変更前と変更後の計画を確認します。その後、aplicar: true を指定します。

応募の流れ

1. buscar-ofertas → detalle-de-oferta → evaluar-encaje。
2. preguntas-de-postulacion：すでに応募済みかどうかを示し、フィルタリング用質問（すべて必須）を一覧表示します。
3. proponer-respuestas：マスタープロフィールをもとに回答を提案し、respaldada、requiere_confirmacion、sin_respaldo に分類します。後者の2つはユーザーと確認して解決します。回答を捏造することはありません。
4. 承認済みの回答と confirmacion: "POSTULAR <id>" を指定して postular-a-oferta を実行します。Magneto では、質問への回答と応募を同じリクエストで送信します。

回答の状態：submitted、already_applied、needs_review（質問への回答が不完全、追加情報が必要、またはプロフィールが不完全なため応募が事前選考扱いになった場合）、expired、sesion_expirada、limite_de_peticiones、error。

ツール

ツール	内容
estado-de-sesion, iniciar-sesion	セッション
buscar-ofertas, detalle-de-oferta	求人検索（セッションなしで利用可能。セッションがある場合は、すでに応募済みかどうかを表示します）
evaluar-encaje	求人を希望条件（勤務形態、契約形態に応じた給与、申告済みの技術、英語力）と比較します
preguntas-de-postulacion, proponer-respuestas	スクリーニング質問を読み込み、マスタープロフィールの情報を使って回答を提案します
postular-a-oferta	confirmacion: "POSTULAR <id>" が必要です。一度に1件のみで、再試行は行いません
mis-postulaciones	Magnetoでの応募状況
construir-perfil-maestro, guardar-perfil-maestro, ver-perfil-maestro	マスタープロフィールの標準ツール
ver-mi-perfil, comparar-perfil, actualizar-perfil	履歴書。セクション：descripcion、idiomas、habilidades、experiencia、formacion、certificaciones、preferencias
subir-foto, subir-cv, listar-mis-cv	写真と履歴書（Magnetoに保存できる履歴書は1件のみです）

求人はID、スラッグ（desarrollador-backend-1088350）、またはURLで識別します。セッションがない場合、Magnetoはスラッグを指定した場合にのみ求人詳細を返します。

書き込みを行う前に、変更前の内容を必ずバックアップ（~/.magneto/respaldos/）します。また、eliminar_idsで指定したIDのみを削除します。preferenciasセクションでは、職種、最低給与、リモート、ハイブリッド、出張、転居を変更できます。フォームのその他の項目（業種、学歴レベル、都市、勤務時間）はそのまま再送信されます。個人情報、職歴ごとの都市、「求人を受け付ける」設定はウェブサイトで編集します。

マスタープロフィール

Magnetoで使用されるフィールド（perfil-maestro.ejemplo.jsonを参照）：

フィールド	用途
resumen.es	プロフィールの説明（最大2,000文字）。別の説明を設定するには、portales.magneto.descripcionを使用します
experiencia[]	empresa、cargo（最大120文字）、inicio／fin（AAAA-MM形式、fin: null = 現在）、descripcion_empresa、logros_es[]、tecnologias[]
formacion[]	institucion、titulo_es、inicio、fin、graduado、任意のnivel（「Universitaria」、「Tecnológica」、「Técnico」、「Especialización」など）。nivelがない場合、学習の種類は学位名から推定されます。国はdatos_personales.paisから取得します。コースはcertificacionesに記載し、未修了の学歴は登録しません（Magnetoにはその状態がありません）
certificaciones[]	nombre、emisor、fecha（AAAA-MM形式）、任意のurl
habilidades_clave.tecnicas、aptitudes	スキル（Magnetoで登録できるのは10件です）
idiomas[]	idiomaとnivel（Básico、Intermedio、Avanzado、Nativo）
anios_experiencia	totalと、分野またはツールごとの経験年数（例："react": "3"、"contabilidad": 3、"nomina": 2）。質問への回答に使用します
preferencias	modalidad（「Solo remoto」、「Presencial」、「Híbrido」、「Remoto o híbrido」）、salario_minimo_laboral_cop、salario_minimo_prestacion_cop、acepta_reubicacion、puede_viajar
portales.magneto.cargo	探している職種（Magnetoの「Preferencias」）
respuestas_frecuentes	再利用可能な回答。キーまたはテキストが質問に一致した場合に提案されます
datos_personales.foto、cv_pdf	写真（JPGまたはPNG）とPDF形式の履歴書

あらゆる分野のプロフィール

MCP は職業を限定しません。開発職、経理アシスタント（出社勤務）、営業担当役員（ハイブリッド勤務）のプロフィールでテスト済みです。

• buscar-ofertas で modalidad を指定しない場合は、プロフィールの設定が使われます。「リモートのみ」ならリモート勤務の求人に絞り込み、出社勤務またはハイブリッド勤務で転居を希望しない場合は、現在の都市で検索します。
• evaluar-encaje は、都市（別の都市での出社勤務またはハイブリッド勤務の場合）、契約形態に応じた給与、英語力を確認します。また、プロフィールにソフトウェア技術が3つ以上記載されている場合は技術スタックを、それ以外のプロフィールでは求人の説明に記載されたスキルやツールを確認します。
• proponer-respuestas は、役職と経験年数をもとに職務経験の質問に回答し、該当する範囲の選択肢（例：「3年以上」）を選びます。はい／いいえ形式の質問では、最低要件を月単位で比較し、学位や知識に関する質問には学歴とスキルを使います。プロフィールにない情報（車両、運転免許、シフト勤務の可否など）は sin_respaldo のままです。respuestas_frecuentes に2語以上のキー（例："licencia_conduccion": "Sí, B1 vigente"）を追加してください。

制限：コロンビアのみ（検索は C47、給与は COP）。

技術リファレンス

Magneto は候補者向けの公開 API を提供していません。ウェブサイトは https://api.magneto365.com を使用し、Authorization: Bearer に JWT を設定します（.magneto365.com の access_token Cookie、有効期間は24時間）。読み取りリクエストでは429が発生した場合に1回再試行します。送信リクエストは再試行しません。

求人（/jobs）

用途	エンドポイント
公開検索／ログイン済み検索	GET /jobs/v1/public/jobs/search / GET /jobs/v1/jobs/search
公開求人の詳細（slug）／ログイン済み求人の詳細（id）	GET /jobs/v1/public/jobs/<slug> / GET /jobs/v1/jobs/<id>
位置情報	GET /jobs/v1/public/locations?term=&country_id=47（コロンビア：C47、都市：CT…）
質問票	GET /jobs/v1/questionnaire/<id> および GET /jobs/v1/questionnaire/already-answered/<id>
応募	{jobId, suggestedByMatcher, sourceOrigins, utmPayload, questionnaires?} を指定して POST /jobs/v1/jobs/apply
応募中の選考プロセス	GET /jobs/v2/my-processes?page= および /jobs/v2/my-processes/counters
追加で必要なデータ	{id} を指定して POST /sign-up-forms/v1/schema/apply（templateId のある求人）

検索パラメーター：paginator[page]、paginator[pageSize]（20または30）、filters[locations][0]、filters[work_modality][0]（remote、hybrid、onSite）、filters[contract_type_id][0]（1 無期契約、2 無期限契約、3 有期契約、4 工事または業務契約、5 業務委託契約、6 見習い）、order[field]（_score または publish_date）、queries[0][field]=all、queries[0][term]。

質問票への回答：questionnaires: [{id, questions: [{id, type, openAnswer} | {id, type, answer: [{id, titleAnswer}]}]}]。種類：0 単一選択、1 複数選択、2 短文（140文字）、3 長文（2,500文字）。回答に applicationId が含まれている場合、応募は送信済みです。level と missingFields が含まれている場合、プロフィールが不完全なため、事前選考の対象になっています。

履歴書（/sign-up）

読み取り：GET /sign-up/v2/candidate/profile。書き込み：PATCH /sign-up/v2/candidate に {...セクション, step} とヘッダー x-schema-response: profile-v2 を指定します。

セクション	step	ボディ
自己紹介	15	{profileDescription}
スキル	16	{skills: [{id?, name, level}]}（全件リスト）
写真	19	{profileImageFileName, originalFileName}
言語	20	{languages: [{id?, languageId, name, level}]}（全件リスト。カタログは /sign-up/v1/languages）
職務経験	37 / 削除 63	{experiences: [{id?, position, company, description, atPresent, startDate, endDate}]}。削除する場合は clearSection: "experiences" を追加します
希望条件	47	{titleOrProfession, salary, currencyPayId, salaryFrequencyId, candidateSectors, educationLevelId, workCityId, availableTo{Move,RemoteWork,Travel,HybridWork}, internshipType, candidateJourneys}。disability は存在する場合のみ送信してください（null を指定すると 502 が返されます）
資格	60 / 削除 67	{certifications: [{id?, name, institution, expeditionDate, credentialUrl?, attachmentUrl?}]}。削除する場合は clearSection: "certifications" を追加します
SNS とリンク／趣味	24 / 25	{socialMediaLinks} / {hobbies}（MCP では使用しません）
学歴	76 / 削除 77	{studies: [{id?, institute, profession, title, inProgress, startDate, endDate, studyType, countryId}]}。studyType は /sign-up/v1/education/levels の ID、countryId は /sign-up/v1/countries/active の ID です。どちらかがない場合、Magneto は応募を仮応募のままにします（missingFields: studies:<id>）。削除する場合は clearSection: "studies" を追加します

言語とスキルのレベル：1 初級、2 中級、3 上級、4 プロフェッショナルまたはネイティブ。日付は AAAA-MM-DD 形式です。CV：PUT /sign-up/v1/candidate/upload-cv（multipart、フィールド file）。

確認待ち

• 写真のアップロード方法はウェブサイトのコードから確認しましたが、実際のアカウントではまだテストしていません（CV と履歴書の各セクションはテスト済みです）。
• templateId を含む求人（登録時の追加データ）、複数選択式の質問、長文回答の質問。
• 職務経験、学歴、資格の削除（eliminar_ids）。