ownapi 1.0.0__py3-none-any.whl

registry/thy/schema.json

@@ -0,0 +1,46 @@
+{
+  "service_name": "thy",
+  "target_url": "https://www.turkishairlines.com/tr-tr/",
+  "goal": "İstanbul'dan Ankara'ya uçuş seferlerini ve fiyatlarını sorgula",
+  "function_name": "search_flights",
+  "explanation": "Kullanıcının hedefi İstanbul'dan Ankara'ya uçuş seferlerini ve fiyatlarını sorgulamak olduğundan, uçuş müsaitlik ve fiyat bilgilerini içeren '/api/v1/availability' uç noktası en uygun seçimdir. Bu uç nokta, uçuş bilgilerini almak için gerekli olan tüm parametreleri içermektedir.",
+  "method": "POST",
+  "endpoint_url": "https://www.turkishairlines.com/api/v1/availability",
+  "dynamic_params": [
+    {
+      "name": "departure_date",
+      "original_key": "departureDate",
+      "location": "body",
+      "param_type": "str",
+      "default_value": "02-03-2027",
+      "description": "Kalkış tarihi"
+    },
+    {
+      "name": "return_date",
+      "original_key": "departureDate",
+      "location": "body",
+      "param_type": "str",
+      "default_value": "09-03-2027",
+      "description": "Dönüş tarihi"
+    },
+    {
+      "name": "origin_airport_code",
+      "original_key": "originAirportCode",
+      "location": "body",
+      "param_type": "str",
+      "default_value": "IST",
+      "description": "Kalkış havaalanı kodu"
+    },
+    {
+      "name": "destination_airport_code",
+      "original_key": "destinationAirportCode",
+      "location": "body",
+      "param_type": "str",
+      "default_value": "ESB",
+      "description": "Varış havaalanı kodu"
+    }
+  ],
+  "created_at": "2026-11-01T16:00:17.309297+00:00",
+  "validation_status": "BAŞARILI",
+  "validation_passed_runs": 3
+}

registry/trendyol/__init__.py

@@ -0,0 +1,5 @@
+"""OwnAPI Registry Module: trendyol."""
+
+from .client import TrendyolClient, search_products
+
+__all__ = ["search_products", "TrendyolClient"]

registry/trendyol/client.py

@@ -0,0 +1,228 @@
+from __future__ import annotations
+
+import json
+import logging
+import pathlib
+import sys
+import time
+from typing import Any
+from urllib.parse import quote_plus, urlencode
+
+if hasattr(sys.stdout, "reconfigure"):
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[2]))
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent))
+
+from core.base_client import BaseOwnClient
+from core.token_store import TokenStore
+
+logger = logging.getLogger("own_api.trendyol")
+
+
+class TrendyolClient(BaseOwnClient):
+    """Trendyol e-ticaret servisi için OwnAPI User-Delegated Browser Middleware istemcisi."""
+
+    def __init__(
+        self,
+        tenant_id: str = "default",
+        token_store: TokenStore | None = None,
+        mode: str = "local",
+    ) -> None:
+        super().__init__(
+            service_name="trendyol",
+            base_url="https://www.trendyol.com",
+            tenant_id=tenant_id,
+            token_store=token_store,
+            mode=mode,
+        )
+
+    def search(
+        self,
+        query: str = "laptop",
+        max_results: int = 10,
+    ) -> dict[str, Any]:
+        """Trendyol üzerinde ürün araması yapar ve yapılandırılmış ürün listesini döndürür."""
+        clean_query = str(query).strip()
+        encoded_query = quote_plus(clean_query)
+        search_path = f"/sr?q={encoded_query}"
+        full_url = f"{self.base_url}{search_path}"
+
+        headers = {
+            "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+            "accept-language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
+            "referer": "https://www.trendyol.com/",
+        }
+
+        # İsteği doğrudan BaseShadowClient (In-Browser Fetch) üzerinden gönder
+        raw = self.request(
+            method="GET",
+            url=full_url,
+            headers=headers,
+        )
+
+        # Yanıt HTML metnini al
+        html_text = ""
+        if isinstance(raw, dict):
+            html_text = raw.get("text", "")
+            if not html_text and "error" in raw and not raw.get("success", True):
+                return raw
+        elif isinstance(raw, str):
+            html_text = raw
+
+        parsed = self._extract_products_from_html(html_text, clean_query, max_results)
+        return parsed
+
+    @staticmethod
+    def _extract_products_from_html(html_text: str, query: str, max_results: int) -> dict[str, Any]:
+        """Trendyol SSR HTML içindeki __single-search-result__PROPS JSON bloğunu ayrıştırır."""
+        prefix = 'window["__single-search-result__PROPS"]='
+        idx = html_text.find(prefix)
+        if idx == -1:
+            prefix_alt = 'window.__SEARCH_APP_INITIAL_STATE__='
+            idx = html_text.find(prefix_alt)
+            prefix = prefix_alt
+
+        raw_products: list[dict[str, Any]] = []
+        if idx != -1:
+            sub = html_text[idx + len(prefix):]
+            end_script = sub.find("</script>")
+            if end_script != -1:
+                raw_json = sub[:end_script].rstrip(";").strip()
+                try:
+                    data = json.loads(raw_json)
+                    if isinstance(data, dict):
+                        if "data" in data and isinstance(data["data"], dict):
+                            raw_products = data["data"].get("products", [])
+                        elif "products" in data:
+                            raw_products = data["products"]
+                except Exception as e:
+                    logger.warning(f"Trendyol JSON parse hatası: {e}")
+
+        formatted_products: list[dict[str, Any]] = []
+        for p in raw_products[:max_results]:
+            if not isinstance(p, dict):
+                continue
+
+            # Fiyat ayıklama
+            p_price = p.get("price")
+            discounted_val = None
+            original_val = None
+            currency = "TL"
+
+            if isinstance(p_price, dict):
+                discounted_val = p_price.get("discountedPrice") or p_price.get("current")
+                if isinstance(discounted_val, dict):
+                    discounted_val = discounted_val.get("value")
+                original_val = p_price.get("originalPrice") or p_price.get("old")
+                if isinstance(original_val, dict):
+                    original_val = original_val.get("value")
+                currency = p_price.get("currency") or p_price.get("currencySymbol") or "TL"
+            elif isinstance(p_price, (int, float)):
+                discounted_val = float(p_price)
+
+            # Marka ayıklama
+            brand = p.get("brand")
+            brand_name = brand.get("name", "") if isinstance(brand, dict) else str(brand or "")
+
+            # Puan ayıklama
+            rating_score = p.get("ratingScore")
+            avg_rating = None
+            total_reviews = None
+            if isinstance(rating_score, dict):
+                avg_rating = rating_score.get("averageRating")
+                total_reviews = rating_score.get("totalCount")
+
+            # URL
+            rel_url = p.get("url", "")
+            full_prod_url = f"https://www.trendyol.com{rel_url}" if rel_url.startswith("/") else rel_url
+
+            formatted_products.append({
+                "id": p.get("id"),
+                "name": p.get("name", ""),
+                "brand": brand_name,
+                "price": discounted_val,
+                "original_price": original_val,
+                "currency": currency,
+                "rating": round(avg_rating, 2) if isinstance(avg_rating, (int, float)) else None,
+                "review_count": total_reviews,
+                "url": full_prod_url,
+            })
+
+        return {
+            "success": True,
+            "service": "trendyol",
+            "query": query,
+            "total_found": len(raw_products),
+            "returned_count": len(formatted_products),
+            "products": formatted_products,
+        }
+
+
+def search_products(
+    query: str = "laptop",
+    max_results: int = 10,
+    tenant_id: str = "default",
+    mode: str = "local",
+) -> dict[str, Any]:
+    """
+    Trendyol üzerinde ürün arama ve fiyat karşılaştırması yapar.
+    query: Aranacak kelime (örn: 'laptop', 'iphone 15', 'kablosuz kulaklık')
+    max_results: Döndürülecek maksimum ürün sayısı (varsayılan: 10)
+    tenant_id: Oturum izolasyonu için kiracı ID'si (varsayılan: 'default')
+    mode: Çalışma modu ('local' yerel Chrome veya 'cloud' Docker/Remote Browser)
+    """
+    client = TrendyolClient(tenant_id=tenant_id, mode=mode)
+    return client.search(query=query, max_results=max_results)
+
+
+def print_product_summary(data: dict[str, Any], elapsed_ms: float = 0.0) -> None:
+    """Ayrıştırılmış ürün sonuçlarını terminalde tablo gibi temiz bir formatta yazdırır."""
+    products = data.get("products", [])
+    query = data.get("query", "")
+    total = data.get("total_found", 0)
+
+    print("\n" + "=" * 80)
+    print(f"🛍️  Trendyol Arama Sonuçları: '{query}' | Bulunan: {total} | Gösterilen: {len(products)}")
+    if elapsed_ms > 0:
+        print(f"⏱️  Yanıt Süresi: {elapsed_ms:.2f} ms")
+    print("=" * 80)
+
+    if not products:
+        print("ℹ️ Eşleşen ürün bulunamadı.")
+        return
+
+    for idx, p in enumerate(products, 1):
+        name = p.get("name", "")
+        brand = p.get("brand", "")
+        price = p.get("price")
+        orig_price = p.get("original_price")
+        curr = p.get("currency", "TL")
+        rating = p.get("rating")
+        reviews = p.get("review_count")
+
+        price_str = f"{price:,.2f} {curr}" if isinstance(price, (int, float)) else "Belirtilmemiş"
+        if isinstance(orig_price, (int, float)) and orig_price > (price or 0):
+            price_str += f" (Eski: {orig_price:,.2f} {curr})"
+
+        rating_str = f"⭐ {rating}" if rating else ""
+        if reviews:
+            rating_str += f" ({reviews} değerlendirme)"
+
+        print(f"\n{idx:2d}. [{brand}] {name[:65]}")
+        print(f"    Fiyat: {price_str}  {rating_str}")
+        print(f"    Link : {p.get('url')}")
+
+    print("\n" + "=" * 80 + "\n")
+
+
+if __name__ == "__main__":
+    t0 = time.perf_counter()
+    query_arg = sys.argv[1] if len(sys.argv) > 1 else "laptop"
+    res = search_products(query=query_arg, max_results=5)
+    t_elapsed = (time.perf_counter() - t0) * 1000
+    print_product_summary(res, elapsed_ms=t_elapsed)

registry/trendyol/schema.json

@@ -0,0 +1,30 @@
+{
+  "service_name": "trendyol",
+  "target_url": "https://www.trendyol.com",
+  "goal": "Trendyol üzerinde ürün arama ve fiyat karşılaştırması yap",
+  "function_name": "search_products",
+  "explanation": "Trendyol arama motoru üzerinden verilen sorgu kelimesine göre ürünleri, markaları, güncel indirimli fiyatları ve ürün puanlarını listeler.",
+  "method": "GET",
+  "endpoint_url": "https://www.trendyol.com/sr",
+  "dynamic_params": [
+    {
+      "name": "query",
+      "original_key": "q",
+      "location": "query",
+      "param_type": "str",
+      "default_value": "laptop",
+      "description": "Aranacak ürün adı veya kategori"
+    },
+    {
+      "name": "max_results",
+      "original_key": "max_results",
+      "location": "query",
+      "param_type": "int",
+      "default_value": 10,
+      "description": "Döndürülecek maksimum ürün adedi"
+    }
+  ],
+  "created_at": "2026-11-03T23:00:00.000000+00:00",
+  "validation_status": "BAŞARILI",
+  "last_validated_at": "2026-11-06T19:33:43.505975+00:00"
+}

registry/ucak_bileti/client.py

@@ -0,0 +1,94 @@
+from __future__ import annotations
+
+import pathlib
+import sys
+import time
+from typing import Any
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[2]))
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent))
+
+from core.base_client import BaseOwnClient
+from core.token_store import TokenStore
+
+
+class UcakBiletiClient(BaseOwnClient):
+    """Obilet / Uçak Bileti servisi için OwnAPI User-Delegated Browser Middleware + Generic Form Automation istemcisi."""
+
+    def __init__(
+        self,
+        base_url: str = "https://www.obilet.com",
+        tenant_id: str = "default",
+        token_store: TokenStore | None = None,
+        mode: str = "local",
+    ) -> None:
+        super().__init__(
+            service_name="ucak_bileti",
+            base_url=base_url,
+            tenant_id=tenant_id,
+            token_store=token_store,
+            mode=mode,
+        )
+
+    def search_flight_offers(
+        self,
+        origin_id: str = "250_0",
+        destination_id: str = "1912_170",
+        departure_date: str = "20270707",
+        return_date: str = "20270714",
+        tenant_id: str | None = None,
+        mode: str | None = None,
+    ) -> dict[str, Any]:
+        """
+        İki şehir ve tarih arasında uçak bileti seferlerini ve fiyatlarını
+        Generic Form Automation + In-Browser Fetch katmanı üzerinden sorgular.
+        """
+        url = f"{self.base_url}/json/ucuslar/async/{origin_id}-{destination_id}/{departure_date}-{return_date}/2a-1c-1s/economy"
+        headers = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "origin": "https://www.obilet.com",
+            "referer": f"https://www.obilet.com/ucuslar/{origin_id}-{destination_id}/{departure_date}-{return_date}/2a-1c-1s/economy/all",
+        }
+        return self.request(
+            method="GET",
+            url=url,
+            headers=headers,
+            target_url="https://www.obilet.com/ucak-bileti",
+            mode=mode or self.mode,
+            form_params={
+                "origin": origin_id,
+                "destination": destination_id,
+                "departure_date": departure_date,
+                "return_date": return_date,
+            },
+        )
+
+
+def search_flight_offers(
+    origin_id: str = "250_0",
+    destination_id: str = "1912_170",
+    departure_date: str = "20270707",
+    return_date: str = "20270714",
+    tenant_id: str = "default",
+    mode: str = "local",
+) -> dict[str, Any]:
+    client = UcakBiletiClient(tenant_id=tenant_id, mode=mode)
+    return client.search_flight_offers(
+        origin_id=origin_id,
+        destination_id=destination_id,
+        departure_date=departure_date,
+        return_date=return_date,
+        tenant_id=tenant_id,
+        mode=mode,
+    )
+
+
+if __name__ == "__main__":
+    client = UcakBiletiClient()
+    start_time = time.perf_counter()
+    result = client.search_flight_offers()
+    end_time = time.perf_counter()
+    duration = (end_time - start_time) * 1000
+    print(f"Sorgu süresi: {duration:.2f} ms")
+    print("Uçuş teklifleri:", result.get("data", {}).get("result", {}) if isinstance(result, dict) else result)

registry/ucak_bileti/schema.json

@@ -0,0 +1,47 @@
+{
+  "service_name": "ucak_bileti",
+  "target_url": "https://www.obilet.com/ucak-bileti",
+  "goal": "İki şehir ve tarih arasında uçak bileti seferlerini ve fiyatlarını sorgula",
+  "function_name": "search_flight_offers",
+  "explanation": "Kullanıcının hedefi iki şehir ve tarih arasında uçak bileti seferlerini ve fiyatlarını sorgulamak olduğundan, '/json/ucuslar/async/250_0-1912_170/20270707-20270714/2a-1c-1s/economy' uç noktası bu amaca en uygun olanıdır. Bu uç nokta, belirli bir rota ve tarih aralığında uçuş araması yapmaktadır.",
+  "method": "POST",
+  "endpoint_url": "https://www.obilet.com/json/ucuslar/async/250_0-1912_170/20270707-20270714/2a-1c-1s/economy",
+  "dynamic_params": [
+    {
+      "name": "origin_id",
+      "original_key": "origin-id",
+      "location": "path",
+      "param_type": "str",
+      "default_value": "250_0",
+      "description": "Kalkış şehrinin ve havaalanının ID'si."
+    },
+    {
+      "name": "destination_id",
+      "original_key": "destination-id",
+      "location": "path",
+      "param_type": "str",
+      "default_value": "1912_170",
+      "description": "Varış şehrinin ve havaalanının ID'si."
+    },
+    {
+      "name": "departure_date",
+      "original_key": "departure",
+      "location": "path",
+      "param_type": "str",
+      "default_value": "20270707",
+      "description": "Kalkış tarihi (YYYYMMDD formatında)."
+    },
+    {
+      "name": "return_date",
+      "original_key": "return",
+      "location": "path",
+      "param_type": "str",
+      "default_value": "20270714",
+      "description": "Dönüş tarihi (YYYYMMDD formatında)."
+    }
+  ],
+  "created_at": "2026-10-31T22:19:17.567346+00:00",
+  "validation_status": "BAŞARISIZ",
+  "validation_passed_runs": 0,
+  "last_validated_at": "2026-11-06T19:34:38.312611+00:00"
+}

registry/wikipedia/__init__.py

@@ -0,0 +1,5 @@
+"""OwnAPI Registry Module: wikipedia."""
+
+from .client import WikipediaClient, search_wikipedia
+
+__all__ = ["search_wikipedia", "WikipediaClient"]

registry/wikipedia/client.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+import pathlib
+import sys
+import time
+from typing import Any
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[2]))
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent))
+
+from core.base_client import BaseOwnClient
+from core.token_store import TokenStore
+
+
+class WikipediaClient(BaseOwnClient):
+    """Wikipedia REST API için OwnAPI User-Delegated Browser Middleware istemcisi."""
+
+    def __init__(
+        self,
+        tenant_id: str = "default",
+        token_store: TokenStore | None = None,
+        mode: str = "local",
+    ) -> None:
+        super().__init__(
+            service_name="wikipedia",
+            base_url="https://en.wikipedia.org/",
+            tenant_id=tenant_id,
+            token_store=token_store,
+            mode=mode,
+        )
+
+    def search_wikipedia(self, query: str = "peter thiel", limit: int = 10) -> dict[str, Any]:
+        url = "https://en.wikipedia.org/w/rest.php/v1/search/title"
+        headers = {
+            "accept": "application/json",
+            "referer": "https://en.wikipedia.org/",
+        }
+        params = {
+            "q": query,
+            "limit": limit,
+        }
+        return self.request(method="GET", url=url, headers=headers, params=params)
+
+
+def search_wikipedia(
+    query: str = "peter thiel",
+    limit: int = 10,
+    tenant_id: str = "default",
+    mode: str = "local",
+) -> dict[str, Any]:
+    """
+    Wikipedia üzerinde kavram ve kişi araması yapar (OwnAPI User-Delegated Browser Middleware).
+    """
+    client = WikipediaClient(tenant_id=tenant_id, mode=mode)
+    return client.search_wikipedia(query=query, limit=limit)
+
+
+if __name__ == "__main__":
+    start_time = time.perf_counter()
+    results = search_wikipedia()
+    elapsed_time = (time.perf_counter() - start_time) * 1000
+    pages = results.get("pages", []) if isinstance(results, dict) else []
+    print(f"[OwnAPI] Arama sonuçları: {pages[:2]}... (Toplam {len(pages)} sonuç)")
+    print(f"[OwnAPI] Sorgu süresi: {elapsed_time:.2f} ms")

registry/wikipedia/schema.json

@@ -0,0 +1,31 @@
+{
+  "service_name": "wikipedia",
+  "target_url": "https://en.wikipedia.org",
+  "goal": "Wikipedia üzerinde kavram ve kişi araması yap",
+  "function_name": "search_wikipedia",
+  "explanation": "Kullanıcının amacı Wikipedia üzerinde kavram ve kişi araması yapmak olduğundan, '/w/rest.php/v1/search/title' uç noktası arama sorgularını gerçekleştirmek için en uygun uç noktadır. Bu uç nokta, arama sorgusu ve sonuç limiti gibi dinamik parametreleri desteklemektedir.",
+  "method": "GET",
+  "endpoint_url": "https://en.wikipedia.org/w/rest.php/v1/search/title",
+  "dynamic_params": [
+    {
+      "name": "query",
+      "original_key": "q",
+      "location": "query",
+      "param_type": "str",
+      "default_value": "peter thiel",
+      "description": "Aranacak kavram veya kişi ismi."
+    },
+    {
+      "name": "limit",
+      "original_key": "limit",
+      "location": "query",
+      "param_type": "int",
+      "default_value": 10,
+      "description": "Dönen sonuçların sayısı."
+    }
+  ],
+  "created_at": "2026-10-31T22:06:55.412344+00:00",
+  "validation_status": "BAŞARILI",
+  "validation_passed_runs": 3,
+  "last_validated_at": "2026-11-05T15:27:20.325892+00:00"
+}

registry/yahoo_finance/__init__.py

@@ -0,0 +1,5 @@
+"""OwnAPI Registry Module: yahoo_finance."""
+
+from .client import YahooFinanceClient, get_stock_quote
+
+__all__ = ["get_stock_quote", "YahooFinanceClient"]

registry/yahoo_finance/client.py

@@ -0,0 +1,98 @@
+from __future__ import annotations
+
+import json
+import pathlib
+import sys
+import time
+from typing import Any
+from urllib.parse import quote
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[2]))
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent))
+
+from core.base_client import BaseOwnClient
+from core.token_store import TokenStore
+
+
+class YahooFinanceClient(BaseOwnClient):
+    """Yahoo Finance real-time stock quote & chart client via OwnAPI User-Delegated Browser Middleware."""
+
+    def __init__(
+        self,
+        tenant_id: str = "default",
+        token_store: TokenStore | None = None,
+        mode: str = "local",
+    ) -> None:
+        super().__init__(
+            service_name="yahoo_finance",
+            base_url="https://finance.yahoo.com/",
+            tenant_id=tenant_id,
+            token_store=token_store,
+            mode=mode,
+        )
+
+    def get_stock_quote(self, symbol: str = "NVDA") -> dict[str, Any]:
+        clean_symbol = quote(str(symbol).strip().upper() or "NVDA")
+        url = f"https://query1.finance.yahoo.com/v8/finance/chart/{clean_symbol}"
+        headers = {
+            "accept": "application/json, text/plain, */*",
+            "referer": f"https://finance.yahoo.com/quote/{clean_symbol}/",
+        }
+        params = {
+            "interval": "1d",
+            "range": "5d",
+        }
+        raw = self.request(method="GET", url=url, headers=headers, params=params)
+        if not isinstance(raw, dict):
+            return {"success": False, "symbol": symbol, "raw": raw}
+
+        chart = raw.get("chart", {})
+        results = chart.get("result") or []
+        if results and isinstance(results[0], dict):
+            meta = results[0].get("meta", {})
+            price = meta.get("regularMarketPrice")
+            prev_close = meta.get("chartPreviousClose") or meta.get("previousClose")
+            change = round(price - prev_close, 4) if isinstance(price, (int, float)) and isinstance(prev_close, (int, float)) else None
+            change_pct = (
+                round(((price - prev_close) / prev_close) * 100.0, 2)
+                if change is not None and prev_close
+                else None
+            )
+            return {
+                "success": True,
+                "service": "yahoo_finance",
+                "symbol": meta.get("symbol", clean_symbol),
+                "short_name": meta.get("shortName") or meta.get("longName") or clean_symbol,
+                "currency": meta.get("currency", "USD"),
+                "exchange": meta.get("fullExchangeName") or meta.get("exchangeName"),
+                "regular_market_price": price,
+                "previous_close": prev_close,
+                "change": change,
+                "change_percent": change_pct,
+                "fifty_two_week_high": meta.get("fiftyTwoWeekHigh"),
+                "fifty_two_week_low": meta.get("fiftyTwoWeekLow"),
+                "regular_market_volume": meta.get("regularMarketVolume"),
+                "meta": meta,
+            }
+        return raw
+
+
+def get_stock_quote(
+    symbol: str = "NVDA",
+    tenant_id: str = "default",
+    mode: str = "local",
+) -> dict[str, Any]:
+    """
+    Fetches real-time stock/index price, daily change, and 52-week range from Yahoo Finance
+    via OwnAPI User-Delegated Browser Middleware.
+    """
+    client = YahooFinanceClient(tenant_id=tenant_id, mode=mode)
+    return client.get_stock_quote(symbol=symbol)
+
+
+if __name__ == "__main__":
+    t0 = time.perf_counter()
+    res = get_stock_quote()
+    elapsed = (time.perf_counter() - t0) * 1000
+    print(f"[OwnAPI - Yahoo Finance] ({elapsed:.1f} ms)")
+    print(json.dumps(res, ensure_ascii=False, indent=2)[:800])