HelloWork France Job Listings & Salary Filter Scraper: MCP config, n8n workflow and API

{
  "mode": "search",
  "searchQueries": [
    "developpeur"
  ],
  "minSalary": 0,
  "radiusKm": "20",
  "postedWithin": "all",
  "sortBy": "relevance",
  "salaryOnly": false,
  "superRecruiterOnly": false,
  "exactMatchesOnly": false,
  "includeDetails": false,
  "includeCompanyProfile": false,
  "incrementalMode": false,
  "maxItems": 3
}

---
name: hellowork-france-job-listings-and-salary-filter
description: "One record per HelloWork.com job with descriptions, skills, structured salary and location, exact dates, search provenance and optional company details. Runs the Apify Actor vexaloom-labs/hellowork-france-job-listings-and-salary-filter. Use when the user needs HelloWork France Job data with fields such as title, company, location, contractType, salary, postedDate and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "vexaloom-labs/hellowork-france-job-listings-and-salary-filter"
  store-url: "https://apify.com/vexaloom-labs/hellowork-france-job-listings-and-salary-filter"
---

# HelloWork France Job Listings & Salary Filter Scraper

Use this skill to fetch HelloWork France Job data with the Apify Actor `vexaloom-labs/hellowork-france-job-listings-and-salary-filter` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `search`, `byLocation`, `bySector`, `byUrls`, required | What to fetch. |
| `searchQueries` | array | One or more free-text keyword searches (mode=search). Each query runs with the same filters; duplicate jobs are removed. |
| `region` | string | French administrative region. Required for mode=byLocation unless `city` is set; also usable as a filter on other modes. |
| `city` | string | French city or commune (e.g. `Lyon`, `Bordeaux`). Takes priority over `region`; also usable as a filter on other modes. |
| `sectors` | array | One or more industry sectors (mode=bySector, optional filter elsewhere). |
| `jobFunctions` | array | One or more job functions (mode=bySector, optional filter elsewhere). |
| `contractTypes` | array | Filter by one or more contract types (optional, all modes). |
| `remoteWork` | array | Filter by disclosed remote-work (télétravail) frequency (optional, all modes). |
| `employmentType` | array | Filter by employment schedule -- full-time vs part-time (optional, all modes). |
| `experienceLevels` | array | Filter by the years of experience the employer asks for (optional, all modes). |
| `companyTypes` | array | Filter by the type of hiring organization (optional, all modes). |
| `csrLabels` | array | Filter to employers holding a specific CSR (corporate social responsibility) certification (optional, all modes). |
| `minSalary` | integer | Only include jobs whose disclosed salary meets this yearly gross EUR floor (optional, all modes). Matches HelloWork's own "Salaire minimum" slider (0-100,000, steps of 1,000). |
| `radiusKm` | one of `0`, `5`, `10`, `20`, `50` | Widen or narrow the search radius around `city` (ignored when only `region` is set -- HelloWork's radius filter only applies to a specific city/commune). |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "search",
  "searchQueries": [
    "developpeur"
  ],
  "minSalary": 0,
  "radiusKm": "20",
  "postedWithin": "all",
  "sortBy": "relevance",
  "salaryOnly": false,
  "superRecruiterOnly": false,
  "exactMatchesOnly": false,
  "includeDetails": false,
  "includeCompanyProfile": false,
  "incrementalMode": false,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/vexaloom-labs~hellowork-france-job-listings-and-salary-filter/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/vexaloom-labs~hellowork-france-job-listings-and-salary-filter/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `title`, `company`, `location`, `contractType`, `salary`, `postedDate`, `isExactMatch`, `url`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.