linkedin-relay-mcp 3.24.0 → 3.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: linkedin-relay
3
- description: Research LinkedIn from the user's own account — find people by company, past company, school, place, title, degree or whose connections they are, search posts, companies, groups, events, courses, products, services and schools, hunt jobs with every filter LinkedIn has and collect their apply links, read profiles, read the chronological feed — and, through the lnrelay CLI, post (text, image or video), comment, reply, react, delete and edit the user's own profile (headline, About, photo, cover image, roles, skills) under the approval mode the owner chose. Use when looking at the user's own network (connections, followers, who they follow, invitations they sent, who viewed their profile) or their saved items (saved posts, courses, the job tracker), when finding or evaluating people (who works or worked somewhere, alumni, people in a role or a city, someone's connections), companies, groups, events, courses, posts on a topic, roles or job openings on LinkedIn, when the user wants job listings or application links, when reading what the user's network is posting, when the user wants to read their LinkedIn messages or draft replies to them, or when the user asks to post, engage or update their profile on LinkedIn. Cannot send messages, connect, or apply to jobs: those do not exist.
3
+ description: Research LinkedIn from the user's own account — find people by company, past company, school, place, title, degree or whose connections they are, search posts, companies, groups, events, courses, products, services and schools, hunt jobs with every filter LinkedIn has and collect their apply links, read profiles, read the chronological feed — and, through the lnrelay CLI, post (text, image or video), comment, reply, react, delete and edit the user's own profile (headline, About, photo, cover image, roles, skills) under the approval mode the owner chose. Use when looking at the user's own network (connections, followers, who they follow, invitations they sent, who viewed their profile, their notifications) or their saved items (saved posts, courses, the job tracker), when finding or evaluating people (who works or worked somewhere, alumni, people in a role or a city, someone's connections), companies, groups, events, courses, posts on a topic, roles or job openings on LinkedIn, when the user wants job listings or application links, when reading what the user's network is posting, when the user wants to read their LinkedIn messages or draft replies to them, or when the user asks to post, engage or update their profile on LinkedIn. Cannot send messages, connect, or apply to jobs: those do not exist.
4
4
  ---
5
5
 
6
6
  # linkedin-relay
@@ -271,9 +271,9 @@ Every filter LinkedIn offers for this query, each with its options' `value`, `la
271
271
 
272
272
  ### `profile` — mid. Read only the finalists.
273
273
  ```
274
- profile id:"<public-id | profile id | urn | linkedin.com/in/… URL>" [contact] [compact] [fields:"a,b"]
274
+ profile id:"<public-id | profile id | urn | linkedin.com/in/… URL>" [contact] [posts:N] [skills] [recommendations] [compact] [fields:"a,b"]
275
275
  ```
276
- CLI: `lnrelay profile <id|url> [--contact] [--compact | --fields a,b,c]`. The whole profile page: `name`,
276
+ CLI: `lnrelay profile <id|url> [--contact] [--posts N] [--skills] [--recommendations] [--compact | --fields a,b,c]`. The whole profile page: `name`,
277
277
  `headline`, `about`, `location`, `industry`, the top card (`title`, `company`, `school`), and every
278
278
  section that has entries:
279
279
  - `experience`: every role, newest company first: `title`, `company`, `companyId` (what `company`
@@ -288,7 +288,11 @@ section that has entries:
288
288
 
289
289
  Descriptions make a full profile long. **`compact:true`** turns each role, school and entry into
290
290
  one line and drops descriptions (About stays); `fields:"name,experience"` keeps only those.
291
- Recommendations are not read.
291
+
292
+ **`recommendations:true`** (`--recommendations`) adds `recommendations`: `received` and `given`, each
293
+ `[{name, url, headline, degree, context, text}]`, where `context` is the date and how they worked
294
+ together, in the user's LinkedIn language. 15 a page, both ways: 2 page calls for most people. The
295
+ texts are long; use `fields` to keep only what you need. It failing leaves `recommendationsError`.
292
296
 
293
297
  **`contact:true`** (`--contact`) adds `contact`, the profile's Contact info as it shows to the user,
294
298
  for one more profile read: `email`, `websites` [{`url`, `type`}], `phones` [{`number`, `type`}],
@@ -296,6 +300,15 @@ for one more profile read: `email`, `websites` [{`url`, `type`}], `phones` [{`nu
296
300
  own name. In the profiles read, only a connection showed an email. It failing leaves `contactError`
297
301
  and the rest of the profile. Ask for it only when the user wants to reach someone.
298
302
 
303
+ **`posts:N`** (`--posts N`) adds `posts`, their N newest posts, as `search posts` rows: the posts
304
+ search filtered to posts from them, newest first, on the search budget (1 call per 20). It failing
305
+ leaves `postsError`. For their posts on a topic, use `search posts` with `from:[id]` and keywords.
306
+
307
+ **`skills:true`** (`--skills`) reads every skill in place of the top 20, from the profile's Skills
308
+ page: 1 page call per 10 skills (47 skills is 6 calls). Use it only when the skills decide
309
+ something; `counts.skills` says how many there are. It failing keeps the top 20 and leaves
310
+ `skillsError`.
311
+
299
312
  ### `feed` — mid. What the network is posting.
300
313
  ```
301
314
  feed [limit:1-20]
@@ -431,6 +444,16 @@ With a list, its rows, 50 a call: people (connections, following, followers) as
431
444
  does neither.
432
445
  - Not available: received invitations, newsletters, "people you may know".
433
446
 
447
+ ### `notifications` — 1 page call per 25. The bell.
448
+ ```
449
+ notifications [unread] [limit:N] [compact]
450
+ ```
451
+ CLI: `lnrelay notifications [--unread] [--limit N] [--compact]`. Newest first: `unseen` (the bell's
452
+ count), and items as `kind` (LinkedIn's own name, e.g. `FOLLOW_PAGE_HERO`, `LEARNING_RECS_FOR_JOB_SEEKERS_BY_STAGE_INAPP`), `text`,
453
+ `detail`, `at` (ISO), `read`, `url` (where it goes), `from` (who or what it is about).
454
+ - Reading here does not mark them seen; opening the page in the browser does.
455
+ - Not available: the page's tabs (my posts, mentions, jobs). Filter on `kind` instead.
456
+
434
457
  ### `viewers` — 2 page calls. Who viewed the user's profile.
435
458
  ```
436
459
  viewers [compact]
package/README.md CHANGED
@@ -39,7 +39,7 @@ claude mcp add linkedin-relay -s user -- bun "$(npm root -g)/linkedin-relay-mcp/
39
39
  |---|---|
40
40
  | `people` · `people-filters` | people search with every filter: company, past company, school, place, degree, title, someone's connections |
41
41
  | `search` · `search-filters` | posts, companies, groups, events, courses, products, services, schools — each with its filters |
42
- | `profile` · `feed` | a profile in full — name, about, every role with dates, education, skills and the other sections, and with `--contact` its contact info — and your feed |
42
+ | `profile` · `feed` | a profile in full — name, about, every role with dates, education, skills and the other sections; with `--contact` its contact info, `--posts N` their newest posts, `--skills` every skill, `--recommendations` those received and given — and your feed |
43
43
  | `jobs` · `job` · `job-filters` | job search with every filter, several keyword sets merged in one call, and apply links |
44
44
  | `post` · `reactions` | a post's comment thread, and who engaged |
45
45
  | `scheduled` · `experience` · `skills` | your queued posts, and your own roles and skills |
@@ -48,6 +48,7 @@ claude mcp add linkedin-relay -s user -- bun "$(npm root -g)/linkedin-relay-mcp/
48
48
  | `events` · `event` | the events page's recommended and Premium events, and any event in full: when, where, attendees, organiser, its site |
49
49
  | `network` | your My Network: connections, following, followers, pages, events, groups, invitations sent — or the count of each |
50
50
  | `viewers` | who viewed your profile: the total, the viewers LinkedIn names (3 on a free account), anonymous ones, the private-mode count |
51
+ | `notifications` | your notifications, newest first, read or not — without marking them seen |
51
52
  | `inbox` · `messages` · `draft` · `drafts` | read your messages without marking them read; draft replies locally — nothing is ever sent |
52
53
  | `sync` · `local` · `connections` · `my-posts` | fill a local cache, then query it for free |
53
54
  | `whoami` · `doctor` · `risk` · `budget` · `cache-status` | session, standing and spend |