You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -48,10 +48,6 @@ What has Anthropic been posting about recently? https://www.linkedin.com/company
48
48
|`get_job_details`| Get detailed information about a specific job posting | Working |
49
49
|`close_session`| Close browser session and clean up resources | Working |
50
50
51
-
Tool responses keep readable `sections` text and may also include a compact `references` map keyed by section. Each reference includes a typed target, a relative LinkedIn path (or absolute external URL), and a short label/context when available.
52
-
53
-
When one section fails but the overall tool call still completes, responses may also include `section_errors`. Each entry contains structured diagnostics for that section, including the error type/message, a compact runtime summary, trace/log locations, matching-open-issue hints when available, and the path to a generated issue-ready markdown report with the full session details.
54
-
55
51
> [!IMPORTANT]
56
52
> **Breaking change:** LinkedIn recently made some changes to prevent scraping. The newest version uses [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python) with persistent browser profiles instead of Playwright with session files. Old `session.json` files and `LINKEDIN_COOKIE` env vars are no longer supported. Run `--login` again to create a new profile + cookie file that can be mounted in docker. 02/2026
57
53
@@ -173,6 +169,47 @@ parallel. Use `--log-level DEBUG` to see scraper lock wait/acquire/release logs.
**One-click installation** for Claude Desktop users:
177
+
178
+
1. Download the latest `.mcpb` artifact from [releases](https://github.com/stickerdaniel/linkedin-mcp-server/releases/latest)
179
+
2. Double-click to install it into Claude Desktop
180
+
3. Restart Claude Desktop
181
+
4. Call any LinkedIn tool
182
+
183
+
On startup, the MCP Bundle starts preparing the shared Patchright Chromium browser cache in the background. If you call a tool too early, Claude will surface a setup-in-progress error. On the first tool call that needs authentication, the server opens a LinkedIn login browser window and asks you to retry after sign-in.
184
+
185
+
### MCP Bundle Setup Help
186
+
187
+
<details>
188
+
<summary><b>❗ Troubleshooting</b></summary>
189
+
190
+
**First-time setup behavior:**
191
+
192
+
- Claude Desktop starts the bundle immediately; browser setup continues in the background
193
+
- If the Patchright Chromium browser is still downloading, retry the tool after a short wait
194
+
- Managed browser downloads are shared under `~/.linkedin-mcp/patchright-browsers/`
195
+
196
+
**Login issues:**
197
+
198
+
- Make sure you have only one active LinkedIn session at a time
199
+
- LinkedIn may require a login confirmation in the LinkedIn mobile app for `--login`
200
+
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp --login` which opens a browser where you can solve captchas manually. See the [uvx setup](#-uvx-setup-recommended---universal) for prerequisites.
201
+
202
+
**Timeout issues:**
203
+
204
+
- If pages fail to load or elements aren't found, try increasing the timeout: `--timeout 10000`
205
+
- Users on slow connections may need higher values (e.g., 15000-30000ms)
206
+
- Can also set via environment variable: `TIMEOUT=10000`
207
+
208
+
</details>
209
+
210
+
<br/>
211
+
<br/>
212
+
176
213
## 🐳 Docker Setup
177
214
178
215
**Prerequisites:** Make sure you have [Docker](https://www.docker.com/get-started/) installed and running, and [uv](https://docs.astral.sh/uv/getting-started/installation/) installed on the host for the one-time `--login` step.
@@ -293,47 +330,6 @@ Runtime server logs are emitted by FastMCP/Uvicorn.
**One-click installation** for Claude Desktop users:
301
-
302
-
1. Download the latest `.mcpb` artifact from [releases](https://github.com/stickerdaniel/linkedin-mcp-server/releases/latest)
303
-
2. Double-click to install it into Claude Desktop
304
-
3. Restart Claude Desktop
305
-
4. Call any LinkedIn tool
306
-
307
-
On startup, the MCP Bundle starts preparing the shared Patchright Chromium browser cache in the background. If you call a tool too early, Claude will surface a setup-in-progress error. On the first tool call that needs authentication, the server opens a LinkedIn login browser window and asks you to retry after sign-in.
308
-
309
-
### MCP Bundle Setup Help
310
-
311
-
<details>
312
-
<summary><b>❗ Troubleshooting</b></summary>
313
-
314
-
**First-time setup behavior:**
315
-
316
-
- Claude Desktop starts the bundle immediately; browser setup continues in the background
317
-
- If the Patchright Chromium browser is still downloading, retry the tool after a short wait
318
-
- Managed browser downloads are shared under `~/.linkedin-mcp/patchright-browsers/`
319
-
320
-
**Login issues:**
321
-
322
-
- Make sure you have only one active LinkedIn session at a time
323
-
- LinkedIn may require a login confirmation in the LinkedIn mobile app for `--login`
324
-
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp --login` which opens a browser where you can solve captchas manually. See the [uvx setup](#-uvx-setup-recommended---universal) for prerequisites.
325
-
326
-
**Timeout issues:**
327
-
328
-
- If pages fail to load or elements aren't found, try increasing the timeout: `--timeout 10000`
329
-
- Users on slow connections may need higher values (e.g., 15000-30000ms)
330
-
- Can also set via environment variable: `TIMEOUT=10000`
331
-
332
-
</details>
333
-
334
-
<br/>
335
-
<br/>
336
-
337
333
## 🐍 Local Setup (Develop & Contribute)
338
334
339
335
Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture guidelines and checklists. Please [open an issue](https://github.com/stickerdaniel/linkedin-mcp-server/issues) first to discuss the feature or bug fix before submitting a PR.
0 commit comments