Feat/saved jobs fix and progress v2

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,45 @@
+---
+name: Bug Report
+about: Create a report to help us improve the LinkedIn MCP server
+title: '[BUG] '
+labels: ['bug']
+assignees: ''
+
+---
+
+## Installation Method
+- [ ] Docker (specify docker image version/tag): _._._
+- [ ] Claude Desktop DXT extension (specify docker image version/tag): _._._
+- [ ] Local Python setup
+
+## When does the error occur?
+- [ ] At startup
+- [ ] During tool call (specify which tool):
+  - [ ] get_person_profile
+  - [ ] get_company_profile
+  - [ ] get_job_details
+  - [ ] get_saved_jobs
+  - [ ] search_jobs
+  - [ ] close_session
+
+## MCP Client Configuration
+
+**Claude Desktop Config** (`/Users/[username]/Library/Application Support/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "linkedin": {
+      // Your configuration here (remove sensitive credentials)
+    }
+  }
+}
+```
+
+## MCP Client Logs
+**Claude Desktop Logs** (`/Users/[username]/Library/Logs/Claude/mcp-server-LinkedIn MCP Server.log`):
+```
+Paste relevant log entries here
+```
+
+## Error Description
+What went wrong and what did you expect to happen?

.github/ISSUE_TEMPLATE/documentation_issue.md

@@ -0,0 +1,50 @@
+---
+name: Documentation Issue
+about: Report problems with README, setup instructions, or other documentation
+title: '[DOCS] '
+labels: ['documentation']
+assignees: ''
+
+---
+
+## Documentation Problem
+**What documentation issue did you find?**
+- [ ] Incorrect/outdated setup instructions
+- [ ] Missing information
+- [ ] Unclear/confusing explanations
+- [ ] Broken links
+- [ ] Example code doesn't work
+- [ ] Missing prerequisites
+- [ ] Inconsistent information
+- [ ] Typos/grammar issues
+- [ ] Other: ___________
+
+## Location
+**Where is the documentation issue?**
+- [ ] README.md
+- [ ] Code comments
+- [ ] Error messages
+- [ ] CLI help text
+- [ ] Other: ___________
+
+**Specific section/line:**
+___________
+
+## Current Documentation
+**What does the documentation currently say?**
+```
+Paste the current text or link to the specific section
+```
+
+## Problem Description
+**What's wrong or confusing about it?**
+A clear description of why this documentation is problematic.
+
+## Suggested Fix
+**What should it say instead?**
+```
+Suggested replacement text or improvements
+```
+
+## Additional Context
+Add any other context, screenshots, or examples that would help improve the documentation.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature Request
+about: Suggest an idea for the LinkedIn MCP server
+title: '[FEATURE] '
+labels: ['enhancement']
+assignees: ''
+
+---
+
+## Feature description
+Describe what you want to happen.
+
+## Use case
+Why this feature is useful.
+
+## Suggested implementation
+If you have a specific idea for how to implement this feature, please describe it here.
+
+## Additional context
+Add any other details that would help.

.github/workflows/claude.yml

@@ -0,0 +1,49 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@68cfeead1890300cc87935dbe2c023825be87b8a # v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'

CLAUDE.md

@@ -1 +1 @@
-AGENTS.md
+AGENTS.md

README.md

@@ -44,6 +44,7 @@ Through this LinkedIn MCP server, AI assistants like Claude can connect to your
 | `search_jobs` | Search for jobs with keywords and location filters | working |
 | `search_people` | Search for people by keywords and location | working |
 | `get_job_details` | Get detailed information about a specific job posting | working |
+| `get_saved_jobs` | Get saved/bookmarked jobs from your LinkedIn job tracker | [#330](https://github.com/stickerdaniel/linkedin-mcp-server/issues/330) |
 | `close_session` | Close browser session and clean up resources | working |
 
 <br/>

docs/docker-hub.md

@@ -9,6 +9,7 @@ A Model Context Protocol (MCP) server that connects AI assistants to LinkedIn. A
 - **Company Profiles**: Extract comprehensive company data
 - **Job Details**: Retrieve job posting information
 - **Job Search**: Search for jobs with keywords and location filters
+- **Saved Jobs**: Get saved/bookmarked jobs from your LinkedIn job tracker
 - **People Search**: Search for people by keywords and location
 - **Person Posts**: Get recent activity/posts from a person's profile
 - **Company Posts**: Get recent posts from a company's LinkedIn feed

linkedin_mcp_server/scraping/extractor.py

@@ -6,6 +6,7 @@
 from dataclasses import dataclass
 import logging
 import re
+from collections.abc import Awaitable, Callable
 from typing import TYPE_CHECKING, Any, Literal
 from urllib.parse import parse_qs, quote_plus, urljoin, urlparse
 
@@ -2129,6 +2130,163 @@ async def search_jobs(
             result["section_errors"] = section_errors
         return result
 
+    _EXTRACT_JOB_IDS_JS = """() => {
+        const seen = new Set();
+        const ids = [];
+        document.querySelectorAll('a[href*="/jobs/view/"]').forEach(a => {
+            const match = a.href.match(/\\/jobs\\/view\\/(\\d+)/);
+            if (match && !seen.has(match[1])) { seen.add(match[1]); ids.push(match[1]); }
+        });
+        return ids;
+    }"""
+
+    _EXTRACT_MAIN_TEXT_JS = """() => {
+        const main = document.querySelector('main');
+        return main ? main.innerText : document.body.innerText;
+    }"""
+
+    _EXTRACT_MAX_PAGE_JS = """() => {
+        const pageNumbers = Array.from(
+            document.querySelectorAll('button[aria-label^="Page "]')
+        )
+            .map(button => {
+                const label = button.getAttribute('aria-label') || '';
+                const match = label.match(/^Page (\\d+)$/);
+                return match ? Number(match[1]) : null;
+            })
+            .filter(page => Number.isInteger(page));
+        return pageNumbers.length ? Math.max(...pageNumbers) : 1;
+    }"""
+
+    async def scrape_saved_jobs(
+        self,
+        max_pages: int = 10,
+        on_progress: Callable[[int, int, str], Awaitable[None]] | None = None,
+    ) -> dict[str, Any]:
+        """Scrape the user's saved/bookmarked jobs from the jobs tracker page.
+
+        Automatically paginates through all pages using numbered page buttons.
+        Extracts job IDs from link hrefs (``/jobs/view/<id>/``) since they are
+        not present in the page's innerText.
+
+        Args:
+            max_pages: Safety cap on pages to scrape (default 10).
+            on_progress: Optional async callback ``(page, total, message)``
+                invoked after each page is scraped.
+
+        Returns:
+            {url, sections: {name: text}, job_ids: list[str]}
+        """
+        url = "https://www.linkedin.com/jobs-tracker/"
+        extracted = await self.extract_page(url, "saved_jobs")
+
+        all_text_parts: list[str] = []
+        all_job_ids: list[str] = []
+
+        if extracted.text:
+            all_text_parts.append(extracted.text)
+
+        # Collect job IDs from page 1.
+        page_ids: list[str] = await self._page.evaluate(self._EXTRACT_JOB_IDS_JS)
+        all_job_ids.extend(page_ids)
+        logger.info("Page 1: found %d job IDs", len(page_ids))
+
+        # LinkedIn can render a sliding window of numbered buttons, so refresh
+        # the largest visible page number as pagination advances.
+        total_pages = min(
+            max(await self._page.evaluate(self._EXTRACT_MAX_PAGE_JS), 1),
+            max_pages,
+        )
+        logger.info("Total pages detected: %d", total_pages)
+
+        if on_progress:
+            await on_progress(1, total_pages, "Fetched saved jobs page 1")
+
+        # Paginate through remaining pages using numbered page buttons.
+        for page_num in range(2, max_pages + 1):
+            page_btn = self._page.locator(f'button[aria-label="Page {page_num}"]')
+            if not await page_btn.count():
+                logger.info(
+                    "No page %d button found — stopping at page %d",
+                    page_num,
+                    page_num - 1,
+                )
+                break
+
+            logger.info("Navigating to saved jobs page %d", page_num)
+            prev_ids = set(all_job_ids)
+            await page_btn.scroll_into_view_if_needed()
+            await page_btn.click()
+            await asyncio.sleep(_NAV_DELAY)
+
+            # Wait for the DOM to reflect new job links.
+            try:
+                await self._page.wait_for_function(
+                    """(prevIds) => {
+                        const prev = new Set(prevIds);
+                        const links = document.querySelectorAll('a[href*="/jobs/view/"]');
+                        for (const a of links) {
+                            const match = a.href.match(/\\/jobs\\/view\\/(\\d+)/);
+                            if (match && !prev.has(match[1])) return true;
+                        }
+                        return false;
+                    }""",
+                    arg=list(prev_ids),
+                    timeout=15000,
+                )
+            except PlaywrightTimeoutError:
+                logger.info("No new job IDs appeared on page %d — stopping", page_num)
+                break
+
+            await scroll_to_bottom(self._page, pause_time=0.5, max_scrolls=3)
+
+            raw = await self._page.evaluate(self._EXTRACT_MAIN_TEXT_JS)
+            if raw:
+                cleaned = strip_linkedin_noise(raw)
+                if cleaned:
+                    all_text_parts.append(cleaned)
+
+            page_ids = await self._page.evaluate(self._EXTRACT_JOB_IDS_JS)
+            new_ids = [jid for jid in page_ids if jid not in prev_ids]
+            logger.info("Page %d: found %d new job IDs", page_num, len(new_ids))
+            if not new_ids:
+                break
+            all_job_ids.extend(new_ids)
+
+            total_pages = max(
+                total_pages,
+                page_num,
+                min(
+                    max(await self._page.evaluate(self._EXTRACT_MAX_PAGE_JS), 1),
+                    max_pages,
+                ),
+            )
+
+            if on_progress:
+                await on_progress(
+                    page_num, total_pages, f"Fetched saved jobs page {page_num}"
+                )
+
+        # Append a summary of job IDs so they are always visible in the text.
+        id_summary = "\n".join(
+            f"- Job ID: {jid} (https://www.linkedin.com/jobs/view/{jid}/)"
+            for jid in all_job_ids
+        )
+        if id_summary:
+            all_text_parts.append(f"--- Saved Job IDs ---\n{id_summary}")
+
+        sections: dict[str, str] = {}
+        if all_text_parts:
+            sections["saved_jobs"] = "\n\n".join(all_text_parts)
+
+        logger.info("Total saved jobs found: %d across all pages", len(all_job_ids))
+
+        return {
+            "url": url,
+            "sections": sections,
+            "job_ids": all_job_ids,
+        }
+
     async def search_people(
         self,
         keywords: str,