universal-mcp-applications 0.1.25__py3-none-any.whl → 0.1.32__py3-none-any.whl

universal_mcp/applications/scraper/app.py

@@ -1,16 +1,14 @@
+import os
 from dotenv import load_dotenv
 
 load_dotenv()
 
-from typing import Any
+from typing import Any, Literal
 
 from loguru import logger
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
-from universal_mcp.applications.unipile import UnipileApp
-
-
 class ScraperApp(APIApplication):
     """
     Application for interacting with LinkedIn API.
@@ -18,126 +16,151 @@ class ScraperApp(APIApplication):
     """
 
     def __init__(self, integration: Integration, **kwargs: Any) -> None:
-        """
-        Initialize the ScraperApp.
-
-        Args:
-            integration: The integration configuration containing credentials and other settings.
-                         It is expected that the integration provides the necessary credentials
-                         for LinkedIn API access.
-        """
         super().__init__(name="scraper", integration=integration, **kwargs)
         if self.integration:
             credentials = self.integration.get_credentials()
             self.account_id = credentials.get("account_id")
-            self._unipile_app = UnipileApp(integration=self.integration)
         else:
             logger.warning("Integration not found")
             self.account_id = None
-            self._unipile_app = None
 
-    def linkedin_post_search(
-        self,
-        category: str = "posts",
-        api: str = "classic",
-        cursor: str | None = None,
-        limit: int | None = None,
-        keywords: str | None = None,
-        sort_by: str | None = None,
-        date_posted: str | None = None,
-        content_type: str | None = None,
-    ) -> dict[str, Any]:
+    @property
+    def base_url(self) -> str:
+        if not self._base_url:
+            unipile_dsn = os.getenv("UNIPILE_DSN")
+            if not unipile_dsn:
+                logger.error(
+                    "UnipileApp: UNIPILE_DSN environment variable is not set."
+                )
+                raise ValueError(
+                    "UnipileApp: UNIPILE_DSN environment variable is required."
+                )
+            self._base_url = f"https://{unipile_dsn}"
+        return self._base_url
+
+    @base_url.setter
+    def base_url(self, base_url: str) -> None:
+        self._base_url = base_url
+        logger.info(f"UnipileApp: Base URL set to {self._base_url}")
+
+    def _get_headers(self) -> dict[str, str]:
+        """
+        Get the headers for Unipile API requests.
+        Overrides the base class method to use X-Api-Key.
         """
-        Performs a general LinkedIn search for posts using keywords and filters like date and content type. It supports pagination and can utilize either the 'classic' or 'sales_navigator' API, searching broadly across the platform rather than fetching posts from a specific user's profile.
+        if not self.integration:
+            logger.warning(
+                "UnipileApp: No integration configured, returning empty headers."
+            )
+            return {}
+
+        api_key = os.getenv("UNIPILE_API_KEY")
+        if not api_key:
+            logger.error(
+                "UnipileApp: API key not found in integration credentials for Unipile."
+            )
+            return {  # Or return minimal headers if some calls might not need auth (unlikely for Unipile)
+                "Content-Type": "application/json",
+                "Cache-Control": "no-cache",
+            }
+
+        logger.debug("UnipileApp: Using X-Api-Key for authentication.")
+        return {
+            "x-api-key": api_key,
+            "Content-Type": "application/json",
+            "Cache-Control": "no-cache",  # Often good practice for APIs
+        }
+
+    def _get_search_parameter_id(self, param_type: str, keywords: str) -> str:
+        """
+        Retrieves the ID for a given LinkedIn search parameter by its name.
 
         Args:
-            category: Type of search to perform (defaults to "posts").
-            api: Which LinkedIn API to use - "classic" or "sales_navigator".
-            cursor: Pagination cursor for the next page of entries.
-            limit: Number of items to return (up to 50 for Classic search).
-            keywords: Keywords to search for.
-            sort_by: How to sort the results, e.g., "relevance" or "date".
-            date_posted: Filter posts by when they were posted.
-            content_type: Filter by the type of content in the post. Example: "videos", "images", "live_videos", "collaborative_articles", "documents"
+            param_type: The type of parameter to search for (e.g., "LOCATION", "COMPANY").
+            keywords: The name of the parameter to find (e.g., "United States").
 
         Returns:
-            A dictionary containing search results and pagination details.
+            The corresponding ID for the search parameter.
 
         Raises:
+            ValueError: If no exact match for the keywords is found.
             httpx.HTTPError: If the API request fails.
-
-        Tags:
-            linkedin, search, posts, api, scrapper, important
         """
+        url = f"{self.base_url}/api/v1/linkedin/search/parameters"
+        params = {
+            "account_id": self.account_id,
+            "keywords": keywords,
+            "type": param_type,
+        }
+
+        response = self._get(url, params=params)
+        results = self._handle_response(response)
+
+        items = results.get("items", [])
+        if items:
+            # Return the ID of the first result, assuming it's the most relevant
+            return items[0]["id"]
+
+        raise ValueError(f'Could not find a matching ID for {param_type}: "{keywords}"')
 
-        return self._unipile_app.search(
-            account_id=self.account_id,
-            category=category,
-            api=api,
-            cursor=cursor,
-            limit=limit,
-            keywords=keywords,
-            sort_by=sort_by,
-            date_posted=date_posted,
-            content_type=content_type,
-        )
 
     def linkedin_list_profile_posts(
         self,
-        identifier: str,
+        identifier: str,  # User or Company provider internal ID
         cursor: str | None = None,
-        limit: int | None = None,
+        limit: int | None = None,  # 1-100 (spec says max 250)
+        is_company: bool | None = None,
     ) -> dict[str, Any]:
         """
-        Fetches a paginated list of all LinkedIn posts from a specific user or company profile using their unique identifier. This function retrieves content directly from a profile, unlike `linkedin_post_search` which finds posts across LinkedIn based on keywords and other filters.
-
+        Fetches a paginated list of posts from a specific user or company profile using its provider ID. The `is_company` flag must specify the entity type. Unlike `linkedin_search_posts`, this function directly retrieves content from a known profile's feed instead of performing a global keyword search.
+        
         Args:
-            identifier: The entity's provider internal ID (LinkedIn ID).starts with ACo for users, while for companies it's a series of numbers.
-            cursor: Pagination cursor for the next page of entries.
-            limit: Number of items to return (1-100, though spec allows up to 250).
-
+            identifier: The entity's provider internal ID (LinkedIn ID).
+            cursor: Pagination cursor.
+            limit: Number of items to return (1-100, as per Unipile example, though spec allows up to 250).
+            is_company: Boolean indicating if the identifier is for a company.
+        
         Returns:
             A dictionary containing a list of post objects and pagination details.
-
+        
         Raises:
             httpx.HTTPError: If the API request fails.
-
+        
         Tags:
             linkedin, post, list, user_posts, company_posts, content, api, important
         """
-
-        return self._unipile_app.list_profile_posts(
-            identifier=identifier,
-            account_id=self.account_id,
-            cursor=cursor,
-            limit=limit,
-        )
-
-    def linkedin_retrieve_profile(
-        self,
-        identifier: str,
-    ) -> dict[str, Any]:
+        url = f"{self.base_url}/api/v1/users/{identifier}/posts"
+        params: dict[str, Any] = {"account_id": self.account_id}
+        if cursor:
+            params["cursor"] = cursor
+        if limit:
+            params["limit"] = limit
+        if is_company is not None:
+            params["is_company"] = is_company
+
+        response = self._get(url, params=params)
+        return response.json()
+
+    def linkedin_retrieve_profile(self, identifier: str) -> dict[str, Any]:
         """
-        Retrieves a specific LinkedIn user's profile by their unique identifier, which can be an internal provider ID or a public username. This function simplifies data access by delegating the actual profile retrieval request to the integrated Unipile application, distinct from functions that list posts or comments.
-
+        Fetches a specific LinkedIn user's profile using their public or internal ID. Unlike `linkedin_search_people`, which discovers multiple users via keywords, this function targets and retrieves detailed data for a single, known individual based on a direct identifier.
+        
         Args:
-            identifier: Can be the provider's internal id OR the provider's public id of the requested user.
-                       For example, for https://www.linkedin.com/in/manojbajaj95/, the identifier is "manojbajaj95".
-
+            identifier: Can be the provider's internal id OR the provider's public id of the requested user.For example, for https://www.linkedin.com/in/manojbajaj95/, the identifier is "manojbajaj95".
+        
         Returns:
             A dictionary containing the user's profile details.
-
+        
         Raises:
             httpx.HTTPError: If the API request fails.
-
+        
         Tags:
             linkedin, user, profile, retrieve, get, api, important
         """
-
-        return self._unipile_app.retrieve_user_profile(
-            identifier=identifier,
-            account_id=self.account_id,
-        )
+        url = f"{self.base_url}/api/v1/users/{identifier}"
+        params: dict[str, Any] = {"account_id": self.account_id}
+        response = self._get(url, params=params)
+        return self._handle_response(response)
 
     def linkedin_list_post_comments(
         self,
@@ -147,248 +170,238 @@ class ScraperApp(APIApplication):
         limit: int | None = None,
     ) -> dict[str, Any]:
         """
-        Fetches comments for a specified LinkedIn post. If a `comment_id` is provided, it retrieves replies to that comment instead of top-level comments. This function supports pagination and specifically targets comments, unlike others in the class that search for or list entire posts.
-
+        Fetches a paginated list of comments for a specified LinkedIn post. It can retrieve either top-level comments or threaded replies if an optional `comment_id` is provided. This is a read-only operation, distinct from functions that search for posts or list user-specific content.
+        
         Args:
-            post_id: The social ID of the post. Example rn:li:activity:7342082869034393600
+            post_id: The social ID of the post.
             comment_id: If provided, retrieves replies to this comment ID instead of top-level comments.
             cursor: Pagination cursor.
-            limit: Number of comments to return.
-
+            limit: Number of comments to return. (OpenAPI spec shows type string, passed as string if provided).
+        
         Returns:
             A dictionary containing a list of comment objects and pagination details.
-
+        
         Raises:
             httpx.HTTPError: If the API request fails.
-
+        
         Tags:
             linkedin, post, comment, list, content, api, important
         """
-
-        return self._unipile_app.list_post_comments(
-            post_id=post_id,
-            account_id=self.account_id,
-            comment_id=comment_id,
-            cursor=cursor,
-            limit=limit,
-        )
-
-    def linkedin_people_search(
+        url = f"{self.base_url}/api/v1/posts/{post_id}/comments"
+        params: dict[str, Any] = {"account_id": self.account_id}
+        if cursor:
+            params["cursor"] = cursor
+        if limit is not None:
+            params["limit"] = str(limit)
+        if comment_id:
+            params["comment_id"] = comment_id
+
+        response = self._get(url, params=params)
+        return response.json()
+
+    def linkedin_search_people(
         self,
         cursor: str | None = None,
         limit: int | None = None,
         keywords: str | None = None,
-        last_viewed_at: int | None = None,
-        saved_search_id: str | None = None,
-        recent_search_id: str | None = None,
-        location: dict[str, Any] | None = None,
-        location_by_postal_code: dict[str, Any] | None = None,
-        industry: dict[str, Any] | None = None,
-        first_name: str | None = None,
-        last_name: str | None = None,
-        tenure: list[dict[str, Any]] | None = None,
-        groups: list[str] | None = None,
-        school: dict[str, Any] | None = None,
-        profile_language: list[str] | None = None,
-        company: dict[str, Any] | None = None,
-        company_headcount: list[dict[str, Any]] | None = None,
-        company_type: list[str] | None = None,
-        company_location: dict[str, Any] | None = None,
-        tenure_at_company: list[dict[str, Any]] | None = None,
-        past_company: dict[str, Any] | None = None,
-        function: dict[str, Any] | None = None,
-        role: dict[str, Any] | None = None,
-        tenure_at_role: list[dict[str, Any]] | None = None,
-        seniority: dict[str, Any] | None = None,
-        past_role: dict[str, Any] | None = None,
-        following_your_company: bool | None = None,
-        viewed_your_profile_recently: bool | None = None,
-        network_distance: list[str] | None = None,
-        connections_of: list[str] | None = None,
-        past_colleague: bool | None = None,
-        shared_experiences: bool | None = None,
-        changed_jobs: bool | None = None,
-        posted_on_linkedin: bool | None = None,
-        mentionned_in_news: bool | None = None,
-        persona: list[str] | None = None,
-        account_lists: dict[str, Any] | None = None,
-        lead_lists: dict[str, Any] | None = None,
-        viewed_profile_recently: bool | None = None,
-        messaged_recently: bool | None = None,
-        include_saved_leads: bool | None = None,
-        include_saved_accounts: bool | None = None,
+        location: str | None = None,
+        industry: str | None = None,
+        company: str | None = None,
     ) -> dict[str, Any]:
         """
-        Performs a comprehensive LinkedIn Sales Navigator people search with advanced targeting options.
-        This function provides access to LinkedIn's Sales Navigator search capabilities for finding people
-        with precise filters including experience, company details, education, and relationship criteria.
-
+        Performs a paginated search for people on LinkedIn, distinct from searches for companies or jobs. It filters results using keywords, location, industry, and company, internally converting filter names like 'United States' into their required API IDs before making the request.
+        
         Args:
             cursor: Pagination cursor for the next page of entries.
-            limit: Number of items to return.
-            keywords: LinkedIn native filter: KEYWORDS.
-            last_viewed_at: Unix timestamp for saved search filtering.
-            saved_search_id: ID of saved search (overrides other parameters).
-            recent_search_id: ID of recent search (overrides other parameters).
-            location: LinkedIn native filter: GEOGRAPHY. Example: {"include": ["San Francisco Bay Area", "New York City Area"]}
-            location_by_postal_code: Location filter by postal code. Example: {"postal_code": "94105", "radius": "25"}
-            industry: LinkedIn native filter: INDUSTRY. Example: {"include": ["Information Technology and Services", "Financial Services"]}
-            first_name: LinkedIn native filter: FIRST NAME. Example: "John"
-            last_name: LinkedIn native filter: LAST NAME. Example: "Smith"
-            tenure: LinkedIn native filter: YEARS OF EXPERIENCE. Example: [{"min": 5, "max": 10}]
-            groups: LinkedIn native filter: GROUPS. Example: ["group_id_1", "group_id_2"]
-            school: LinkedIn native filter: SCHOOL. Example: {"include": ["Stanford University", "Harvard University"]}
-            profile_language: ISO 639-1 language codes, LinkedIn native filter: PROFILE LANGUAGE. Example: ["en", "es"]
-            company: LinkedIn native filter: CURRENT COMPANY. Example: {"include": ["Google", "Microsoft", "Apple"]}
-            company_headcount: LinkedIn native filter: COMPANY HEADCOUNT. Example: [{"min": 100, "max": 1000}]
-            company_type: LinkedIn native filter: COMPANY TYPE. Example: ["Public Company", "Privately Held"]
-            company_location: LinkedIn native filter: COMPANY HEADQUARTERS LOCATION. Example: {"include": ["San Francisco", "Seattle"]}
-            tenure_at_company: LinkedIn native filter: YEARS IN CURRENT COMPANY. Example: [{"min": 2, "max": 5}]
-            past_company: LinkedIn native filter: PAST COMPANY. Example: {"include": ["Facebook", "Amazon"]}
-            function: LinkedIn native filter: FUNCTION. Example: {"include": ["Engineering", "Sales", "Marketing"]}
-            role: LinkedIn native filter: CURRENT JOB TITLE. Example: {"include": ["Software Engineer", "Product Manager"]}
-            tenure_at_role: LinkedIn native filter: YEARS IN CURRENT POSITION. Example: [{"min": 1, "max": 3}]
-            seniority: LinkedIn native filter: SENIORITY LEVEL. Example: {"include": ["Senior", "Director", "VP"]}
-            past_role: LinkedIn native filter: PAST JOB TITLE. Example: {"include": ["Senior Developer", "Team Lead"]}
-            following_your_company: LinkedIn native filter: FOLLOWING YOUR COMPANY. Example: True
-            viewed_your_profile_recently: LinkedIn native filter: VIEWED YOUR PROFILE RECENTLY. Example: True
-            network_distance: First, second, third+ degree or GROUP, LinkedIn native filter: CONNECTION. Example: ["1st", "2nd"]
-            connections_of: LinkedIn native filter: CONNECTIONS OF. Example: ["person_id_1", "person_id_2"]
-            past_colleague: LinkedIn native filter: PAST COLLEAGUE. Example: True
-            shared_experiences: LinkedIn native filter: SHARED EXPERIENCES. Example: True
-            changed_jobs: LinkedIn native filter: CHANGED JOBS. Example: True
-            posted_on_linkedin: LinkedIn native filter: POSTED ON LINKEDIN. Example: True
-            mentionned_in_news: LinkedIn native filter: MENTIONNED IN NEWS. Example: True
-            persona: LinkedIn native filter: PERSONA. Example: ["persona_id_1", "persona_id_2"]
-            account_lists: LinkedIn native filter: ACCOUNT LISTS. Example: {"include": ["list_id_1"]}
-            lead_lists: LinkedIn native filter: LEAD LISTS. Example: {"include": ["lead_list_id_1"]}
-            viewed_profile_recently: LinkedIn native filter: PEOPLE YOU INTERACTED WITH / VIEWED PROFILE. Example: True
-            messaged_recently: LinkedIn native filter: PEOPLE YOU INTERACTED WITH / MESSAGED. Example: True
-            include_saved_leads: LinkedIn native filter: SAVED LEADS AND ACCOUNTS / ALL MY SAVED LEADS. Example: True
-            include_saved_accounts: LinkedIn native filter: SAVED LEADS AND ACCOUNTS / ALL MY SAVED ACCOUNTS. Example: True
-
+            limit: Number of items to return (up to 50 for Classic search).
+            keywords: Keywords to search for.
+        
         Returns:
             A dictionary containing search results and pagination details.
-
+        
         Raises:
             httpx.HTTPError: If the API request fails.
-
-        Tags:
-            linkedin, sales_navigator, people, search, advanced, scraper, api, important
         """
-        return self._unipile_app.people_search(
-            account_id=self.account_id,
-            cursor=cursor,
-            limit=limit,
-            keywords=keywords,
-            last_viewed_at=last_viewed_at,
-            saved_search_id=saved_search_id,
-            recent_search_id=recent_search_id,
-            location=location,
-            location_by_postal_code=location_by_postal_code,
-            industry=industry,
-            first_name=first_name,
-            last_name=last_name,
-            tenure=tenure,
-            groups=groups,
-            school=school,
-            profile_language=profile_language,
-            company=company,
-            company_headcount=company_headcount,
-            company_type=company_type,
-            company_location=company_location,
-            tenure_at_company=tenure_at_company,
-            past_company=past_company,
-            function=function,
-            role=role,
-            tenure_at_role=tenure_at_role,
-            seniority=seniority,
-            past_role=past_role,
-            following_your_company=following_your_company,
-            viewed_your_profile_recently=viewed_your_profile_recently,
-            network_distance=network_distance,
-            connections_of=connections_of,
-            past_colleague=past_colleague,
-            shared_experiences=shared_experiences,
-            changed_jobs=changed_jobs,
-            posted_on_linkedin=posted_on_linkedin,
-            mentionned_in_news=mentionned_in_news,
-            persona=persona,
-            account_lists=account_lists,
-            lead_lists=lead_lists,
-            viewed_profile_recently=viewed_profile_recently,
-            messaged_recently=messaged_recently,
-            include_saved_leads=include_saved_leads,
-            include_saved_accounts=include_saved_accounts,
-        )
-
-    def linkedin_company_search(
+        url = f"{self.base_url}/api/v1/linkedin/search"
+
+        params: dict[str, Any] = {"account_id": self.account_id}
+        if cursor:
+            params["cursor"] = cursor
+        if limit is not None:
+            params["limit"] = limit
+
+        payload: dict[str, Any] = {"api": "classic", "category": "people"}
+
+        if keywords:
+            payload["keywords"] = keywords
+            
+        if location:
+            location_id = self._get_search_parameter_id("LOCATION", location)
+            payload["location"] = [location_id]
+
+        if industry:
+            industry_id = self._get_search_parameter_id("INDUSTRY", industry)
+            payload["industry"] = [industry_id]
+        
+        if company:
+            company_id = self._get_search_parameter_id("COMPANY", company)
+            payload["company"] = [company_id]
+        
+        response = self._post(url, params=params, data=payload)
+        return self._handle_response(response)
+
+    def linkedin_search_companies(
         self,
         cursor: str | None = None,
         limit: int | None = None,
         keywords: str | None = None,
-        last_viewed_at: int | None = None,
-        saved_search_id: str | None = None,
-        recent_search_id: str | None = None,
-        location: dict[str, Any] | None = None,
-        location_by_postal_code: dict[str, Any] | None = None,
-        industry: dict[str, Any] | None = None,
-        company_headcount: list[dict[str, Any]] | None = None,
-        company_type: list[str] | None = None,
-        company_location: dict[str, Any] | None = None,
-        following_your_company: bool | None = None,
-        account_lists: dict[str, Any] | None = None,
-        include_saved_accounts: bool | None = None,
+        location: str | None = None,
+        industry: str | None = None,
     ) -> dict[str, Any]:
         """
-        Performs a comprehensive LinkedIn Sales Navigator company search with advanced targeting options.
-        This function provides access to LinkedIn's Sales Navigator search capabilities for finding companies
-        with precise filters including size, location, industry, and relationship criteria.
-
+        Executes a paginated LinkedIn search for companies, filtering by optional keywords, location, and industry. Unlike `linkedin_search_people` or `linkedin_search_jobs`, this function specifically sets the API search category to 'companies' to ensure that only company profiles are returned in the search results.
+        
         Args:
             cursor: Pagination cursor for the next page of entries.
-            limit: Number of items to return.
-            keywords: LinkedIn native filter: KEYWORDS. Example: "fintech startup"
-            last_viewed_at: Unix timestamp for saved search filtering.
-            saved_search_id: ID of saved search (overrides other parameters).
-            recent_search_id: ID of recent search (overrides other parameters).
-            location: LinkedIn native filter: GEOGRAPHY. Example: {"include": ["San Francisco Bay Area", "New York City Area"]}
-            location_by_postal_code: Location filter by postal code. Example: {"postal_code": "94105", "radius": "25"}
-            industry: LinkedIn native filter: INDUSTRY. Example: {"include": ["Information Technology and Services", "Financial Services"]}
-            company_headcount: LinkedIn native filter: COMPANY HEADCOUNT. Example: [{"min": 10, "max": 100}]
-            company_type: LinkedIn native filter: COMPANY TYPE. Example: ["Public Company", "Privately Held", "Startup"]
-            company_location: LinkedIn native filter: COMPANY HEADQUARTERS LOCATION. Example: {"include": ["San Francisco", "Seattle", "Austin"]}
-            following_your_company: LinkedIn native filter: FOLLOWING YOUR COMPANY. Example: True
-            account_lists: LinkedIn native filter: ACCOUNT LISTS. Example: {"include": ["account_list_id_1"]}
-            include_saved_accounts: LinkedIn native filter: SAVED LEADS AND ACCOUNTS / ALL MY SAVED ACCOUNTS. Example: True
-
+            limit: Number of items to return (up to 50 for Classic search).
+            keywords: Keywords to search for.
+        
         Returns:
             A dictionary containing search results and pagination details.
+        
+        Raises:
+            httpx.HTTPError: If the API request fails.
+        """
+        url = f"{self.base_url}/api/v1/linkedin/search"
+
+        params: dict[str, Any] = {"account_id": self.account_id}
+        if cursor:
+            params["cursor"] = cursor
+        if limit is not None:
+            params["limit"] = limit
+
+        payload: dict[str, Any] = {"api": "classic", "category": "companies"}
 
+        if keywords:
+            payload["keywords"] = keywords
+
+        if location:
+            location_id = self._get_search_parameter_id("LOCATION", location)
+            payload["location"] = [location_id]
+            
+        if industry:
+            industry_id = self._get_search_parameter_id("INDUSTRY", industry)
+            payload["industry"] = [industry_id]
+
+        response = self._post(url, params=params, data=payload)
+        return self._handle_response(response)
+
+    def linkedin_search_posts(
+        self,
+        cursor: str | None = None,
+        limit: int | None = None,
+        keywords: str | None = None,
+        date_posted: Literal["past_day", "past_week", "past_month"] | None = None,
+        sort_by: Literal["relevance", "date"] = "relevance",
+    ) -> dict[str, Any]:
+        """
+        Performs a keyword-based search for LinkedIn posts, allowing results to be filtered by date and sorted by relevance. This function specifically queries the 'posts' category, distinguishing it from other search methods in the class that target people, companies, or jobs, and returns relevant content.
+        
+        Args:
+            cursor: Pagination cursor for the next page of entries.
+            limit: Number of items to return (up to 50 for Classic search).
+            keywords: Keywords to search for.
+            date_posted: Filter by when the post was posted.
+            sort_by: How to sort the results.
+        
+        Returns:
+            A dictionary containing search results and pagination details.
+        
         Raises:
             httpx.HTTPError: If the API request fails.
+        """
+        url = f"{self.base_url}/api/v1/linkedin/search"
 
-        Tags:
-            linkedin, sales_navigator, companies, search, advanced, scraper, api, important
+        params: dict[str, Any] = {"account_id": self.account_id}
+        if cursor:
+            params["cursor"] = cursor
+        if limit is not None:
+            params["limit"] = limit
+
+        payload: dict[str, Any] = {"api": "classic", "category": "posts"}
+
+        if keywords:
+            payload["keywords"] = keywords
+        if date_posted:
+            payload["date_posted"] = date_posted
+        if sort_by:
+            payload["sort_by"] = sort_by
+
+        response = self._post(url, params=params, data=payload)
+        return self._handle_response(response)
+
+    def linkedin_search_jobs(
+        self,
+        cursor: str | None = None,
+        limit: int | None = None,
+        keywords: str | None = None,
+        region: str | None = None,
+        sort_by: Literal["relevance", "date"] = "relevance",
+        minimum_salary_value: int = 40,
+        industry: str | None = None,
+    ) -> dict[str, Any]:
+        """
+        Executes a LinkedIn search specifically for job listings using keywords and filters like region, industry, and minimum salary. Unlike other search functions targeting people or companies, this is specialized for job listings and converts friendly filter names (e.g., "United States") into their required API IDs.
+        
+        Args:
+            cursor: Pagination cursor for the next page of entries.
+            limit: Number of items to return (up to 50 for Classic search).
+            keywords: Keywords to search for.
+            location: The geographical location to filter jobs by (e.g., "United States").
+            sort_by: How to sort the results.
+            minimum_salary_value: The minimum salary to filter for.
+        
+        Returns:
+            A dictionary containing search results and pagination details.
+        
+        Raises:
+            httpx.HTTPError: If the API request fails.
+            ValueError: If the specified location is not found.
         """
-        return self._unipile_app.company_search(
-            account_id=self.account_id,
-            cursor=cursor,
-            limit=limit,
-            keywords=keywords,
-            last_viewed_at=last_viewed_at,
-            saved_search_id=saved_search_id,
-            recent_search_id=recent_search_id,
-            location=location,
-            location_by_postal_code=location_by_postal_code,
-            industry=industry,
-            company_headcount=company_headcount,
-            company_type=company_type,
-            company_location=company_location,
-            following_your_company=following_your_company,
-            account_lists=account_lists,
-            include_saved_accounts=include_saved_accounts,
-        )
+        url = f"{self.base_url}/api/v1/linkedin/search"
+
+        params: dict[str, Any] = {"account_id": self.account_id}
+        if cursor:
+            params["cursor"] = cursor
+        if limit is not None:
+            params["limit"] = limit
+
+        payload: dict[str, Any] = {
+            "api": "classic",
+            "category": "jobs",
+            "minimum_salary": {
+                "currency": "USD",
+                "value": minimum_salary_value,
+            },
+        }
+
+        if keywords:
+            payload["keywords"] = keywords
+        if sort_by:
+            payload["sort_by"] = sort_by
+
+        # If location is provided, get its ID and add it to the payload
+        if region:
+            location_id = self._get_search_parameter_id("LOCATION", region)
+            payload["region"] = location_id
+            
+        if industry:
+            industry_id = self._get_search_parameter_id("INDUSTRY", industry)
+            payload["industry"] = [industry_id]
+
+        response = self._post(url, params=params, data=payload)
+        return self._handle_response(response)
+
 
     def list_tools(self):
         """
@@ -398,10 +411,11 @@ class ScraperApp(APIApplication):
             A list of functions that can be used as tools.
         """
         return [
-            self.linkedin_post_search,
             self.linkedin_list_profile_posts,
             self.linkedin_retrieve_profile,
             self.linkedin_list_post_comments,
-            self.linkedin_people_search,
-            self.linkedin_company_search,
+            self.linkedin_search_people,
+            self.linkedin_search_companies,
+            self.linkedin_search_posts,
+            self.linkedin_search_jobs,
         ]