Feat: Add search() and get_domain() methods

- Add search(query, scope, page) for simple query string syntax
- Add get_domain() endpoint for domain lookups
- Bump version to 0.2.0

Author: Chocapikk

leakix/client.py

@@ -9,7 +9,7 @@
 
 from leakix.domain import L9Subdomain
 from leakix.plugin import APIResult
-from leakix.query import EmptyQuery, Query
+from leakix.query import EmptyQuery, Query, RawQuery
 from leakix.response import (
     AbstractResponse,
     ErrorResponse,
@@ -243,3 +243,43 @@ def bulk_service(self, queries: list[Query] | None = None) -> AbstractResponse:
             return ErrorResponse(response=r, response_json=[], status_code=200)
         else:
             return ErrorResponse(response=r, response_json=r.json())
+
+    def get_domain(self, domain: str) -> AbstractResponse:
+        """
+        Returns the list of services and associated leaks for a given domain.
+        """
+        url = f"{self.base_url}/domain/{domain}"
+        r = self.__get(url, params=None)
+        if r.is_success():
+            response_json = r.json()
+            formatted_result = HostResult.from_dict(response_json)
+            response_json = {
+                "services": formatted_result.Services,
+                "leaks": formatted_result.Leaks,
+            }
+            r.response_json = response_json
+        return r
+
+    def search(self, query: str, scope: str = "leak", page: int = 0) -> AbstractResponse:
+        """
+        Simple search using a query string.
+
+        This is a convenience method that accepts a raw query string like on the website.
+        For example: "+plugin:GitConfigHttpPlugin +country:FR"
+
+        Args:
+            query: The search query string (same syntax as the website)
+            scope: Either "leak" or "service" (default: "leak")
+            page: Page number for pagination (default: 0)
+
+        Returns:
+            A response object with the search results.
+
+        Example:
+            >>> client.search("+plugin:GitConfigHttpPlugin", scope="leak")
+            >>> client.search("+country:FR +port:22", scope="service")
+        """
+        queries = [RawQuery(query)]
+        if scope == "service":
+            return self.get_service(queries=queries, page=page)
+        return self.get_leak(queries=queries, page=page)

pyproject.toml

@@ -1,8 +1,11 @@
 [tool.poetry]
 name = "leakix"
-version = "0.1.10"
+version = "0.2.0"
 description = "Official python client for LeakIX (https://leakix.net)"
-authors = ["Danny Willems <danny@leakix.net>"]
+authors = [
+    "Danny Willems <danny@leakix.net>",
+    "Valentin Lobstein <valentin@leakix.net>",
+]
 
 [tool.poetry.dependencies]
 python = "^3.13"