universal-mcp-applications 0.1.30rc1__py3-none-any.whl → 0.1.36rc1__py3-none-any.whl

universal_mcp/applications/semanticscholar/app.py

@@ -1,5 +1,4 @@
 from typing import Any
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -9,7 +8,7 @@ class SemanticscholarApp(APIApplication):
         super().__init__(name="semanticscholar", integration=integration, **kwargs)
         self.base_url = "/graph/v1"
 
-    def post_graph_get_authors(self, fields=None, ids=None) -> dict[str, Any]:
+    async def post_graph_get_authors(self, fields=None, ids=None) -> dict[str, Any]:
         """
         Creates a batch of authors using the provided JSON data in the request body, optionally specifying fields to include in the response via a query parameter.
 
@@ -23,9 +22,7 @@ class SemanticscholarApp(APIApplication):
         Tags:
             Author Data
         """
-        request_body = {
-            "ids": ids,
-        }
+        request_body = {"ids": ids}
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/author/batch"
         query_params = {k: v for k, v in [("fields", fields)] if v is not None}
@@ -33,9 +30,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_author_search(
-        self, query, offset=None, limit=None, fields=None
-    ) -> dict[str, Any]:
+    async def get_graph_get_author_search(self, query, offset=None, limit=None, fields=None) -> dict[str, Any]:
         """
         Searches for authors based on a query string with optional pagination and field selection parameters.
 
@@ -52,21 +47,12 @@ class SemanticscholarApp(APIApplication):
             Author Data
         """
         url = f"{self.base_url}/author/search"
-        query_params = {
-            k: v
-            for k, v in [
-                ("offset", offset),
-                ("limit", limit),
-                ("fields", fields),
-                ("query", query),
-            ]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("offset", offset), ("limit", limit), ("fields", fields), ("query", query)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_author(self, author_id, fields=None) -> dict[str, Any]:
+    async def get_graph_get_author(self, author_id, fields=None) -> dict[str, Any]:
         """
         Retrieves the profile information for a specific author identified by the `author_id` and returns it with optional fields specified in the `fields` query parameter.
 
@@ -88,9 +74,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_author_papers(
-        self, author_id, offset=None, limit=None, fields=None
-    ) -> dict[str, Any]:
+    async def get_graph_get_author_papers(self, author_id, offset=None, limit=None, fields=None) -> dict[str, Any]:
         """
         Retrieves a paginated list of papers authored by the specified author, with optional field selection.
 
@@ -109,16 +93,12 @@ class SemanticscholarApp(APIApplication):
         if author_id is None:
             raise ValueError("Missing required parameter 'author_id'")
         url = f"{self.base_url}/author/{author_id}/papers"
-        query_params = {
-            k: v
-            for k, v in [("offset", offset), ("limit", limit), ("fields", fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("offset", offset), ("limit", limit), ("fields", fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_paper_autocomplete(self, query) -> dict[str, Any]:
+    async def get_graph_get_paper_autocomplete(self, query) -> dict[str, Any]:
         """
         Provides an autocomplete suggestion list based on a required query string parameter.
 
@@ -137,7 +117,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def post_graph_get_papers(self, fields=None, ids=None) -> dict[str, Any]:
+    async def post_graph_get_papers(self, fields=None, ids=None) -> dict[str, Any]:
         """
         Creates a batch of papers using JSON data in the request body and optionally specifies fields to include in the response.
 
@@ -151,9 +131,7 @@ class SemanticscholarApp(APIApplication):
         Tags:
             Paper Data
         """
-        request_body = {
-            "ids": ids,
-        }
+        request_body = {"ids": ids}
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/paper/batch"
         query_params = {k: v for k, v in [("fields", fields)] if v is not None}
@@ -161,7 +139,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_paper_relevance_search(
+    async def get_graph_paper_relevance_search(
         self,
         query,
         fields=None,
@@ -219,7 +197,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_paper_bulk_search(
+    async def get_graph_paper_bulk_search(
         self,
         query,
         token=None,
@@ -277,7 +255,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_paper_title_search(
+    async def get_graph_paper_title_search(
         self,
         query,
         fields=None,
@@ -329,7 +307,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_paper(self, paper_id, fields=None) -> dict[str, Any]:
+    async def get_graph_get_paper(self, paper_id, fields=None) -> dict[str, Any]:
         """
         Retrieves details of a paper by its ID, optionally specifying fields to include in the response.
 
@@ -351,9 +329,7 @@ class SemanticscholarApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_paper_authors(
-        self, paper_id, offset=None, limit=None, fields=None
-    ) -> dict[str, Any]:
+    async def get_graph_get_paper_authors(self, paper_id, offset=None, limit=None, fields=None) -> dict[str, Any]:
         """
         Retrieves a list of authors for a specific paper identified by the `paper_id`, allowing optional parameters for offset, limit, and fields to customize the response.
 
@@ -372,18 +348,12 @@ class SemanticscholarApp(APIApplication):
         if paper_id is None:
             raise ValueError("Missing required parameter 'paper_id'")
         url = f"{self.base_url}/paper/{paper_id}/authors"
-        query_params = {
-            k: v
-            for k, v in [("offset", offset), ("limit", limit), ("fields", fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("offset", offset), ("limit", limit), ("fields", fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_paper_citations(
-        self, paper_id, offset=None, limit=None, fields=None
-    ) -> dict[str, Any]:
+    async def get_graph_get_paper_citations(self, paper_id, offset=None, limit=None, fields=None) -> dict[str, Any]:
         """
         Retrieves a list of citations for a specific paper, identified by its paper ID, with optional parameters for offset, limit, and fields.
 
@@ -402,18 +372,12 @@ class SemanticscholarApp(APIApplication):
         if paper_id is None:
             raise ValueError("Missing required parameter 'paper_id'")
         url = f"{self.base_url}/paper/{paper_id}/citations"
-        query_params = {
-            k: v
-            for k, v in [("offset", offset), ("limit", limit), ("fields", fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("offset", offset), ("limit", limit), ("fields", fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def get_graph_get_paper_references(
-        self, paper_id, offset=None, limit=None, fields=None
-    ) -> dict[str, Any]:
+    async def get_graph_get_paper_references(self, paper_id, offset=None, limit=None, fields=None) -> dict[str, Any]:
         """
         Retrieves references for a specific paper by its ID using the "GET" method and allows optional filtering by offset, limit, and fields for customizable output.
 
@@ -432,16 +396,12 @@ class SemanticscholarApp(APIApplication):
         if paper_id is None:
             raise ValueError("Missing required parameter 'paper_id'")
         url = f"{self.base_url}/paper/{paper_id}/references"
-        query_params = {
-            k: v
-            for k, v in [("offset", offset), ("limit", limit), ("fields", fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("offset", offset), ("limit", limit), ("fields", fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def get_snippet_search(self, query, limit=None) -> dict[str, Any]:
+    async def get_snippet_search(self, query, limit=None) -> dict[str, Any]:
         """
         Retrieves a list of search results based on a specified query string, optionally limited by a user-defined number of results, using the "GET" method at the "/snippet/search" endpoint.
 
@@ -456,9 +416,7 @@ class SemanticscholarApp(APIApplication):
             Snippet Text
         """
         url = f"{self.base_url}/snippet/search"
-        query_params = {
-            k: v for k, v in [("query", query), ("limit", limit)] if v is not None
-        }
+        query_params = {k: v for k, v in [("query", query), ("limit", limit)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()

universal_mcp/applications/semrush/app.py

@@ -1,5 +1,4 @@
 from typing import Any
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -20,7 +19,6 @@ class SemrushApp(APIApplication):
         credentials = self.integration.get_credentials()
         if "api_key" in credentials:
             self.api_key = credentials["api_key"]
-        # Always return empty headers
         return {}
 
     @property
@@ -44,22 +42,17 @@ class SemrushApp(APIApplication):
         """
         Builds the parameters dictionary and makes a GET request to the Semrush API.
         """
-        params = {
-            "type": report_type,
-            "key": self.api_key,
-        }
+        params = {"type": report_type, "key": self.api_key}
         for key, value in kwargs.items():
             if value is not None:
                 params[key] = value
-
         url = self.base_url
         if "analytics" in report_type:
             url = f"{self.base_url}/analytics/v1"
-
         response = self._get(url, params=params)
         return self._handle_response(response)
 
-    def domain_ad_history(
+    async def domain_ad_history(
         self,
         domain: str,
         database: str = "us",
@@ -91,7 +84,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def domain_organic_pages(
+    async def domain_organic_pages(
         self,
         domain: str,
         database: str = "us",
@@ -123,7 +116,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def domain_organic_search_keywords(
+    async def domain_organic_search_keywords(
         self,
         domain: str,
         database: str = "us",
@@ -183,7 +176,7 @@ class SemrushApp(APIApplication):
             export_escape=export_escape,
         )
 
-    def domain_organic_subdomains(
+    async def domain_organic_subdomains(
         self,
         domain: str,
         database: str = "us",
@@ -213,7 +206,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def domain_paid_search_keywords(
+    async def domain_paid_search_keywords(
         self,
         domain: str,
         database: str = "us",
@@ -247,7 +240,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def domain_pla_search_keywords(
+    async def domain_pla_search_keywords(
         self,
         domain: str,
         database: str = "us",
@@ -277,7 +270,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def domain_vs_domain(
+    async def domain_vs_domain(
         self,
         domains: str,
         database: str = "us",
@@ -309,7 +302,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def backlinks(
+    async def backlinks(
         self,
         target: str,
         target_type: str,
@@ -335,7 +328,7 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def backlinks_overview(
+    async def backlinks_overview(
         self,
         target: str,
         target_type: str,
@@ -361,12 +354,8 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def keyword_difficulty(
-        self,
-        phrase: str,
-        database: str = "us",
-        export_columns: str | None = None,
-        export_escape: int | None = None,
+    async def keyword_difficulty(
+        self, phrase: str, database: str = "us", export_columns: str | None = None, export_escape: int | None = None
     ) -> dict[str, Any]:
         """
         Get keyword difficulty data to estimate ranking difficulty for organic search terms.
@@ -374,14 +363,10 @@ class SemrushApp(APIApplication):
         if not phrase:
             raise ValueError("Phrase parameter is required")
         return self._build_params_and_get(
-            "phrase_kdi",
-            phrase=phrase,
-            database=database,
-            export_columns=export_columns,
-            export_escape=export_escape,
+            "phrase_kdi", phrase=phrase, database=database, export_columns=export_columns, export_escape=export_escape
         )
 
-    def ads_copies(
+    async def ads_copies(
         self,
         domain: str,
         database: str = "us",
@@ -411,7 +396,7 @@ class SemrushApp(APIApplication):
             export_decode=export_decode,
         )
 
-    def anchors(
+    async def anchors(
         self,
         target: str,
         target_type: str,
@@ -435,24 +420,15 @@ class SemrushApp(APIApplication):
             display_offset=display_offset,
         )
 
-    def authority_score_profile(self, target: str, target_type: str) -> dict[str, Any]:
+    async def authority_score_profile(self, target: str, target_type: str) -> dict[str, Any]:
         """
         Get distribution of referring domains by Authority Score from 0 to 100.
         """
         if not target or not target_type:
             raise ValueError("Target and target_type parameters are required")
-        return self._build_params_and_get(
-            "backlinks_ascore_profile_analytics",
-            target=target,
-            target_type=target_type,
-        )
+        return self._build_params_and_get("backlinks_ascore_profile_analytics", target=target, target_type=target_type)
 
-    def batch_comparison(
-        self,
-        targets: list[str],
-        target_types: list[str],
-        export_columns: str | None = None,
-    ) -> dict[str, Any]:
+    async def batch_comparison(self, targets: list[str], target_types: list[str], export_columns: str | None = None) -> dict[str, Any]:
         """
         Compare backlink profiles and link-building progress across multiple competitors.
         """
@@ -461,17 +437,12 @@ class SemrushApp(APIApplication):
         if len(targets) > 200:
             raise ValueError("Maximum 200 targets allowed")
         if len(targets) != len(target_types):
-            raise ValueError(
-                "Targets and target_types arrays must have the same length"
-            )
+            raise ValueError("Targets and target_types arrays must have the same length")
         return self._build_params_and_get(
-            "backlinks_comparison_analytics",
-            targets=targets,
-            target_types=target_types,
-            export_columns=export_columns,
+            "backlinks_comparison_analytics", targets=targets, target_types=target_types, export_columns=export_columns
         )
 
-    def batch_keyword_overview(
+    async def batch_keyword_overview(
         self,
         phrase: str,
         database: str = "us",
@@ -495,7 +466,7 @@ class SemrushApp(APIApplication):
             export_columns=export_columns,
         )
 
-    def broad_match_keyword(
+    async def broad_match_keyword(
         self,
         phrase: str,
         database: str = "us",
@@ -525,22 +496,17 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def categories(
-        self, target: str, target_type: str, export_columns: str | None = None
-    ) -> dict[str, Any]:
+    async def categories(self, target: str, target_type: str, export_columns: str | None = None) -> dict[str, Any]:
         """
         Get list of categories that the queried domain belongs to with confidence ratings.
         """
         if not target or not target_type:
             raise ValueError("Target and target_type parameters are required")
         return self._build_params_and_get(
-            "backlinks_categories_analytics",
-            target=target,
-            target_type=target_type,
-            export_columns=export_columns,
+            "backlinks_categories_analytics", target=target, target_type=target_type, export_columns=export_columns
         )
 
-    def categories_profile(
+    async def categories_profile(
         self,
         target: str,
         target_type: str,
@@ -562,7 +528,7 @@ class SemrushApp(APIApplication):
             display_offset=display_offset,
         )
 
-    def competitors(
+    async def competitors(
         self,
         target: str,
         target_type: str,
@@ -584,7 +550,7 @@ class SemrushApp(APIApplication):
             display_offset=display_offset,
         )
 
-    def competitors_organic_search(
+    async def competitors_organic_search(
         self,
         domain: str,
         database: str = "us",
@@ -614,7 +580,7 @@ class SemrushApp(APIApplication):
             display_sort=display_sort,
         )
 
-    def competitors_paid_search(
+    async def competitors_paid_search(
         self,
         domain: str,
         database: str = "us",
@@ -644,7 +610,7 @@ class SemrushApp(APIApplication):
             display_sort=display_sort,
         )
 
-    def indexed_pages(
+    async def indexed_pages(
         self,
         target: str,
         target_type: str,
@@ -668,7 +634,7 @@ class SemrushApp(APIApplication):
             display_offset=display_offset,
         )
 
-    def keyword_ads_history(
+    async def keyword_ads_history(
         self,
         phrase: str,
         database: str = "us",
@@ -694,7 +660,7 @@ class SemrushApp(APIApplication):
             export_columns=export_columns,
         )
 
-    def keyword_overview_all_databases(
+    async def keyword_overview_all_databases(
         self,
         phrase: str,
         database: str | None = None,
@@ -716,7 +682,7 @@ class SemrushApp(APIApplication):
             export_columns=export_columns,
         )
 
-    def keyword_overview_one_database(
+    async def keyword_overview_one_database(
         self,
         phrase: str,
         database: str = "us",
@@ -740,7 +706,7 @@ class SemrushApp(APIApplication):
             export_columns=export_columns,
         )
 
-    def organic_results(
+    async def organic_results(
         self,
         phrase: str,
         database: str = "us",
@@ -770,7 +736,7 @@ class SemrushApp(APIApplication):
             positions_type=positions_type,
         )
 
-    def paid_results(
+    async def paid_results(
         self,
         phrase: str,
         database: str = "us",
@@ -798,7 +764,7 @@ class SemrushApp(APIApplication):
             export_columns=export_columns,
         )
 
-    def phrase_questions(
+    async def phrase_questions(
         self,
         phrase: str,
         database: str = "us",
@@ -828,7 +794,7 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def pla_competitors(
+    async def pla_competitors(
         self,
         domain: str,
         database: str = "us",
@@ -856,7 +822,7 @@ class SemrushApp(APIApplication):
             display_sort=display_sort,
         )
 
-    def pla_copies(
+    async def pla_copies(
         self,
         domain: str,
         database: str = "us",
@@ -886,7 +852,7 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def referring_domains(
+    async def referring_domains(
         self,
         target: str,
         target_type: str,
@@ -912,7 +878,7 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def referring_domains_by_country(
+    async def referring_domains_by_country(
         self,
         target: str,
         target_type: str,
@@ -936,7 +902,7 @@ class SemrushApp(APIApplication):
             display_offset=display_offset,
         )
 
-    def related_keywords(
+    async def related_keywords(
         self,
         phrase: str,
         database: str = "us",
@@ -966,7 +932,7 @@ class SemrushApp(APIApplication):
             display_filter=display_filter,
         )
 
-    def tlds_distribution(
+    async def tlds_distribution(
         self,
         target: str,
         target_type: str,
@@ -990,7 +956,7 @@ class SemrushApp(APIApplication):
             display_offset=display_offset,
         )
 
-    def url_organic_search_keywords(
+    async def url_organic_search_keywords(
         self,
         url: str,
         database: str = "us",
@@ -1020,7 +986,7 @@ class SemrushApp(APIApplication):
             display_sort=display_sort,
         )
 
-    def url_paid_search_keywords(
+    async def url_paid_search_keywords(
         self,
         url: str,
         database: str = "us",