mirror of https://github.com/MadsLorentzen/ai-job-search.git synced 2026-09-17 08:36:25 +00:00

Files

T

Ayobami Adegoke c42806674b fix(linkedin-search): reject fractional numeric flags (#371 ) (#393 )

parseInt truncated values before validation, so --jobage 0.5 became 0 and silently omitted LinkedIn's freshness filter. Require whole numbers of at least 1 for every numeric search flag and guard the behavior with CLI regression tests.

2026-09-02 20:08:26 +02:00

src

fix(linkedin-search): reject fractional numeric flags (#371 ) (#393 )

2026-09-02 20:08:26 +02:00

tests

fix(linkedin-search): reject fractional numeric flags (#371 ) (#393 )

2026-09-02 20:08:26 +02:00

package.json

fix(cli): pin @types/bun and @bunli/* to concrete versions to stop CI type-drift (#226 )

2026-07-22 17:18:46 +02:00

README.md

Add country-agnostic linkedin-search skill (#20 )

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

tsconfig.json

Add country-agnostic linkedin-search skill (#20 )

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

README.md

linkedin-cli

CLI for searching jobs on LinkedIn's public job listings, for any country/region (and remote), across any sector.

Data source: LinkedIn jobs-guest endpoints (seeMoreJobPostings/search and jobPosting/<id>). Authentication: None required. Dependencies: None (plain bun + fetch). bun install is optional and only pulls dev type defs.

Personal use only. This uses LinkedIn's public job pages; automated access is against LinkedIn's Terms of Service. Keep volume low, don't use it commercially or for bulk data collection, and run it on your own responsibility.

Installation

cd .agents/skills/linkedin-search/cli
bun install   # optional — only installs TypeScript dev types

The CLI runs without any install because it has zero runtime dependencies.

Commands

Command	Description
`search`	Search for job listings (`--location` required)
`detail`	Fetch full detail for a single job listing

search accepts --format json|table|plain (default json); detail accepts --format json|plain. All errors are written to stderr as { "error": "...", "code": "..." } with exit code 1.

Quick examples

# Software roles in Hyderabad, last 7 days
bun run src/cli.ts search -q "backend engineer" -l "Hyderabad, Telangana, India" --jobage 7 --format table

# Design roles in London
bun run src/cli.ts search -q "product designer" -l "London, United Kingdom" --format table

# Fully remote
bun run src/cli.ts search -q "technical writer" -l "Remote" --remote remote --format table

# Full detail for one job
bun run src/cli.ts detail 4426311357 --format plain

See ../SKILL.md for the full flag reference and the Terms-of-Service note.

Search flags

Flag	Alias	Description
`--location`	`-l`	Required. Place string, e.g. `"Mumbai, Maharashtra, India"`, `"Berlin, Germany"`, `"Remote"`.
`--query`	`-q`	Keywords (title / skill / role). Recommended.
`--jobage`		Posted within N days: `1`, `7`, `14`, `30`.
`--remote`		`remote` \| `hybrid` \| `onsite`.
`--page`		1-indexed page (10 results/page).
`--limit`	`-n`	Cap results emitted.
`--format`		`json` \| `table` \| `plain`.