linkedin-search

Search LinkedIn public job listings and fetch job details via a Bun CLI.

Updated Sep 23, 2026
One-click install
npx skills add https://github.com/zaheer037/job-search --skill linkedin-search-zaheer037
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linkedin-search
Source: https://github.com/zaheer037/job-search/tree/main/.agents/skills/linkedin-search
Command: npx skills add https://github.com/zaheer037/job-search --skill linkedin-search-zaheer037

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually browsing LinkedIn for job openings across locations and filtering by recency or workplace type is slow and repetitive. This Skill lets an agent query LinkedIn's public jobs-guest endpoints directly, returning structured job listings and full posting details without authentication or API keys. ## Core Features & Use Cases - Job Search: Search listings by keyword and explicit location (any city, country, or "Remote"), with filters for posting recency (days or minutes), workplace type (remote/hybrid/onsite), pagination, and result limits. - Job Detail Lookup: Fetch a full posting by ID, URL, or URN, including description, seniority, employment type, job function, industries, and active/closed status. - Structured Output: Results in JSON, table, or plain formats, with JSON errors on stderr and exit code 1 for programmatic handling. - Use Case: Ask your agent to find data engineer roles in Bengaluru posted in the last 30 days, then pull the full description of a promising listing to evaluate fit before tailoring a CV. ## Quick Start Use the linkedin-search skill to find remote product manager jobs posted in the last 7 days and show the results as a table.

Frequently Asked Questions about linkedin-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search LinkedIn jobs from the command line?▼

Run the CLI with bun: bun run src/cli.ts search -q "data engineer" -l "Berlin, Germany" --jobage 30 --format table. The location flag is required, and results come back as JSON, table, or plain text.

How to filter LinkedIn job listings by remote or posting date?▼

Use --remote with remote, hybrid, or onsite to filter workplace type, and --jobage with 1, 7, 14, or 30 days for recency. For sub-day precision, use --jobage-minutes instead, since the two flags conflict.

Does LinkedIn job search require an API key or login?▼

No authentication or API key is required. The CLI reads LinkedIn's public jobs-guest endpoints directly, so it runs with just bun installed and zero runtime dependencies.

Can I get the full description of a specific LinkedIn job posting?▼

Yes, run the detail command with a job ID, jobs/view URL, or URN: bun run src/cli.ts detail 4426311357 --format plain. It returns the description, seniority, employment type, job function, industries, and active or closed status.

Why does LinkedIn job scraping fail or return errors?▼

LinkedIn rate-limits automated access, returning 429 or 5xx responses; the CLI retries these with exponential backoff up to six attempts. Automated access also violates LinkedIn's Terms of Service, so keep request volume low and avoid commercial or bulk use.

What are the limitations of scraping LinkedIn public job pages?▼

Results are capped at 10 per page, parsing depends on LinkedIn's current HTML markup, and closed-posting detection relies on a banner whose absence is not proof a job is open. Heavy usage risks rate limiting and breaches LinkedIn's ToS.