analyze_job¶
Analyze a job posting against the user's profile.
Overview¶
| Property | Value |
|---|---|
| Cost | $0.02 (2 cents) |
| Scope | job_analysis |
Arguments¶
| Argument | Type | Required | Description |
|---|---|---|---|
job_url |
string | One of these | URL of the job posting |
job_description |
string | One of these | Raw job posting text |
Provide URL or description
You must provide either job_url or job_description, not both.
Response¶
{
"job_id": 12345,
"match_score": 85,
"verdict": "APPLY",
"matching_skills": [
"Python",
"PostgreSQL",
"Docker"
],
"missing_skills": [
"Kubernetes",
"Terraform"
],
"red_flags": [
"Mentions 'rockstar developer'",
"Vague salary range"
],
"honest_assessment": "Strong match for your backend experience. The Kubernetes requirement is listed as 'nice to have', so your Docker skills should suffice. The company has good Glassdoor reviews.",
"suggested_cv_focus": [
"Highlight your Python microservices experience",
"Mention your PostgreSQL optimization work",
"Include the AWS migration project"
]
}
Fields¶
| Field | Type | Description |
|---|---|---|
job_id |
integer | ID for future reference (e.g., CV generation) |
match_score |
integer | 0-100 percentage match |
verdict |
string | APPLY, MAYBE, or SKIP |
matching_skills |
array | Skills you have that match |
missing_skills |
array | Required skills you lack |
red_flags |
array | Potential concerns |
honest_assessment |
string | Candid analysis of fit |
suggested_cv_focus |
array | Tips for your application |
Example¶
import requests
response = requests.post(
"https://jobko.ai/api/mcp/tools/call",
headers={"Authorization": "Bearer jk_YOUR_KEY"},
json={
"name": "analyze_job",
"arguments": {"job_url": "https://linkedin.com/jobs/view/123456"}
}
)
analysis = response.json()
print(f"Match: {analysis['match_score']}% - {analysis['verdict']}")
Using Job Description Text¶
If you have the job text directly:
curl -X POST https://jobko.ai/api/mcp/tools/call \
-H "Authorization: Bearer jk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "analyze_job",
"arguments": {
"job_description": "We are looking for a Senior Python Developer..."
}
}'
Supported Job Sites¶
The job_url parameter works with:
- Indeed
- Glassdoor
- Monster
- WeWorkRemotely
- Most company career pages
Use Cases¶
- Quick job-fit assessment
- Batch analysis of job listings
- Automated job filtering in workflows