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

Files

T

Mads LorentzenandClaude Opus 5 3bfd525cc4 fix(portals)!: reject unknown flags in all six CLIs

Silently discarded flags produced silently wrong results: jobdanmark
with --query (its real flag is --text) returned all 13,862 jobs as if
they matched, exit 0, empty stderr - indistinguishable from a real
result set. The four bunli CLIs get an argv preflight built from each
command's own options object; linkedin and freehire validate parsed
flags against per-command known sets. help/version still pass, and
add-portal.md's existing bogus-flag-exits-1 contract now holds for the
reference implementations contributors copy. One linkedin pin updated:
"--jobage-minutes -5" now fails as UNKNOWN_FLAG (the stray -5 token)
rather than BAD_ARG - same loud-failure invariant, earlier gate. Review
finding F13 (2026-08-19), decision approved by Mads.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-19 20:44:26 +02:00

src

fix(portals)!: reject unknown flags in all six CLIs

2026-08-19 20:44:26 +02:00

tests

fix(portals)!: reject unknown flags in all six CLIs

2026-08-19 20:44: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`.