linkedin-job-scraperlisted
Install: claude install-skill gooseworks-ai/goose-skills
# LinkedIn Scraper
## Overview
This skill finds LinkedIn job postings by running `tools/jobspy_scraper.py`, a thin wrapper
around the [JobSpy](https://github.com/speedyapply/JobSpy) library. It handles installation,
parameter construction, execution, and result interpretation.
## Quick Start
**Install the dependency once (requires Python 3.10+):**
```bash
python3.12 -m pip install -U python-jobspy --break-system-packages
```
**Run the scraper:**
```bash
python3.12 tools/jobspy_scraper.py \
--search "software engineer" \
--location "San Francisco, CA" \
--results 25 \
--output .tmp/jobs.csv
```
Results are saved as CSV and printed as a summary table.
---
## Workflow
### Step 1 — Understand the request
Identify from the user's message:
- **Search term** — job title, role, or keyword (required)
- **Location** — city, state, or "Remote" (optional but recommended)
- **Results wanted** — default to 25 if not specified
- **Recency** — `hours_old` filter if user wants recent posts (e.g. "last 48 hours")
- **Company filter** — `linkedin_company_ids` if targeting a specific company
- **Full descriptions** — set `--fetch-descriptions` if user needs job description text
If anything is ambiguous (e.g. "find AI jobs"), pick reasonable defaults and tell the user what you used.
### Step 2 — Construct the command
Build the `tools/jobspy_scraper.py` command using the parameters below.
Always save output to `.tmp/` so it's disposable and easy to find.
```bash
python tools/