mirror of
https://github.com/MadsLorentzen/ai-job-search.git
synced 2026-09-17 00:26:26 +00:00
Add country-agnostic linkedin-search skill (#20)
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>
This commit is contained in:
co-authored by
Akhil Tripathi
Claude Opus 4.8
parent
46a9fdc66c
commit
d8f38fe766
@@ -0,0 +1,42 @@
|
||||
# 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").
|
||||
Reference in New Issue
Block a user