generate_job_profile

Normalize a job description into required and preferred professional requirements with transparent weights totaling 100.

When to use

Use before candidate matching or shortlisting when an agent needs a structured job requirement profile.

Selection guidance

Role: specialized. Use before candidate matching or shortlisting when an agent needs a structured job requirement profile.

Use cases

• job description parsing
• job requirements
• ATS job profile

Access

• REST: POST https://api.rafidsystem.com/api/v1/recruitment/generate-job-profile
• x402: POST https://api.rafidsystem.com/api/v1/x402/recruitment/generate-job-profile
• MCP tool: generate_job_profile
• Free preview: POST https://api.rafidsystem.com/api/v1/preview/generate_job_profile

Price: $0.10 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

• cv_job_match
• extract_candidate_profile
• cv_improve
• candidate_shortlist_score

Example input

{
  "job_title": "Data Analyst",
  "job_description": "Required: Python, SQL and 3 years experience. Power BI preferred.",
  "language": "auto"
}

Example output

{
  "job_title": "Data Analyst",
  "role_family": "",
  "seniority": "mid",
  "industry": [],
  "required_skills": [
    {
      "skill": "Python",
      "importance": "required",
      "weight": 35
    }
  ],
  "preferred_skills": [
    {
      "skill": "Microsoft Power BI",
      "importance": "preferred",
      "weight": 30
    }
  ],
  "required_experience_years": 3,
  "preferred_experience_years": null,
  "required_education": [],
  "certifications": [],
  "responsibilities": [],
  "domain_experience": [],
  "technical_requirements": [],
  "leadership_requirements": [],
  "language_requirements": [],
  "location_requirements": null,
  "employment_type": null,
  "keywords": [
    "Python",
    "SQL",
    "Microsoft Power BI"
  ],
  "scoring_model": {
    "skills_weight": 40,
    "experience_weight": 25,
    "education_weight": 10,
    "domain_weight": 10,
    "responsibilities_weight": 15
  }
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "job_description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100000
    },
    "job_title": {
      "type": "string",
      "maxLength": 300
    },
    "language": {
      "default": "auto",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    }
  },
  "required": [
    "job_description",
    "language"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "job_title": {
      "type": "string"
    },
    "role_family": {
      "type": "string"
    },
    "seniority": {
      "type": "string"
    },
    "industry": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "required_skills": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "preferred_skills": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "required_experience_years": {
      "type": [
        "number",
        "null"
      ]
    },
    "preferred_experience_years": {
      "type": [
        "number",
        "null"
      ]
    },
    "required_education": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "certifications": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "responsibilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "domain_experience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "technical_requirements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "leadership_requirements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "language_requirements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "location_requirements": {
      "type": [
        "string",
        "null"
      ]
    },
    "employment_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "scoring_model": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "job_title",
    "role_family",
    "seniority",
    "industry",
    "required_skills",
    "preferred_skills",
    "required_experience_years",
    "preferred_experience_years",
    "required_education",
    "certifications",
    "responsibilities",
    "domain_experience",
    "technical_requirements",
    "leadership_requirements",
    "language_requirements",
    "location_requirements",
    "employment_type",
    "keywords",
    "scoring_model"
  ],
  "additionalProperties": false
}

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