mcpField
L
linkedin-jobs

linkedin-jobs

github.com/its-a-unixsystemProductivity183 installsUpdated 23w ago
Repository

About linkedin-jobs

A LinkedIn Jobs skill for searching listings by criteria and fetching an individual job by URL or ID. It returns raw JSON for job seekers and workflows that need structured job-posting details.

Key features

  1. 01Search by keyword and location
  2. 02Filter by work mode and job type
  3. 03Limit results and refine criteria
  4. 04Fetch a job by URL or ID
  5. 05Return raw job data as JSON

Use cases

  1. 01Find roles matching a location and keyword
  2. 02Narrow listings by seniority or work mode
  3. 03Retrieve full details for a specific posting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/its-a-unixsystem/skills --skill linkedin-jobs

After installing, type/linkedin-jobsin Claude Code to confirm it loaded.

Bundled filesscripts/fetch_linkedin_job.pyscripts/search_linkedin_jobs.py

Details

From the project README

LinkedIn Jobs

Requires BRIGHTDATA_API_KEY environment variable.

Two operations: search (discover jobs by criteria) and fetch (get a specific job by URL or ID). Both return full raw JSON.

Search jobs

Cost: ~$1.50 per 1k records. Always use --limit to control costs. Default limit is 25.

Script paths below are relative to this skill's directory.

python3 scripts/search_linkedin_jobs.py "software engineer" \
  --location "United States" \
  --remote Remote \
  --time-range "Past month" \
  --job-type Full-time \
  --experience "Mid-Senior level" \
  --limit 25

keyword and --location are required. All other flags are optional.

FlagValid values
--limitMax results (default 25). Keep low to control costs.
--remoteRemote | On-site | Hybrid
--time-range"Past 24 hours" | "Past week" | "Past month" (default)
--job-typeFull-time | Part-time | Contract | Temporary | Volunteer
--experience"Entry level" | Associate | "Mid-Senior level" | Director | Executive | Internship
--companyCompany name string
--countryCountry code (e.g. US, GB)

Returns an array of job objects.

Fetch a specific job

Takes ~30 seconds. Accepts a full LinkedIn URL or numeric job ID.

python3 scripts/fetch_linkedin_job.py 4358573391
python3 scripts/fetch_linkedin_job.py "https://www.linkedin.com/jobs/view/4358573391"

Returns a single job object.

Key output fields

job_posting_id, job_title, company_name, job_location, job_summary, job_posted_date, job_employment_type, job_seniority_level, job_num_applicants, base_salary, is_easy_apply, application_availability, url, apply_link, job_description_formatted.

Comments

Markdown supported