$npx -y skills add markes76/claude-code-gui --skill docsYou have access to linkedin-cli, an unofficial LinkedIn CLI tool. Use it to read information from the user's LinkedIn account.
| 1 | # linkedin-cli skill |
| 2 | |
| 3 | You have access to `linkedin-cli`, an unofficial LinkedIn CLI tool. Use it to read information from the user's LinkedIn account. |
| 4 | |
| 5 | ## Prerequisites |
| 6 | |
| 7 | The user must be authenticated. Check first with: |
| 8 | ```bash |
| 9 | linkedin status --json |
| 10 | ``` |
| 11 | If not authenticated, instruct them to run `linkedin login`. |
| 12 | |
| 13 | ## Golden Rule |
| 14 | |
| 15 | **Always use `--json` when fetching data for processing.** Plain output is for humans; `--json` gives you clean structured data you can parse, filter, and analyze. |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | ## Commands Reference |
| 20 | |
| 21 | ### Authentication |
| 22 | |
| 23 | ```bash |
| 24 | linkedin login # Open browser for manual LinkedIn login |
| 25 | linkedin status --json # Check session validity + current user info |
| 26 | linkedin logout # Clear saved session |
| 27 | ``` |
| 28 | |
| 29 | ### Profile |
| 30 | |
| 31 | ```bash |
| 32 | linkedin profile --json # Your full profile |
| 33 | linkedin profile https://www.linkedin.com/in/johndoe --json # Another person's profile |
| 34 | ``` |
| 35 | |
| 36 | **Output fields:** `firstName`, `lastName`, `headline`, `summary`, `locationName`, `industryName`, `publicIdentifier`, `entityUrn` |
| 37 | |
| 38 | ### Connections |
| 39 | |
| 40 | ```bash |
| 41 | linkedin connections --json # List connections (default 25) |
| 42 | linkedin connections --count --json # Just the total count |
| 43 | linkedin connections --search "John" --json # Filter by name |
| 44 | linkedin connections --recent --json # Most recently connected |
| 45 | linkedin connections --limit 100 --json # Up to 100 connections |
| 46 | ``` |
| 47 | |
| 48 | **Output fields (array):** `entityUrn`, `firstName`, `lastName`, `headline`, `publicIdentifier`, `connectedAt` (epoch ms) |
| 49 | |
| 50 | ### Feed & Posts |
| 51 | |
| 52 | ```bash |
| 53 | linkedin feed --json # Recent feed (default 20) |
| 54 | linkedin feed --mine --json # Only your posts |
| 55 | linkedin feed --mine --stats --json # Your posts with engagement stats |
| 56 | linkedin feed --limit 50 --json # More items |
| 57 | linkedin posts <post-url> --json # Specific post with comments |
| 58 | ``` |
| 59 | |
| 60 | **Feed item fields:** `entityUrn`, `actor` (name, description), `commentary.text.text`, `socialDetail.totalSocialActivityCounts` (numLikes, numComments, numShares), `createdAt` |
| 61 | |
| 62 | ### Messages |
| 63 | |
| 64 | ```bash |
| 65 | linkedin messages --json # Recent conversations |
| 66 | linkedin messages --unread --json # Unread only |
| 67 | linkedin messages --search "keyword" --json # Search messages |
| 68 | linkedin messages --limit 50 --json # More conversations |
| 69 | ``` |
| 70 | |
| 71 | **Conversation fields:** `entityUrn`, `participants`, `lastActivityAt`, `read`, `events` |
| 72 | |
| 73 | ### Notifications |
| 74 | |
| 75 | ```bash |
| 76 | linkedin notifications --json # Recent notifications |
| 77 | linkedin notifications --unread --json # Unread only |
| 78 | ``` |
| 79 | |
| 80 | **Fields:** `entityUrn`, `publishedAt`, `read`, `headline.text`, `subtext.text` |
| 81 | |
| 82 | ### Network |
| 83 | |
| 84 | ```bash |
| 85 | linkedin network invitations --json # Received connection requests |
| 86 | linkedin network invitations --sent --json # Sent requests |
| 87 | linkedin network suggestions --json # People you may know |
| 88 | ``` |
| 89 | |
| 90 | ### Analytics |
| 91 | |
| 92 | ```bash |
| 93 | linkedin analytics --json # Post performance last 30 days |
| 94 | linkedin analytics --post <post-url> --json # Specific post analytics |
| 95 | linkedin analytics --followers --json # Follower growth/demographics |
| 96 | ``` |
| 97 | |
| 98 | **Fields:** `totalImpressions`, `uniqueImpressions`, `totalEngagements`, `engagementRate`, `totalClicks`, `totalReactions`, `totalComments`, `totalReposts` |
| 99 | |
| 100 | ### Search |
| 101 | |
| 102 | ```bash |
| 103 | linkedin search people "AI engineer" --json # Search people |
| 104 | linkedin search companies "cybersecurity" --json # Search companies |
| 105 | linkedin search jobs "product manager" --json # Search jobs |
| 106 | linkedin search posts "enterprise AI" --json # Search content/posts |
| 107 | linkedin search people "designer" --limit 25 --json # More results |
| 108 | ``` |
| 109 | |
| 110 | **Result fields:** `entityUrn`, `title.text`, `primarySubtitle.text`, `secondarySubtitle.text`, `navigationUrl`, `publicIdentifier` |
| 111 | |
| 112 | ### Jobs |
| 113 | |
| 114 | ```bash |
| 115 | linkedin jobs saved --json # Your saved jobs |
| 116 | linkedin jobs applied --json # Jobs you applied to |
| 117 | linkedin jobs recommended --json # Recommended for you |
| 118 | ``` |
| 119 | |
| 120 | **Fields:** `entityUrn`, `title`, `companyName`, `locationName`, `listedAt` |
| 121 | |
| 122 | --- |
| 123 | |
| 124 | ## Global Flags |
| 125 | |
| 126 | | Flag | Description | |
| 127 | |------|-------------| |
| 128 | | `--json` | Structured JSON output (always use for data) | |
| 129 | | `--no-color` | Disable color (useful in CI/pipes) | |
| 130 | | `--limit <n>` | Max results (varies by command) | |
| 131 | |
| 132 | --- |
| 133 | |
| 134 | ## Natural Language → Command Mapping |
| 135 | |
| 136 | | User asks | Command to run | |
| 137 | |-----------|----------------| |
| 138 | | "How many connections do I have?" | `linkedin connections --count --json` | |
| 139 | | "Show me my recent posts with engagement" | `linkedin feed --mine --stats --json` | |
| 140 | | "Find AI engineers in my network" | `linkedin search people "AI engineer" --json` | |
| 141 | | "What are my unread messages?" | `linkedin messages --unread --json` | |
| 142 | | "Show my post analytics for last month" | `linkedin analytics --json` | |
| 143 | | "Who are my most recent connections?" | `linkedin connections --recent --limit 10 --jso |