perplexity-webui-scraper 1.0.0__tar.gz → 1.0.2__tar.gz

{perplexity_webui_scraper-1.0.0 → perplexity_webui_scraper-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: perplexity-webui-scraper
-Version: 1.0.0
+Version: 1.0.2
 Summary: An advanced, high-performance Python client, MCP server, and REST API for reverse-engineering Perplexity AI's WebUI.
 Keywords: perplexity,ai,scraper,mcp,fastapi,openai-compatible
 Author: Henrique Moreira

{perplexity_webui_scraper-1.0.0 → perplexity_webui_scraper-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "perplexity-webui-scraper"
-version = "1.0.0"
+version = "1.0.2"
 description = "An advanced, high-performance Python client, MCP server, and REST API for reverse-engineering Perplexity AI's WebUI."
 authors = [{ name = "Henrique Moreira", email = "github@henriquecoder.com" }]
 license = { text = "MIT" }
@@ -60,6 +60,7 @@ dev = [
 docs = [
     "mkdocs~=1.6.0",
     "mkdocs-material~=9.7.0",
+    "mkdocstrings[python]~=1.0.0",
 ]
 lint = [
     "ruff~=0.15.0",

{perplexity_webui_scraper-1.0.0 → perplexity_webui_scraper-1.0.2}/src/perplexity_webui_scraper/_static/models.json

@@ -1,10 +1,10 @@
 [
   {
     "id": "perplexity/best",
-    "name": "Pro",
-    "description": "Perplexity Pro (Auto-select).",
+    "name": "Best",
+    "description": "Perplexity Best (Auto-select).",
     "identifier": "default",
-    "tool_name": "pplx_ask",
+    "tool_name": "pplx_best",
     "min_tier": "pro",
     "mode": "search"
   },
@@ -72,21 +72,21 @@
     "mode": "copilot"
   },
   {
-    "id": "anthropic/claude-opus-4.6",
-    "name": "Claude Opus 4.6",
-    "description": "Anthropic Claude Opus 4.6.",
-    "identifier": "claude46opus",
-    "tool_name": "pplx_claude_o46",
-    "min_tier": "max",
+    "id": "anthropic/claude-sonnet-4.6",
+    "name": "Claude Sonnet 4.6",
+    "description": "Anthropic Claude Sonnet 4.6.",
+    "identifier": "claude46sonnet",
+    "tool_name": "pplx_claude_s46",
+    "min_tier": "pro",
     "mode": "copilot"
   },
   {
-    "id": "anthropic/claude-opus-4.6-thinking",
-    "name": "Claude Opus 4.6 Thinking",
-    "description": "Anthropic Claude Opus 4.6 (Thinking).",
-    "identifier": "claude46opusthinking",
-    "tool_name": "pplx_claude_o46_think",
-    "min_tier": "max",
+    "id": "anthropic/claude-sonnet-4.6-thinking",
+    "name": "Claude Sonnet 4.6 Thinking",
+    "description": "Anthropic Claude Sonnet 4.6 (Thinking).",
+    "identifier": "claude46sonnetthinking",
+    "tool_name": "pplx_claude_s46_think",
+    "min_tier": "pro",
     "mode": "copilot"
   },
   {

perplexity_webui_scraper-1.0.2/src/perplexity_webui_scraper/api/cli.py

@@ -0,0 +1,65 @@
+"""Typer CLI for the OpenAI-compatible Perplexity API server."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+from typer import Option, Typer
+from uvicorn import run as uvicorn_run
+
+
+console = Console(stderr=True, soft_wrap=True)
+
+app = Typer(
+    name="perplexity-webui-scraper-api",
+    help="OpenAI-compatible API server powered by Perplexity WebUI Scraper.",
+    add_completion=False,
+)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    host: Annotated[
+        str,
+        Option("--host", "-H", help="Host address to bind the server to."),
+    ] = "127.0.0.1",
+    port: Annotated[
+        int,
+        Option("--port", "-p", help="Port to listen on."),
+    ] = 8000,
+    reload: Annotated[
+        bool,
+        Option("--reload", help="Enable auto-reload for development."),
+    ] = False,
+    log_level: Annotated[
+        str,
+        Option("--log-level", help="Uvicorn log level."),
+    ] = "info",
+) -> None:
+    """Start the OpenAI-compatible API server.
+
+    Authentication is done per-request via the Authorization: Bearer header.
+    Pass your Perplexity session token as the API key in every request.
+    """
+    info = Text.assemble(
+        ("🌐  URL:   ", "bold cyan"),
+        (f"http://{host}:{port}\n", "white"),
+        ("📖  Docs:  ", "bold cyan"),
+        (f"http://{host}:{port}/docs\n", "white"),
+        ("📘  ReDoc: ", "bold cyan"),
+        (f"http://{host}:{port}/redoc\n", "white"),
+        ("🔑  Auth:  ", "bold cyan"),
+        ("Authorization: Bearer <your_session_token>", "dim white"),
+    )
+    console.print(Panel(info, title="[bold green]Perplexity API Server[/bold green]", expand=False))
+
+    uvicorn_run(
+        "perplexity_webui_scraper.api.server:app",
+        host=host,
+        port=port,
+        reload=reload,
+        log_level=log_level.lower(),
+    )

perplexity_webui_scraper-1.0.2/src/perplexity_webui_scraper/api/launcher.py

@@ -0,0 +1,65 @@
+"""Typer CLI for launching the OpenAI-compatible Perplexity API server."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+from typer import Option, Typer
+from uvicorn import run as uvicorn_run
+
+
+console = Console(stderr=True, soft_wrap=True)
+
+app = Typer(
+    name="perplexity-webui-scraper-api",
+    help="OpenAI-compatible API server powered by Perplexity WebUI Scraper.",
+    add_completion=False,
+)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    host: Annotated[
+        str,
+        Option("--host", "-H", help="Host address to bind the server to."),
+    ] = "127.0.0.1",
+    port: Annotated[
+        int,
+        Option("--port", "-p", help="Port to listen on."),
+    ] = 8000,
+    reload: Annotated[
+        bool,
+        Option("--reload", help="Enable auto-reload for development."),
+    ] = False,
+    log_level: Annotated[
+        str,
+        Option("--log-level", help="Uvicorn log level."),
+    ] = "info",
+) -> None:
+    """Start the OpenAI-compatible Perplexity API server.
+
+    Authentication is done per-request via the ``Authorization: Bearer`` header.
+    Pass your Perplexity session token as the API key in every request.
+    """
+    info = Text.assemble(
+        ("🌐  URL:   ", "bold cyan"),
+        (f"http://{host}:{port}\n", "white"),
+        ("📖  Docs:  ", "bold cyan"),
+        (f"http://{host}:{port}/docs\n", "white"),
+        ("📘  ReDoc: ", "bold cyan"),
+        (f"http://{host}:{port}/redoc\n", "white"),
+        ("🔑  Auth:  ", "bold cyan"),
+        ("Authorization: Bearer <your_session_token>", "dim white"),
+    )
+    console.print(Panel(info, title="[bold green]Perplexity API Server[/bold green]", expand=False))
+
+    uvicorn_run(
+        "perplexity_webui_scraper.api.app:app",
+        host=host,
+        port=port,
+        reload=reload,
+        log_level=log_level.lower(),
+    )

perplexity_webui_scraper-1.0.2/src/perplexity_webui_scraper/cli/commands/get_session_token.py

@@ -0,0 +1,162 @@
+"""get-session-token CLI command — extracts the Perplexity session cookie.
+
+Uses the email → OTP code → redirect-link → cookie extraction flow via curl-cffi.
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from curl_cffi.requests import Session
+from pyperclip import PyperclipException, copy
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Confirm, Prompt
+import typer
+
+from perplexity_webui_scraper._internal.constants import (
+    API_BASE_URL,
+    ENDPOINT_AUTH_CSRF,
+    ENDPOINT_AUTH_OTP_REDIRECT,
+    ENDPOINT_AUTH_SIGNIN,
+    SESSION_COOKIE_NAME,
+)
+
+
+_DEFAULT_HEADERS: dict[str, str] = {
+    "Referer": f"{API_BASE_URL}/",
+    "Origin": API_BASE_URL,
+}
+
+console = Console(stderr=True, soft_wrap=True)
+
+
+def _show_header() -> None:
+    """Display the welcome header panel."""
+    console.print(
+        Panel(
+            "[bold white]Perplexity WebUI Scraper[/bold white]\n\n"
+            "Automatic session token generator via email authentication.\n"
+            "[dim]All session data will be cleared on exit.[/dim]",
+            title="🔐 Token Generator",
+            border_style="cyan",
+        )
+    )
+
+
+def _show_exit_message() -> None:
+    """Display the security note and wait for the user to press ENTER before clearing the screen."""
+    console.print("\n[bold yellow]⚠️ Security Note:[/bold yellow]")
+    console.print("Press [bold white]ENTER[/bold white] to clear screen and exit.")
+    console.input()
+
+
+def run(
+    email: Annotated[str | None, typer.Argument(help="Your Perplexity account email.")] = None,
+) -> None:
+    """Extract your Perplexity session token using email OTP authentication.
+
+    Guides the user through email-based sign-in (OTP or magic link),
+    displays the extracted session token, and offers to copy it to the
+    clipboard. The screen is cleared on exit for security.
+    """
+    with console.screen():
+        try:
+            _show_header()
+
+            if not email:
+                console.print("\n[bold cyan]Step 1: Email Verification[/bold cyan]")
+                email = Prompt.ask("  Enter your Perplexity email", console=console)
+            else:
+                console.print(f"\n[bold cyan]Step 1: Email Verification[/bold cyan] (using [white]{email}[/white])")
+
+            email = email.strip()
+
+            if not email or "@" not in email:
+                raise ValueError("Invalid email address.")
+
+            with Session(impersonate="chrome", headers=_DEFAULT_HEADERS) as session:
+                # Step 1: Obtain CSRF token
+                with console.status("[bold green]Initializing secure connection...", spinner="dots"):
+                    session.get(API_BASE_URL)
+                    csrf_response = session.get(f"{API_BASE_URL}{ENDPOINT_AUTH_CSRF}")
+                    csrf_response.raise_for_status()
+                    csrf_token: str = csrf_response.json().get("csrfToken", "")
+
+                    if not csrf_token:
+                        raise ValueError("Failed to obtain CSRF token.")
+
+                # Step 2: Send OTP email
+                with console.status("[bold green]Sending verification code...", spinner="dots"):
+                    signin_response = session.post(
+                        f"{API_BASE_URL}{ENDPOINT_AUTH_SIGNIN}?version=2.18&source=default",
+                        json={
+                            "email": email,
+                            "csrfToken": csrf_token,
+                            "useNumericOtp": "true",
+                            "json": "true",
+                            "callbackUrl": f"{API_BASE_URL}/?login-source=floatingSignup",
+                        },
+                    )
+                    signin_response.raise_for_status()
+
+                console.print("\n[bold cyan]Step 2: Verification[/bold cyan]")
+                console.print("  Check your email for a [bold]6-digit code[/bold] or [bold]magic link[/bold].")
+
+                # Step 3: Prompt user for OTP code
+                otp_code = Prompt.ask("  Enter code or paste link", console=console).strip()
+
+                if not otp_code:
+                    raise ValueError("OTP code cannot be empty.")
+
+                # Step 4: Convert OTP to redirect URL
+                with console.status("[bold green]Validating...", spinner="dots"):
+                    if otp_code.startswith("http"):
+                        redirect_url = otp_code
+                    else:
+                        otp_response = session.post(
+                            f"{API_BASE_URL}{ENDPOINT_AUTH_OTP_REDIRECT}",
+                            json={
+                                "email": email,
+                                "otp": otp_code,
+                                "redirectUrl": f"{API_BASE_URL}/?login-source=floatingSignup",
+                                "emailLoginMethod": "web-otp",
+                            },
+                        )
+                        otp_response.raise_for_status()
+
+                        redirect_path = otp_response.json().get("redirect", "")
+                        if not redirect_path:
+                            raise ValueError("No redirect URL received.")
+
+                        redirect_url = (
+                            f"{API_BASE_URL}{redirect_path}" if redirect_path.startswith("/") else redirect_path
+                        )
+
+                    # Step 5: Follow redirect to set session cookie
+                    session.get(redirect_url)
+
+                    # Step 6: Extract session cookie
+                    session_token = session.cookies.get(SESSION_COOKIE_NAME)
+
+                    if not session_token:
+                        raise ValueError("Authentication successful, but token not found.")
+
+                console.print("\n[bold green]✅ Token generated successfully![/bold green]")
+                console.print(f"\n[bold white]Your session token:[/bold white]\n[green]{session_token}[/green]\n")
+
+                if Confirm.ask("Copy token to clipboard?", default=False, console=console):
+                    try:
+                        copy(session_token)
+                        console.print("[dim]Token copied to clipboard.[/dim]")
+                    except PyperclipException as error:
+                        console.print(f"[red]Could not copy to clipboard: {error}[/red]")
+
+                _show_exit_message()
+
+        except KeyboardInterrupt:
+            raise typer.Exit(code=0) from None
+        except Exception as error:
+            console.print(f"\n[bold red]⛔ Error:[/bold red] {error}")
+            console.input("[dim]Press ENTER to exit...[/dim]")
+            raise typer.Exit(code=1) from error

{perplexity_webui_scraper-1.0.0 → perplexity_webui_scraper-1.0.2}/src/perplexity_webui_scraper/mcp/server.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-import os
+from os import environ
 
 from fastmcp import FastMCP
 
@@ -30,7 +30,7 @@ def _get_client() -> Perplexity:
     global _client  # noqa: PLW0603
 
     if _client is None:
-        token = os.environ.get("PERPLEXITY_SESSION_TOKEN", "")
+        token = environ.get("PERPLEXITY_SESSION_TOKEN", "")
 
         if not token:
             raise RuntimeError(

{perplexity_webui_scraper-1.0.0 → perplexity_webui_scraper-1.0.2}/src/perplexity_webui_scraper/mcp/tools/__init__.py

@@ -3,12 +3,9 @@
 from __future__ import annotations
 
 from collections.abc import Callable  # noqa: TC003
-from typing import TYPE_CHECKING, Any
-
-
-if TYPE_CHECKING:
-    from perplexity_webui_scraper._internal.types import SearchFocus, SourceFocus, TimeRange
+from typing import Any
 
+from perplexity_webui_scraper._internal.types import SearchFocus, SourceFocus, TimeRange  # noqa: TC001
 from perplexity_webui_scraper.core.client import Perplexity  # noqa: TC001
 from perplexity_webui_scraper.mcp.tools.ask import _ask
 from perplexity_webui_scraper.models.registry import MODELS

{perplexity_webui_scraper-1.0.0 → perplexity_webui_scraper-1.0.2}/src/perplexity_webui_scraper/models/registry.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from importlib.resources import files
 
-import orjson
+from orjson import loads
 
 from perplexity_webui_scraper.models.types import Model
 
@@ -33,7 +33,7 @@ class ModelRegistry:
         models_file = static_pkg.joinpath("models.json")
 
         raw: bytes = models_file.read_bytes()  # type: ignore[arg-type]
-        data: list[dict[str, object]] = orjson.loads(raw)
+        data: list[dict[str, object]] = loads(raw)
 
         for item in data:
             model = Model.model_validate(item)

perplexity_webui_scraper-1.0.0/src/perplexity_webui_scraper/api/cli.py

@@ -1,73 +0,0 @@
-"""Typer CLI for the OpenAI-compatible Perplexity API server."""
-
-from __future__ import annotations
-
-from typing import Annotated
-
-import typer
-
-
-try:
-    import uvicorn as _uvicorn  # noqa: F401
-
-    _HAS_UVICORN = True
-except ImportError:
-    _HAS_UVICORN = False
-
-
-app = typer.Typer(
-    name="perplexity-webui-scraper-api",
-    help="OpenAI-compatible API server powered by Perplexity WebUI Scraper.",
-    add_completion=False,
-)
-
-
-@app.callback(invoke_without_command=True)
-def main(
-    host: Annotated[
-        str,
-        typer.Option("--host", "-H", help="Host address to bind the server to."),
-    ] = "127.0.0.1",
-    port: Annotated[
-        int,
-        typer.Option("--port", "-p", help="Port to listen on."),
-    ] = 8000,
-    reload: Annotated[
-        bool,
-        typer.Option("--reload", help="Enable auto-reload for development."),
-    ] = False,
-    log_level: Annotated[
-        str,
-        typer.Option("--log-level", help="Uvicorn log level."),
-    ] = "info",
-) -> None:
-    """Start the OpenAI-compatible API server.
-
-    Authentication is done per-request via the Authorization: Bearer header.
-    Pass your Perplexity session token as the API key in every request.
-    """
-    if not _HAS_UVICORN:
-        typer.echo(
-            "Error: uvicorn is not installed. Install the 'api' extras:\n\n"
-            "  uv sync --extra api\n"
-            "  pip install perplexity-webui-scraper[api]",
-            err=True,
-        )
-        raise typer.Exit(code=1)
-
-    import uvicorn  # noqa: PLC0415
-
-    typer.echo(
-        f"Starting Perplexity API server at http://{host}:{port}\n"
-        f"  Docs:  http://{host}:{port}/docs\n"
-        f"  ReDoc: http://{host}:{port}/redoc\n"
-        f"  Auth:  Authorization: Bearer <your_session_token>"
-    )
-
-    uvicorn.run(
-        "perplexity_webui_scraper.api.server:app",
-        host=host,
-        port=port,
-        reload=reload,
-        log_level=log_level.lower(),
-    )

perplexity_webui_scraper-1.0.0/src/perplexity_webui_scraper/api/launcher.py

@@ -1,73 +0,0 @@
-"""Typer CLI for launching the OpenAI-compatible Perplexity API server."""
-
-from __future__ import annotations
-
-from typing import Annotated
-
-import typer
-
-
-try:
-    import uvicorn as _uvicorn  # noqa: F401
-
-    _HAS_UVICORN = True
-except ImportError:
-    _HAS_UVICORN = False
-
-
-app = typer.Typer(
-    name="perplexity-webui-scraper-api",
-    help="OpenAI-compatible API server powered by Perplexity WebUI Scraper.",
-    add_completion=False,
-)
-
-
-@app.callback(invoke_without_command=True)
-def main(
-    host: Annotated[
-        str,
-        typer.Option("--host", "-H", help="Host address to bind the server to."),
-    ] = "127.0.0.1",
-    port: Annotated[
-        int,
-        typer.Option("--port", "-p", help="Port to listen on."),
-    ] = 8000,
-    reload: Annotated[
-        bool,
-        typer.Option("--reload", help="Enable auto-reload for development."),
-    ] = False,
-    log_level: Annotated[
-        str,
-        typer.Option("--log-level", help="Uvicorn log level."),
-    ] = "info",
-) -> None:
-    """Start the OpenAI-compatible Perplexity API server.
-
-    Authentication is done per-request via the ``Authorization: Bearer`` header.
-    Pass your Perplexity session token as the API key in every request.
-    """
-    if not _HAS_UVICORN:
-        typer.echo(
-            "Error: uvicorn is not installed. Install the 'api' extras:\n\n"
-            "  uv sync --extra api\n"
-            "  pip install perplexity-webui-scraper[api]",
-            err=True,
-        )
-        raise typer.Exit(code=1)
-
-    import uvicorn  # noqa: PLC0415
-
-    typer.echo(
-        f"Starting Perplexity API server at http://{host}:{port}\n"
-        f"  Docs:  http://{host}:{port}/docs\n"
-        f"  ReDoc: http://{host}:{port}/redoc\n"
-        f"  Auth:  Authorization: Bearer <your_session_token>"
-    )
-
-    uvicorn.run(
-        "perplexity_webui_scraper.api.app:app",
-        host=host,
-        port=port,
-        reload=reload,
-        log_level=log_level.lower(),
-    )

perplexity_webui_scraper-1.0.0/src/perplexity_webui_scraper/cli/commands/get_session_token.py

@@ -1,137 +0,0 @@
-"""get-session-token CLI command — extracts the Perplexity session cookie.
-
-Uses the email → OTP code → redirect-link → cookie extraction flow via
-curl-cffi (no Playwright/browser automation required).
-"""
-
-from __future__ import annotations
-
-from time import sleep
-from typing import Annotated
-
-from curl_cffi.requests import Session
-import typer
-
-from perplexity_webui_scraper._internal.constants import (
-    API_BASE_URL,
-    ENDPOINT_AUTH_CSRF,
-    ENDPOINT_AUTH_OTP_REDIRECT,
-    ENDPOINT_AUTH_SIGNIN,
-    SESSION_COOKIE_NAME,
-)
-
-
-_DEFAULT_HEADERS: dict[str, str] = {
-    "Content-Type": "application/x-www-form-urlencoded",
-    "Referer": f"{API_BASE_URL}/",
-    "Origin": API_BASE_URL,
-}
-
-
-def run(
-    email: Annotated[str | None, typer.Argument(help="Your Perplexity account email.")] = None,
-) -> None:
-    """Extract your Perplexity session token using email OTP authentication.
-
-    If email is not provided as an argument, you will be prompted interactively.
-    The session token is printed to stdout so it can be piped or exported::
-
-        export PERPLEXITY_SESSION_TOKEN=$(get-perplexity-session-token you@example.com)
-    """
-    if email is None:
-        email = typer.prompt("Enter your Perplexity account email")
-
-    email = email.strip()
-
-    if not email or "@" not in email:
-        typer.echo("Error: invalid email address.", err=True)
-        raise typer.Exit(code=1)
-
-    typer.echo(f"→ Sending OTP to {email} …", err=True)
-
-    with Session(impersonate="chrome", headers=_DEFAULT_HEADERS) as session:
-        # Step 1: Obtain CSRF token
-        try:
-            csrf_response = session.get(f"{API_BASE_URL}{ENDPOINT_AUTH_CSRF}")
-            csrf_response.raise_for_status()
-            csrf_token: str = csrf_response.json().get("csrfToken", "")
-        except Exception as exc:
-            typer.echo(f"Error: failed to fetch CSRF token: {exc}", err=True)
-            raise typer.Exit(code=1) from exc
-
-        if not csrf_token:
-            typer.echo("Error: could not obtain CSRF token.", err=True)
-            raise typer.Exit(code=1)
-
-        # Step 2: Send OTP email
-        try:
-            signin_response = session.post(
-                f"{API_BASE_URL}{ENDPOINT_AUTH_SIGNIN}",
-                data={
-                    "email": email,
-                    "csrfToken": csrf_token,
-                    "callbackUrl": f"{API_BASE_URL}/",
-                    "json": "true",
-                },
-            )
-            signin_response.raise_for_status()
-        except Exception as exc:
-            typer.echo(f"Error: failed to initiate sign-in: {exc}", err=True)
-            raise typer.Exit(code=1) from exc
-
-        typer.echo("→ OTP email sent. Check your inbox.", err=True)
-
-        # Step 3: Prompt user for OTP code
-        otp_code: str = typer.prompt("Enter the 6-digit OTP code from your email").strip()
-
-        if not otp_code:
-            typer.echo("Error: OTP code cannot be empty.", err=True)
-            raise typer.Exit(code=1)
-
-        # Step 4: Convert OTP to redirect URL
-        typer.echo("→ Verifying OTP …", err=True)
-
-        try:
-            otp_response = session.get(
-                f"{API_BASE_URL}{ENDPOINT_AUTH_OTP_REDIRECT}",
-                params={"email": email, "token": otp_code},
-            )
-            otp_response.raise_for_status()
-            redirect_url: str = otp_response.json().get("url", "")
-        except Exception as exc:
-            typer.echo(f"Error: OTP verification failed: {exc}", err=True)
-            raise typer.Exit(code=1) from exc
-
-        if not redirect_url:
-            typer.echo("Error: OTP verification returned no redirect URL.", err=True)
-            raise typer.Exit(code=1)
-
-        # Step 5: Follow redirect to set session cookie
-        typer.echo("→ Completing authentication …", err=True)
-
-        try:
-            sleep(1)  # brief pause to let the session cookie propagate
-            session.get(redirect_url, allow_redirects=True)
-        except Exception as exc:
-            typer.echo(f"Warning: redirect failed, but cookie may still be set: {exc}", err=True)
-
-        # Step 6: Extract session cookie
-        session_token: str | None = session.cookies.get(SESSION_COOKIE_NAME)
-
-        if not session_token:
-            typer.echo(
-                f"Error: session cookie '{SESSION_COOKIE_NAME}' not found. "
-                "The OTP may have expired or been entered incorrectly.",
-                err=True,
-            )
-            raise typer.Exit(code=1)
-
-    # Output only the token to stdout for shell capture
-    typer.echo(session_token)
-
-    typer.echo(
-        "\n✓ Session token extracted successfully.\n"
-        "  Store it as an environment variable:\n\n"
-        f"    export PERPLEXITY_SESSION_TOKEN={session_token!r}",
-        err=True,
-    )

perplexity_webui_scraper-1.0.0/src/perplexity_webui_scraper/cli/get_perplexity_session_token.py

@@ -1,209 +0,0 @@
-"""CLI utility for secure Perplexity authentication and session extraction."""
-
-from __future__ import annotations
-
-from sys import exit
-from typing import NoReturn
-
-from curl_cffi import Session
-from orjson import loads
-from pyperclip import PyperclipException, copy
-from rich.console import Console
-from rich.panel import Panel
-from rich.prompt import Confirm, Prompt
-
-
-BASE_URL: str = "https://www.perplexity.ai"
-
-console = Console(stderr=True, soft_wrap=True)
-
-
-def _initialize_session() -> tuple[Session, str]:
-    """Initialize session and obtain CSRF token.
-
-    Returns:
-        A tuple of the initialized session and the CSRF token string.
-
-    Raises:
-        ValueError: If the CSRF token cannot be obtained from the API.
-    """
-    session = Session(impersonate="chrome", headers={"Referer": BASE_URL, "Origin": BASE_URL})
-
-    with console.status("[bold green]Initializing secure connection...", spinner="dots"):
-        session.get(BASE_URL)
-        csrf_data = loads(session.get(f"{BASE_URL}/api/auth/csrf").content)
-        csrf = csrf_data.get("csrfToken")
-
-        if not csrf:
-            raise ValueError("Failed to obtain CSRF token.")
-
-    return session, csrf
-
-
-def _request_verification_code(session: Session, csrf: str, email: str) -> None:
-    """Send a verification code to the user's email address.
-
-    Args:
-        session: The active curl-cffi session.
-        csrf: The CSRF token for the request.
-        email: The user's Perplexity account email address.
-
-    Raises:
-        ValueError: If the authentication request returns a non-200 status.
-    """
-    with console.status("[bold green]Sending verification code...", spinner="dots"):
-        response = session.post(
-            f"{BASE_URL}/api/auth/signin/email?version=2.18&source=default",
-            json={
-                "email": email,
-                "csrfToken": csrf,
-                "useNumericOtp": "true",
-                "json": "true",
-                "callbackUrl": f"{BASE_URL}/?login-source=floatingSignup",
-            },
-        )
-
-        if response.status_code != 200:
-            raise ValueError(f"Authentication request failed: {response.text}")
-
-
-def _validate_and_get_redirect_url(session: Session, email: str, user_input: str) -> str:
-    """Validate the OTP or magic link and return the authentication redirect URL.
-
-    Args:
-        session: The active curl-cffi session.
-        email: The user's Perplexity account email address.
-        user_input: Either a 6-digit OTP code or a magic link URL.
-
-    Returns:
-        The full redirect URL to complete authentication.
-
-    Raises:
-        ValueError: If the code is invalid or no redirect URL is returned.
-    """
-    with console.status("[bold green]Validating...", spinner="dots"):
-        if user_input.startswith("http"):
-            return user_input
-
-        response_otp = session.post(
-            f"{BASE_URL}/api/auth/otp-redirect-link",
-            json={
-                "email": email,
-                "otp": user_input,
-                "redirectUrl": f"{BASE_URL}/?login-source=floatingSignup",
-                "emailLoginMethod": "web-otp",
-            },
-        )
-
-        if response_otp.status_code != 200:
-            raise ValueError("Invalid verification code.")
-
-        redirect_path = loads(response_otp.content).get("redirect")
-
-        if not redirect_path:
-            raise ValueError("No redirect URL received.")
-
-        return f"{BASE_URL}{redirect_path}" if redirect_path.startswith("/") else redirect_path
-
-
-def _extract_session_token(session: Session, redirect_url: str) -> str:
-    """Extract the session token from cookies after completing authentication.
-
-    Args:
-        session: The active curl-cffi session.
-        redirect_url: The full redirect URL returned after OTP/link validation.
-
-    Returns:
-        The raw ``__Secure-next-auth.session-token`` cookie value.
-
-    Raises:
-        ValueError: If the token cookie is not found after the redirect.
-    """
-    session.get(redirect_url)
-    token = session.cookies.get("__Secure-next-auth.session-token")
-
-    if not token:
-        raise ValueError("Authentication successful, but token not found.")
-
-    return token
-
-
-def _display_and_copy_token(token: str) -> None:
-    """Display the token and optionally copy it to the system clipboard.
-
-    Prompts the user with a yes/no question (default: yes). If confirmed,
-    copies the token to the clipboard using ``pyperclip``.
-
-    Args:
-        token: The raw session token string to display and copy.
-    """
-    console.print("\n[bold green]✅ Token generated successfully![/bold green]")
-    console.print(f"\n[bold white]Your session token:[/bold white]\n[green]{token}[/green]\n")
-
-    if Confirm.ask("Copy token to clipboard?", default=True, console=console):
-        try:
-            copy(token)
-            console.print("[dim]Token copied to clipboard.[/dim]")
-        except PyperclipException as error:
-            console.print(f"[red]Could not copy to clipboard: {error}[/red]")
-
-
-def _show_header() -> None:
-    """Display the welcome header panel."""
-    console.print(
-        Panel(
-            "[bold white]Perplexity WebUI Scraper[/bold white]\n\n"
-            "Automatic session token generator via email authentication.\n"
-            "[dim]All session data will be cleared on exit.[/dim]",
-            title="🔐 Token Generator",
-            border_style="cyan",
-        )
-    )
-
-
-def _show_exit_message() -> None:
-    """Display the security note and wait for the user to press ENTER before clearing the screen."""
-    console.print("\n[bold yellow]⚠️ Security Note:[/bold yellow]")
-    console.print("Press [bold white]ENTER[/bold white] to clear screen and exit.")
-    console.input()
-
-
-def get_token() -> NoReturn:
-    """Run the full authentication flow inside an ephemeral terminal screen.
-
-    Guides the user through email-based sign-in (OTP or magic link),
-    displays the extracted session token, and offers to copy it to the
-    clipboard. The screen is cleared on exit for security.
-    """
-    with console.screen():
-        try:
-            _show_header()
-
-            session, csrf = _initialize_session()
-
-            console.print("\n[bold cyan]Step 1: Email Verification[/bold cyan]")
-            email = Prompt.ask("  Enter your Perplexity email", console=console)
-            _request_verification_code(session, csrf, email)
-
-            console.print("\n[bold cyan]Step 2: Verification[/bold cyan]")
-            console.print("  Check your email for a [bold]6-digit code[/bold] or [bold]magic link[/bold].")
-            user_input = Prompt.ask("  Enter code or paste link", console=console).strip()
-            redirect_url = _validate_and_get_redirect_url(session, email, user_input)
-
-            token = _extract_session_token(session, redirect_url)
-
-            _display_and_copy_token(token)
-
-            _show_exit_message()
-
-            exit(0)
-        except KeyboardInterrupt:
-            exit(0)
-        except Exception as error:
-            console.print(f"\n[bold red]⛔ Error:[/bold red] {error}")
-            console.input("[dim]Press ENTER to exit...[/dim]")
-            exit(1)
-
-
-if __name__ == "__main__":
-    get_token()