mirror of
https://github.com/MadsLorentzen/ai-job-search.git
synced 2026-09-17 08:36:25 +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>
1.5 KiB
1.5 KiB
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").