universal-mcp-applications 0.1.22__py3-none-any.whl → 0.1.39rc8__py3-none-any.whl

universal_mcp/applications/ahrefs/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 AhrefsApp(APIApplication):
         super().__init__(name="ahrefs", integration=integration, **kwargs)
         self.base_url = "https://api.ahrefs.com/v3"
 
-    def crawler_ips(self, output=None) -> dict[str, Any]:
+    async def crawler_ips(self, output=None) -> dict[str, Any]:
         """
         Retrieve the list of public crawler IP addresses from the API.
 
@@ -27,11 +26,11 @@ class AhrefsApp(APIApplication):
         """
         url = f"{self.base_url}/public/crawler-ips"
         query_params = {k: v for k, v in [("output", output)] if v is not None}
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def crawler_ip_ranges(self, output=None) -> dict[str, Any]:
+    async def crawler_ip_ranges(self, output=None) -> dict[str, Any]:
         """
         Fetches the current public crawler IP ranges from the API, optionally specifying output format.
 
@@ -49,11 +48,11 @@ class AhrefsApp(APIApplication):
         """
         url = f"{self.base_url}/public/crawler-ip-ranges"
         query_params = {k: v for k, v in [("output", output)] if v is not None}
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def limits_and_usage(self, output=None) -> dict[str, Any]:
+    async def limits_and_usage(self, output=None) -> dict[str, Any]:
         """
         Retrieves current API subscription limits and usage statistics from the service.
 
@@ -71,19 +70,11 @@ class AhrefsApp(APIApplication):
         """
         url = f"{self.base_url}/subscription-info/limits-and-usage"
         query_params = {k: v for k, v in [("output", output)] if v is not None}
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def batch_analysis(
-        self,
-        select,
-        targets,
-        order_by=None,
-        country=None,
-        volume_mode=None,
-        output=None,
-    ) -> dict[str, Any]:
+    async def batch_analysis(self, select, targets, order_by=None, country=None, volume_mode=None, output=None) -> dict[str, Any]:
         """
         Submits a batch analysis request with specified parameters and returns the analysis results as a dictionary.
 
@@ -120,13 +111,11 @@ class AhrefsApp(APIApplication):
         request_body = {k: v for k, v in request_body.items() if v is not None}
         url = f"{self.base_url}/batch-analysis/batch-analysis"
         query_params = {}
-        response = self._post(url, data=request_body, params=query_params)
+        response = await self._apost(url, data=request_body, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def serp_overview(
-        self, select, country, keyword, top_positions=None, date=None, output=None
-    ) -> dict[str, Any]:
+    async def serp_overview(self, select, country, keyword, top_positions=None, date=None, output=None) -> dict[str, Any]:
         """
         Retrieves a SERP (Search Engine Results Page) overview report based on specified selection, country, and keyword criteria.
 
@@ -167,11 +156,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def overview(
+    async def overview(
         self,
         select,
         date,
@@ -239,11 +228,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def competitors_overview(
+    async def competitors_overview(
         self,
         select,
         date,
@@ -312,11 +301,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def projects(self, output=None) -> dict[str, Any]:
+    async def projects(self, output=None) -> dict[str, Any]:
         """
         Retrieves a list of site audit projects from the configured base URL, optionally specifying an output format.
 
@@ -334,11 +323,11 @@ class AhrefsApp(APIApplication):
         """
         url = f"{self.base_url}/site-audit/projects"
         query_params = {k: v for k, v in [("output", output)] if v is not None}
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def domain_rating(self, target, date, protocol=None, output=None) -> dict[str, Any]:
+    async def domain_rating(self, target, date, protocol=None, output=None) -> dict[str, Any]:
         """
         Fetches the domain rating and related metrics for a specified target and date.
 
@@ -363,23 +352,12 @@ class AhrefsApp(APIApplication):
         if date is None:
             raise ValueError("Missing required parameter 'date'")
         url = f"{self.base_url}/site-explorer/domain-rating"
-        query_params = {
-            k: v
-            for k, v in [
-                ("protocol", protocol),
-                ("target", target),
-                ("date", date),
-                ("output", output),
-            ]
-            if v is not None
-        }
-        response = self._get(url, params=query_params)
+        query_params = {k: v for k, v in [("protocol", protocol), ("target", target), ("date", date), ("output", output)] if v is not None}
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def backlinks_stats(
-        self, target, date, protocol=None, mode=None, output=None
-    ) -> dict[str, Any]:
+    async def backlinks_stats(self, target, date, protocol=None, mode=None, output=None) -> dict[str, Any]:
         """
         Retrieves backlink statistics for a specified target and date, with optional filters for protocol, mode, and output format.
 
@@ -407,22 +385,14 @@ class AhrefsApp(APIApplication):
         url = f"{self.base_url}/site-explorer/backlinks-stats"
         query_params = {
             k: v
-            for k, v in [
-                ("protocol", protocol),
-                ("target", target),
-                ("mode", mode),
-                ("date", date),
-                ("output", output),
-            ]
+            for k, v in [("protocol", protocol), ("target", target), ("mode", mode), ("date", date), ("output", output)]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def outlinks_stats(
-        self, target, protocol=None, mode=None, output=None
-    ) -> dict[str, Any]:
+    async def outlinks_stats(self, target, protocol=None, mode=None, output=None) -> dict[str, Any]:
         """
         Retrieves outbound link statistics for the specified target from the site explorer API.
 
@@ -445,30 +415,12 @@ class AhrefsApp(APIApplication):
         if target is None:
             raise ValueError("Missing required parameter 'target'")
         url = f"{self.base_url}/site-explorer/outlinks-stats"
-        query_params = {
-            k: v
-            for k, v in [
-                ("protocol", protocol),
-                ("mode", mode),
-                ("target", target),
-                ("output", output),
-            ]
-            if v is not None
-        }
-        response = self._get(url, params=query_params)
+        query_params = {k: v for k, v in [("protocol", protocol), ("mode", mode), ("target", target), ("output", output)] if v is not None}
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def metrics(
-        self,
-        target,
-        date,
-        volume_mode=None,
-        country=None,
-        protocol=None,
-        mode=None,
-        output=None,
-    ) -> dict[str, Any]:
+    async def metrics(self, target, date, volume_mode=None, country=None, protocol=None, mode=None, output=None) -> dict[str, Any]:
         """
         Retrieves metrics data from the site explorer API endpoint.
 
@@ -509,19 +461,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def refdomains_history(
-        self,
-        date_from,
-        target,
-        history_grouping=None,
-        date_to=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def refdomains_history(
+        self, date_from, target, history_grouping=None, date_to=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Retrieves the historical data of reference domains from a specified site.
@@ -562,13 +507,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def domain_rating_history(
-        self, date_from, target, history_grouping=None, date_to=None, output=None
-    ) -> dict[str, Any]:
+    async def domain_rating_history(self, date_from, target, history_grouping=None, date_to=None, output=None) -> dict[str, Any]:
         """
         Retrieves historical domain rating data for a specified target within a given date range.
 
@@ -605,13 +548,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def url_rating_history(
-        self, date_from, target, history_grouping=None, date_to=None, output=None
-    ) -> dict[str, Any]:
+    async def url_rating_history(self, date_from, target, history_grouping=None, date_to=None, output=None) -> dict[str, Any]:
         """
         Retrieves URL rating history data for a specified target within a date range.
 
@@ -648,20 +589,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def pages_history(
-        self,
-        date_from,
-        target,
-        history_grouping=None,
-        date_to=None,
-        country=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def pages_history(
+        self, date_from, target, history_grouping=None, date_to=None, country=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Retrieves historical page data for a target using specified filters.
@@ -705,11 +638,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def metrics_history(
+    async def metrics_history(
         self,
         date_from,
         target,
@@ -767,21 +700,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def keywords_history(
-        self,
-        date_from,
-        target,
-        select=None,
-        history_grouping=None,
-        date_to=None,
-        country=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def keywords_history(
+        self, date_from, target, select=None, history_grouping=None, date_to=None, country=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Fetches the historical keyword rankings and performance data for a specified target within an optional date range and set of filters.
@@ -827,20 +751,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def metrics_by_country(
-        self,
-        target,
-        date,
-        volume_mode=None,
-        limit=None,
-        protocol=None,
-        mode=None,
-        output=None,
-    ) -> dict[str, Any]:
+    async def metrics_by_country(self, target, date, volume_mode=None, limit=None, protocol=None, mode=None, output=None) -> dict[str, Any]:
         """
         Fetches site metrics grouped by country for a specified target and date.
 
@@ -881,19 +796,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def pages_by_traffic(
-        self,
-        target,
-        volume_mode=None,
-        country=None,
-        protocol=None,
-        mode=None,
-        output=None,
-    ) -> dict[str, Any]:
+    async def pages_by_traffic(self, target, volume_mode=None, country=None, protocol=None, mode=None, output=None) -> dict[str, Any]:
         """
         Retrieves a list of top pages for a specified target domain or URL, ranked by estimated organic search traffic.
 
@@ -930,11 +837,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def all_backlinks(
+    async def all_backlinks(
         self,
         select,
         target,
@@ -999,11 +906,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def broken_backlinks(
+    async def broken_backlinks(
         self,
         select,
         target,
@@ -1065,11 +972,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def refdomains(
+    async def refdomains(
         self,
         select,
         target,
@@ -1131,11 +1038,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def anchors(
+    async def anchors(
         self,
         select,
         target,
@@ -1197,22 +1104,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def linkeddomains(
-        self,
-        select,
-        target,
-        timeout=None,
-        offset=None,
-        limit=None,
-        order_by=None,
-        where=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def linkeddomains(
+        self, select, target, timeout=None, offset=None, limit=None, order_by=None, where=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Retrieves linked domains for a specified target using the site explorer API endpoint.
@@ -1260,22 +1157,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def linked_anchors_external(
-        self,
-        select,
-        target,
-        timeout=None,
-        offset=None,
-        limit=None,
-        order_by=None,
-        where=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def linked_anchors_external(
+        self, select, target, timeout=None, offset=None, limit=None, order_by=None, where=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Fetch linked external anchor data for a specified target using provided selection and filtering criteria.
@@ -1323,22 +1210,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def linked_anchors_internal(
-        self,
-        select,
-        target,
-        timeout=None,
-        offset=None,
-        limit=None,
-        order_by=None,
-        where=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def linked_anchors_internal(
+        self, select, target, timeout=None, offset=None, limit=None, order_by=None, where=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Fetches internal linked anchor data for a specified target from the site explorer API, applying optional filtering and query parameters.
@@ -1386,11 +1263,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def organic_keywords(
+    async def organic_keywords(
         self,
         select,
         target,
@@ -1465,11 +1342,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def organic_competitors(
+    async def organic_competitors(
         self,
         select,
         target,
@@ -1544,11 +1421,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def top_pages(
+    async def top_pages(
         self,
         select,
         target,
@@ -1621,11 +1498,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def paid_pages(
+    async def paid_pages(
         self,
         select,
         target,
@@ -1698,11 +1575,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def best_by_external_links(
+    async def best_by_external_links(
         self,
         select,
         target,
@@ -1764,22 +1641,12 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def best_by_internal_links(
-        self,
-        select,
-        target,
-        timeout=None,
-        offset=None,
-        limit=None,
-        order_by=None,
-        where=None,
-        protocol=None,
-        mode=None,
-        output=None,
+    async def best_by_internal_links(
+        self, select, target, timeout=None, offset=None, limit=None, order_by=None, where=None, protocol=None, mode=None, output=None
     ) -> dict[str, Any]:
         """
         Retrieves the best-performing internal links for a specified target using the site explorer API endpoint.
@@ -1827,11 +1694,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def total_search_volume_history(
+    async def total_search_volume_history(
         self,
         date_from,
         target,
@@ -1890,11 +1757,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def keyword_explorer_overview(
+    async def keyword_explorer_overview(
         self,
         select,
         country,
@@ -1965,11 +1832,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def volume_history(self, country, keyword, output=None) -> dict[str, Any]:
+    async def volume_history(self, country, keyword, output=None) -> dict[str, Any]:
         """
         Fetches the historical search volume for a given keyword in a specified country.
 
@@ -1993,18 +1860,12 @@ class AhrefsApp(APIApplication):
         if keyword is None:
             raise ValueError("Missing required parameter 'keyword'")
         url = f"{self.base_url}/keywords-explorer/volume-history"
-        query_params = {
-            k: v
-            for k, v in [("country", country), ("keyword", keyword), ("output", output)]
-            if v is not None
-        }
-        response = self._get(url, params=query_params)
+        query_params = {k: v for k, v in [("country", country), ("keyword", keyword), ("output", output)] if v is not None}
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def volume_by_country(
-        self, keyword, limit=None, search_engine=None, output=None
-    ) -> dict[str, Any]:
+    async def volume_by_country(self, keyword, limit=None, search_engine=None, output=None) -> dict[str, Any]:
         """
         Retrieves search volume by country for a given keyword.
 
@@ -2027,20 +1888,13 @@ class AhrefsApp(APIApplication):
             raise ValueError("Missing required parameter 'keyword'")
         url = f"{self.base_url}/keywords-explorer/volume-by-country"
         query_params = {
-            k: v
-            for k, v in [
-                ("limit", limit),
-                ("search_engine", search_engine),
-                ("keyword", keyword),
-                ("output", output),
-            ]
-            if v is not None
+            k: v for k, v in [("limit", limit), ("search_engine", search_engine), ("keyword", keyword), ("output", output)] if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def matching_terms(
+    async def matching_terms(
         self,
         select,
         country,
@@ -2108,11 +1962,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def related_terms(
+    async def related_terms(
         self,
         select,
         country,
@@ -2176,11 +2030,11 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()
 
-    def search_suggestions(
+    async def search_suggestions(
         self,
         select,
         country,
@@ -2242,7 +2096,7 @@ class AhrefsApp(APIApplication):
             ]
             if v is not None
         }
-        response = self._get(url, params=query_params)
+        response = await self._aget(url, params=query_params)
         response.raise_for_status()
         return response.json()