universal-mcp-applications 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

universal_mcp/applications/scraper/README.md

@@ -0,0 +1,15 @@
+# ScraperApp MCP Server
+
+An MCP Server for the ScraperApp API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the ScraperApp API.
+
+
+| Tool | Description |
+|------|-------------|
+| `linkedin_post_search` | Performs a LinkedIn search for posts. |
+| `linkedin_list_all_posts` | Lists all LinkedIn posts for a given user  identifier |
+| `linkedin_retrieve_profile` | Retrieves a specific LinkedIn user profile by its identifier. |
+| `linkedin_list_post_comments` | Lists all comments from a specific LinkedIn post. Can also list replies to a specific comment. |

universal_mcp/applications/scraper/__init__.py

@@ -0,0 +1 @@
+from .app import ScraperApp

universal_mcp/applications/scraper/app.py

@@ -0,0 +1,189 @@
+import os
+from dotenv import load_dotenv
+load_dotenv()
+
+from typing import Any
+
+from universal_mcp.applications.application import APIApplication
+from universal_mcp.agentr.integration import AgentrIntegration
+from universal_mcp.applications.unipile import UnipileApp
+from typing import Any, Optional
+
+class ScraperApp(APIApplication):
+    """
+    Application for interacting with LinkedIn API.
+    Provides a simplified interface for LinkedIn search operations.
+    """
+
+    def __init__(self, **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", **kwargs)
+        if self.integration:
+            credentials = self.integration.get_credentials()
+            api_key = credentials.get("SCRAPER_API")
+            self.account_id = credentials.get("ACCOUNT_ID")
+            self.integration = AgentrIntegration(name="unipile", api_key=api_key, base_url="https://staging-agentr-306776579029.asia-southeast1.run.app/")
+            self._unipile_app = UnipileApp(integration=self.integration)
+        else:
+            self.account_id = None
+            self._unipile_app = None
+        
+    def linkedin_post_search(
+        self,
+        category: str = "posts",
+        api: str = "classic",
+        cursor: Optional[str] = None,
+        limit: Optional[int] = None,
+        keywords: Optional[str] = None,
+        sort_by: Optional[str] = None,
+        date_posted: Optional[str] = None,
+        content_type: Optional[str] = None,
+    ) -> dict[str, Any]:
+        """
+        Performs a LinkedIn search for posts.
+
+        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"
+
+        Returns:
+            A dictionary containing search results and pagination details.
+
+        Raises:
+            httpx.HTTPError: If the API request fails.
+
+        Tags:
+            linkedin, search, posts, api, scrapper, important
+        """
+        
+        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_all_posts(
+        self,
+        identifier: str,
+        cursor: Optional[str] = None,
+        limit: Optional[int] = None,
+    ) -> dict[str, Any]:
+        """
+        Lists all LinkedIn posts for a given user  identifier
+
+        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).
+
+        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_user_posts(
+            identifier=identifier,
+            account_id=self.account_id,
+            cursor=cursor,
+            limit=limit,
+        )
+
+    def linkedin_retrieve_profile(
+        self,
+        identifier: str,
+    ) -> dict[str, Any]:
+        """
+        Retrieves a specific LinkedIn user profile by its 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".
+
+        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_profile(
+            identifier=identifier,
+            account_id=self.account_id,
+        )
+
+ 
+    def linkedin_list_post_comments(
+        self,
+        post_id: str,
+        comment_id: Optional[str] = None,
+        cursor: Optional[str] = None,
+        limit: Optional[int] = None,
+    ) -> dict[str, Any]:
+        """
+        Lists all comments from a specific LinkedIn post. Can also list replies to a specific comment.
+
+        Args:
+            post_id: The social ID of the post. Example rn:li:activity:7342082869034393600
+            comment_id: If provided, retrieves replies to this comment ID instead of top-level comments.
+            cursor: Pagination cursor.
+            limit: Number of comments to return.
+
+        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 list_tools(self):
+        """
+        Returns a list of available tools/functions in this application.
+        
+        Returns:
+            A list of functions that can be used as tools.
+        """
+        return [
+            self.linkedin_post_search,
+            self.linkedin_list_all_posts,
+            self.linkedin_retrieve_profile,
+            self.linkedin_list_post_comments,
+            ]

{universal_mcp_applications-0.1.4.dist-info → universal_mcp_applications-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.4
+Version: 0.1.6
 Summary: A Universal MCP Application: universal_mcp_applications
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications

{universal_mcp_applications-0.1.4.dist-info → universal_mcp_applications-0.1.6.dist-info}/RECORD

@@ -186,6 +186,9 @@ universal_mcp/applications/retell/app.py,sha256=ysvyfDBHynl5AkKT7YRaQsEeMPivMPla
 universal_mcp/applications/rocketlane/README.md,sha256=o8-N0RFEOzpUrQDerIGvFp7yXLX8KTmngupFhid9XN0,2986
 universal_mcp/applications/rocketlane/__init__.py,sha256=jl3PjnTvPdjnbFXJgLywSlE4kHrKZiFMGaf-EaDsj80,31
 universal_mcp/applications/rocketlane/app.py,sha256=Re5-OoUWIIxL_ZJZ_RpEqz82hymgAWtdcOSJtJFzzs0,240690
+universal_mcp/applications/scraper/README.md,sha256=ys9f2dRHGsnFkauAuGdBo3_Z_51PRn2cqGlnEv8kjPI,590
+universal_mcp/applications/scraper/__init__.py,sha256=RnkyFDeNR1tOsY_PskHdv4C8AYRbcjMt7KyYQWiGGD8,27
+universal_mcp/applications/scraper/app.py,sha256=CVMrERgtUritpmG2RyOMlH3iTjfBhKJwF2Lvgz51z80,6483
 universal_mcp/applications/semanticscholar/README.md,sha256=JpLY_698pvstgoNfQ5Go8C8ehQ-o68uFDX5kr86upK0,2834
 universal_mcp/applications/semanticscholar/__init__.py,sha256=eR36chrc0pbBsSE1GadvmQH0OmtKnSC91xbE7HcDPf0,36
 universal_mcp/applications/semanticscholar/app.py,sha256=OHTFkR-IwRU5Rvb1bEu7XmRHikht3hEgZxszLQu6kFI,22234
@@ -264,7 +267,7 @@ universal_mcp/applications/youtube/app.py,sha256=hhKqnbXvMAyOW3LOqp-ODPdIuQorr1n
 universal_mcp/applications/zenquotes/README.md,sha256=x1mZHjNKD4WOgsIhedcbbaR1nvbt794GSrKud1tSLD0,296
 universal_mcp/applications/zenquotes/__init__.py,sha256=IkASLYaZiHJXlkGwEMk1HgIq5GwEZp5GhAIiJyjBd3g,30
 universal_mcp/applications/zenquotes/app.py,sha256=6v8trNWjxbixdlEyaM-gJbfY8z9ZAmkIzSUks_fbsT4,1076
-universal_mcp_applications-0.1.4.dist-info/METADATA,sha256=760QBT5cDgO01G0QhyplqLx5aR-DXQ33yaa3ZonxMt0,3918
-universal_mcp_applications-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-universal_mcp_applications-0.1.4.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
-universal_mcp_applications-0.1.4.dist-info/RECORD,,
+universal_mcp_applications-0.1.6.dist-info/METADATA,sha256=zWWZgM7EZvZIgFRTowMREhKbcEfh_CF1PxnuTpzOmjU,3918
+universal_mcp_applications-0.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp_applications-0.1.6.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
+universal_mcp_applications-0.1.6.dist-info/RECORD,,