Skip to main content

​
scrape_jobs

Search for job listings across UK and France job platforms. Returns structured job data including titles, companies, salaries, locations, and descriptions. Credits: 2.0 per call (0.5 if cached)

​
Parameters

ParameterTypeRequiredDescription
querystringYesSearch term (e.g., “AI Engineer”, “Data Scientist London”)
platformsarrayYesPlatform codes to search. See supported platforms
countrystringNoCountry code: GB (default) or FR
locationstringNoCity or region filter (e.g., “London”, “Manchester”)
min_salarystringNoMinimum salary filter (e.g., “50000”)
dedup_hashesarrayNoHashes of previously seen jobs for deduplication

​
Request

curl -X POST https://mcp.debytes.io/mcp \
  -H "Authorization: Bearer deb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "scrape_jobs",
      "arguments": {
        "query": "Machine Learning Engineer",
        "platforms": ["indeed", "linkedin", "reed"],
        "location": "London",
        "min_salary": "60000"
      }
    }
  }'

​
Response

{
  "query": "Machine Learning Engineer",
  "country": "GB",
  "total_jobs": 42,
  "source": "scrape",
  "jobs": [
    {
      "title": "Senior ML Engineer",
      "company": "TechCorp",
      "location": "London",
      "salary_min": 80000,
      "salary_max": 100000,
      "salary_unlisted": false,
      "work_mode": "hybrid",
      "description": "We are looking for a Senior ML Engineer...",
      "url": "https://example.com/job/12345",
      "platform": "indeed",
      "posted_date": "2026-03-08",
      "dedup_hash": "abc123def456"
    }
  ]
}

​
Response Fields

FieldTypeDescription
querystringThe search query used
countrystringCountry code
total_jobsnumberTotal jobs returned
sourcestringscrape (fresh) or cache (cached result)
jobsarrayArray of job objects
jobs[].titlestringJob title
jobs[].companystringCompany name
jobs[].locationstringJob location
jobs[].salary_minnumberMinimum salary (null if unlisted)
jobs[].salary_maxnumberMaximum salary (null if unlisted)
jobs[].salary_unlistedbooleanTrue if salary not disclosed
jobs[].work_modestringremote, hybrid, on-site, or unknown
jobs[].descriptionstringJob description text
jobs[].urlstringDirect link to the job listing
jobs[].platformstringSource platform code
jobs[].dedup_hashstringHash for deduplication