mirror of
https://github.com/MadsLorentzen/ai-job-search.git
synced 2026-09-17 00:26:26 +00:00
d8f38fe766
A general-purpose, field-agnostic job-search skill built on LinkedIn's public jobs-guest endpoints. Works for any market out of the box — location is an explicit required flag (no country default). Zero runtime dependencies (bun only); search + detail commands. Includes a personal-use / Terms-of-Service note (automated access is against LinkedIn's ToS — keep volume low, non-commercial). (Pairs with the .gitignore fix in #21, which lets skills under .agents/ be tracked.) Co-authored-by: Akhil Tripathi <kodabear@Akhils-MacBook-Pro.local> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# LinkedIn Jobs URL Reference
|
|
|
|
Public, unauthenticated `jobs-guest` endpoints used by this skill. Global — the same
|
|
endpoints serve every market; only the `location` value changes.
|
|
|
|
> Personal use only — automated access is against LinkedIn's Terms of Service; keep volume low.
|
|
|
|
## Search
|
|
|
|
```
|
|
GET https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search
|
|
```
|
|
|
|
Query params:
|
|
|
|
| Param | Meaning | Example |
|
|
|-------|---------|---------|
|
|
| `keywords` | Free-text query | `data engineer` |
|
|
| `location` | Place string | `Mumbai, Maharashtra, India` · `Berlin, Germany` · `Remote` |
|
|
| `f_TPR` | Posted-within window (seconds) | `r604800` (7d), `r2592000` (30d) |
|
|
| `f_WT` | Workplace type | `1` on-site · `2` remote · `3` hybrid |
|
|
| `start` | Pagination offset (10/page) | `0`, `10`, `20`, … |
|
|
|
|
Returns an HTML list of job cards (one `<li>` per posting). The CLI parses each card by
|
|
its `data-entity-urn="urn:li:jobPosting:<id>"` and extracts title, company, location, date, URL.
|
|
|
|
## Detail
|
|
|
|
```
|
|
GET https://www.linkedin.com/jobs-guest/jobs/api/jobPosting/<jobId>
|
|
```
|
|
|
|
Returns a single job's HTML: title (`top-card-layout__title`), company
|
|
(`topcard__org-name-link`), location (`topcard__flavor--bullet`), the rich description
|
|
(`show-more-less-html__markup` / `description__text`), and job-criteria items
|
|
(seniority, employment type, job function, industries).
|
|
|
|
## Notes
|
|
|
|
- No authentication required.
|
|
- Respect rate limits — the CLI backs off on 429/5xx.
|
|
- Country-agnostic: pass any `--location` (city, region, country, or "Remote").
|