cv_job_match

Compare a candidate profile or CV with a job profile or description using normalized skills, experience evidence and transparent weighted scoring.

When to use

Use when an agent needs evidence-based candidate-to-job matching for one candidate.

Selection guidance

Role: supporting. Use when an agent needs evidence-based candidate-to-job matching for one candidate.

Use cases

• CV job match
• candidate fit
• skill gap analysis

Access

• REST: POST https://api.rafidsystem.com/api/v1/recruitment/cv-job-match
• x402: POST https://api.rafidsystem.com/api/v1/x402/recruitment/cv-job-match
• MCP tool: cv_job_match

Price: $0.25 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• extract_candidate_profile
• cv_improve
• generate_job_profile
• candidate_shortlist_score

Example input

{
  "cv_text": "Data Analyst\nExperience 2020-2024\nPython SQL",
  "job_description": "Required Python and SQL; 3 years experience."
}

Example output

{
  "match_score": 80,
  "decision_support": {
    "strong_match": [
      "Python",
      "SQL"
    ],
    "partial_match": [],
    "missing_required": [],
    "missing_preferred": []
  },
  "category_scores": {
    "required_skills": 100,
    "experience": 100,
    "domain": 50,
    "responsibilities": 50,
    "education": 50,
    "certifications": 50
  },
  "skill_match": [
    {
      "requirement": "Python",
      "status": "matched",
      "candidate_evidence": "Python",
      "confidence": 0.9
    }
  ],
  "experience_analysis": {
    "candidate_years": 5,
    "required_years": 3
  },
  "transferable_skills": [],
  "gaps": [],
  "risk_flags": [],
  "confidence": 0.7,
  "explanation": "Score is based on normalized job-relevant skills and supplied experience evidence only."
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cv_text": {
      "type": "string",
      "maxLength": 200000
    },
    "job_description": {
      "type": "string",
      "maxLength": 100000
    },
    "candidate_profile": {},
    "job_profile": {}
  },
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "match_score": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "decision_support": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "category_scores": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "skill_match": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "experience_analysis": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "transferable_skills": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "gaps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "risk_flags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "explanation": {
      "type": "string"
    }
  },
  "required": [
    "match_score",
    "decision_support",
    "category_scores",
    "skill_match",
    "experience_analysis",
    "transferable_skills",
    "gaps",
    "risk_flags",
    "confidence",
    "explanation"
  ],
  "additionalProperties": false
}

Category: Recruitment Intelligence · hierarchy: supporting · idempotent: yes · side effects: no