mirror of https://github.com/MadsLorentzen/ai-job-search.git synced 2026-09-17 16:46:24 +00:00

Files

T

d8f38fe766 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>

2026-06-29 20:26:19 +02:00

1.5 KiB

Raw Blame History

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").

1.5 KiB Raw Blame History

LinkedIn Jobs URL Reference

Search

Detail

Notes

1.5 KiB

Raw Blame History