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

Files

T

Mads LorentzenandClaude Fable 5 a5ffcc39ff chore: untrack tracker CSV, scope scraper Bash permission, fix portal SKILL.md paths (#71 )

- Untrack job_search_tracker.csv: it was both tracked and listed in
  .gitignore (same inconsistency class as the settings.local.json fix
  in #27). Users' personal rows risked merge conflicts on every pull;
  commands already create the file with the standard header when it
  is missing.
- Scope job-scraper's allowed-tools Bash entry (from #52) to
  'bun --version' and the portal-CLI invocation pattern, adopting the
  tighter form proposed in #65.
- Fix all five portal SKILL.mds documenting 'bun run skills/...'
  paths that do not resolve from the repo root ('.agents/skills/...'
  is correct) - now load-bearing since #52 wired /scrape to read
  these docs for CLI invocations. Surfaced in #66.
- Teach tools/lint_skills.py to glob-expand allowed-tools bun run
  targets so scoped wildcard permissions lint correctly.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

2026-07-08 17:14:39 +02:00

4.2 KiB

Raw Blame History

name, version, description, context, allowed-tools

name	version	description	context	allowed-tools
linkedin-search	1.0.0	Use this skill whenever the user wants to search for jobs in any location or market, find job listings, or look up a specific job posting — in any country, city, or remotely. Invoke for open positions, vacancies, and hiring across any sector or role (software, data, design, marketing, finance, legal, operations, etc.). The location is always supplied explicitly by the user. Trigger phrases: find a job, job search, search for jobs, job openings, vacancies, hiring, positions open, remote jobs, "are there any X jobs in <place>", look up this job posting.	fork	Bash(bun run .agents/skills/linkedin-search/cli/src/cli.ts *)

LinkedIn Search Skill

Search live job listings from LinkedIn's public job board for any country/region (and remote). No authentication, no API key, and zero runtime dependencies — it runs with just bun. The location is always passed explicitly, so the same skill works for a forker in any market out of the box.

This is a country-agnostic worked example of the repo's job-portal-skill pattern. LinkedIn's jobs-guest endpoints are global and the HTML parsing is country-independent; only the --location you pass changes per market.

⚠️ Personal use only

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

When to use this skill

Search for job openings in a given location (any country/city) or remotely
Filter by recency (posted today / last 7 / 14 / 30 days) or workplace type (remote/hybrid/onsite)
Get the full description of a specific job listing

Commands

Search job listings

bun run .agents/skills/linkedin-search/cli/src/cli.ts search --location "<place>" [flags]

Key flags:

--location <text> / -l <text> — required. A LinkedIn place string, e.g. "Mumbai, Maharashtra, India", "Berlin, Germany", "London, United Kingdom", or "Remote".
--query <text> / -q <text> — keyword search (title, skill, role). Recommended.
--jobage <days> — posted within N days: 1, 7, 14, 30. Omit for all postings.
--remote <mode> — remote, hybrid, or onsite (workplace-type filter).
--page <n> — page number (1-indexed, 10 results per page).
--limit <n> / -n <n> — cap total results emitted (client-side).
--format json|table|plain — default json.

Fetch full job detail

bun run .agents/skills/linkedin-search/cli/src/cli.ts detail <id|url> [--format json|plain]

id is the job ID from search results (e.g. 4426311357). You may also pass a full LinkedIn jobs/view/... URL or a urn:li:jobPosting:... URN. Returns the full description, seniority, employment type, job function, industries, and apply link.

Usage examples

# Data engineer roles in Bengaluru, last 30 days
bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "data engineer" -l "Bengaluru, Karnataka, India" --jobage 30 --format table

# Product manager roles in Berlin, remote
bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "product manager" -l "Berlin, Germany" --remote remote --format table

# Any role, fully remote
bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "paralegal" -l "Remote" --format table

# Full details for a specific job
bun run .agents/skills/linkedin-search/cli/src/cli.ts detail 4426311357 --format plain

Output formats

Format	Best for
`json`	Default — programmatic use, passing IDs to `detail`
`table`	Quick human-readable scanning
`plain`	Reading a single job's full detail (`detail` command)

All errors are written to stderr as { "error": "...", "code": "..." } and the process exits with code 1.

Notes

Data is from LinkedIn's public jobs-guest endpoints — no credentials required.
Page size is fixed at 10 results per page.
LinkedIn may rate-limit; the CLI retries 429/5xx with exponential backoff. Keep volume low (see ToS note above).
Job IDs are numeric (e.g. 4426311357) — pass them as-is to detail.

4.2 KiB Raw Blame History