Skip to content
cccskills
FreePublished on GitHub

linkedin-search

Search LinkedIn’s public job listings by location and role, filter by posting date or workplace type, and retrieve a specific listing’s full description, seniority, and employment details using its job ID or URL.

OriginalShow the original 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.

Works withLinkedIn
See how to install

Good for

  • Finding jobs in a specific country or city
  • Searching for remote or hybrid roles
  • Checking recently posted openings
  • Reading a specific job listing’s full details

Files included (21)

  • SKILL.md4.6 KB
  • cli/package.json577 B
  • cli/README.md2.3 KB
  • cli/src/cli.ts7.9 KB
  • cli/src/commands/detail.ts2.8 KB
  • cli/src/commands/search.ts2.5 KB
  • cli/src/helpers.ts10.1 KB
  • cli/tests/cli-flag-validation.test.ts7.8 KB
  • cli/tests/detail-description-cli.test.ts3.1 KB
  • cli/tests/detail-input.test.ts2.5 KB
  • cli/tests/fixtures/detail-orbis-excerpt.html3.7 KB
  • cli/tests/fixtures/README.md1.2 KB
  • cli/tests/fixtures/search-cards.json6.3 KB
  • cli/tests/fixtures/search-cards.provenance.md1.2 KB
  • cli/tests/helpers.ts2.3 KB
  • cli/tests/parsing.test.ts12.4 KB
  • cli/tests/request-timeout.test.ts922 B
  • cli/tests/retry-backoff.test.ts2.0 KB
  • cli/tests/search.test.ts1.7 KB
  • cli/tsconfig.json305 B
  • url-reference.md1.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

FormatBest for
jsonDefault — programmatic use, passing IDs to detail
tableQuick human-readable scanning
plainReading 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

freehire-search

FreeSummary

Search software, data, and engineering jobs across countries through freehire.me. Filter by skills, seniority, location, posting age, and remote work, and retrieve full descriptions to assess opportunities or inspect a specific posting.

  • Find remote React jobs in the EU
  • Search recent DevOps openings in Germany
  • Compare senior backend engineering roles
MadsLorentzen/ai-job-search53.6KUpdated Oct 18, 2026

Evaluate job postings against a candidate’s background, tailor a CV and cover letter to the role, record drafted applications, and prepare interview answers that connect relevant experience to the employer’s requirements.

  • Assessing whether a job matches your experience
  • Tailoring a CV and cover letter to a role
  • Preparing interview answers and questions
MadsLorentzen/ai-job-search53.6KUpdated Oct 18, 2026

jobbank-search

FreeSummary

Find Danish jobs for graduates and highly educated candidates through Akademikernes Jobbank. Filter by industry, education, region, or remote work, then retrieve posting details for graduate trainee, Ph.d., postdoc, and other roles.

  • Find graduate trainee positions
  • Search for Ph.d. and postdoc openings
  • Look for fully remote software jobs
MadsLorentzen/ai-job-search53.6KUpdated Oct 18, 2026

Search Danish job listings on Jobdanmark.dk by role, location, and employment type. Retrieve matching vacancies, read posting details and application deadlines, or view current job counts across categories to explore available work.

  • Find full-time IT jobs in Copenhagen
  • Look for student jobs in Aarhus
  • Check a job description and application deadline
MadsLorentzen/ai-job-search53.6KUpdated Oct 18, 2026

jobindex-search

FreeSummary

Find Danish job listings on Jobindex.dk using job titles, skills, companies, or city names. Filter by posting age, sort by relevance or date, and retrieve full descriptions, employment conditions, deadlines, and application links.

  • Finding Danish jobs by role or skill
  • Searching for jobs using a Danish city name
  • Reviewing jobs posted today or during the past week
MadsLorentzen/ai-job-search53.6KUpdated Oct 18, 2026

jobnet-search

FreeSummary

Search Denmark’s official Jobnet.dk portal by occupation, region, distance, working hours, or employment duration. Retrieve full job descriptions, employer contacts, deadlines, and application links, and explore Danish job titles to refine searches.

  • Finding Danish jobs by occupation and region
  • Searching within a set distance of a postal code
  • Filtering by working hours and employment duration
MadsLorentzen/ai-job-search53.6KUpdated Oct 18, 2026

See all skills by MadsLorentzen

Report a problem with this skill