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

Files

T

Mads LorentzenandClaude Opus 5 2edf8c41f1 test(portals): cover linkedin card date/location and jobindex parseSearchPage

The linkedin fixture was purpose-built for entity decoding and had no
<time> or location element, so removing the date extraction - a /scrape
contract field on a default-ON portal - survived the suite. jobindex's
parseSearchPage (the Stash parser behind every search) had zero tests,
so meta.total silently dropping hitcount survived too. Both mutations
now fail exactly the new tests. The ASAP deadline branch is deliberately
left to the F12 fix, which changes its behaviour to null. Review finding
F35 (2026-08-19).

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

2026-08-19 20:03:00 +02:00

src

fix(cli): honest User-Agent token on linkedin-search

2026-08-07 15:53:46 +02:00

tests

test(portals): cover linkedin card date/location and jobindex parseSearchPage

2026-08-19 20:03:00 +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`.