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.--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
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, and industries.
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
# Engineer roles, remote, posted in the last 30 minutes
bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "engineer" -l "Remote" --jobage-minutes 30 --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.
1---2name: linkedin-search3description: 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.4---5
6# LinkedIn Search Skill
7
8Search live job listings from LinkedIn's public job board for **any country/region**
9(and remote). No authentication, no API key, and **zero runtime dependencies** — it runs
10with just `bun`. The location is always passed explicitly, so the same skill works for a
11forker in any market out of the box.
12
13> This is a country-agnostic worked example of the repo's job-portal-skill pattern.
14> LinkedIn's `jobs-guest` endpoints are global and the HTML parsing is country-independent;
15> only the `--location` you pass changes per market.
16
17## ⚠️ Personal use only
18
19This uses LinkedIn's public job pages; automated access is against LinkedIn's Terms of
20Service, so **keep volume low and don't use it commercially or for bulk data collection.**
21Run it on your own responsibility.
22
23## When to use this skill
24
25- Search for job openings in a given location (any country/city) or remotely
26- Filter by recency (posted today / last 7 / 14 / 30 days) or workplace type (remote/hybrid/onsite)
27- Get the full description of a specific job listing
28
29## Commands
30
31### Search job listings
32
33```bash
34bun run .agents/skills/linkedin-search/cli/src/cli.ts search --location "<place>" [flags]
35```
36
37Key flags:
38- `--location <text>` / `-l <text>` — **required.** A LinkedIn place string, e.g. `"Mumbai, Maharashtra, India"`, `"Berlin, Germany"`, `"London, United Kingdom"`, or `"Remote"`.
39- `--query <text>` / `-q <text>` — keyword search (title, skill, role). Recommended.
40- `--jobage <days>` — posted within N days: `1`, `7`, `14`, `30`. Omit for all postings.
41- `--jobage-minutes <n>` — posted within N minutes (sub-day precision, e.g. `30`). Conflicts with `--jobage` — pass only one.
42- `--remote <mode>` — `remote`, `hybrid`, or `onsite` (workplace-type filter).
43- `--page <n>` — page number (1-indexed, 10 results per page).
44- `--limit <n>` / `-n <n>` — cap total results emitted (client-side).
45- `--format json|table|plain` — default `json`.
46
47### Fetch full job detail
48
49```bash
50bun run .agents/skills/linkedin-search/cli/src/cli.ts detail <id|url> [--format json|plain]
51```
52
53`id` is the job ID from `search` results (e.g. `4426311357`). You may also pass a full
54LinkedIn `jobs/view/...` URL or a `urn:li:jobPosting:...` URN. Returns the full description,
55seniority, employment type, job function, and industries.
56
57## Usage examples
58
59```bash
60# Data engineer roles in Bengaluru, last 30 days
61bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "data engineer" -l "Bengaluru, Karnataka, India" --jobage 30 --format table
62
63# Product manager roles in Berlin, remote
64bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "product manager" -l "Berlin, Germany" --remote remote --format table
65
66# Any role, fully remote
67bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "paralegal" -l "Remote" --format table
68
69# Engineer roles, remote, posted in the last 30 minutes
70bun run .agents/skills/linkedin-search/cli/src/cli.ts search -q "engineer" -l "Remote" --jobage-minutes 30 --format table
71
72# Full details for a specific job
73bun run .agents/skills/linkedin-search/cli/src/cli.ts detail 4426311357 --format plain
74```
75
76## Output formats
77
78| Format | Best for |
79|--------|----------|
80| `json` | Default — programmatic use, passing IDs to `detail` |
81| `table` | Quick human-readable scanning |
82| `plain` | Reading a single job's full detail (`detail` command) |
83
84All errors are written to **stderr** as `{ "error": "...", "code": "..." }` and the process exits with code `1`.
85
86## Notes
87
88- Data is from LinkedIn's public `jobs-guest` endpoints — no credentials required.
89- Page size is fixed at 10 results per page.
90- LinkedIn may rate-limit; the CLI retries 429/5xx with exponential backoff. Keep volume low (see ToS note above).
91- Job IDs are numeric (e.g. `4426311357`) — pass them as-is to `detail`.
gabrielmoreira