# Linkedin Search

Use this skill whenever the user wants to search for jobs in any location or market...

- Repository: https://github.com/ai-job-search-dev/ai-job-search (68713 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add ai-job-search-dev/ai-job-search --skill linkedin-search -g -a claude-code -y`
Codex: `npx skills add ai-job-search-dev/ai-job-search --skill linkedin-search -g -a codex -y`
Cursor: `npx skills add ai-job-search-dev/ai-job-search --skill linkedin-search -g -a cursor -y`
Gemini CLI: `npx skills add ai-job-search-dev/ai-job-search --skill linkedin-search -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

```bash
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.
- `--jobage-minutes <n>`, posted within N minutes (sub-day precision, e.g. `30`). Conflicts with `--jobage`, pass only one.
- `--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

The rest: https://github.com/ai-job-search-dev/ai-job-search/blob/HEAD/.agents/skills/linkedin-search/SKILL.md