klickanalytics-cli 0.1.0__tar.gz

klickanalytics_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KlickAnalytics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

klickanalytics_cli-0.1.0/PKG-INFO

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: klickanalytics-cli
+Version: 0.1.0
+Summary: Official CLI for KlickAnalytics APIs
+Author-email: KlickAnalytics <support@klickanalytics.com>
+License: MIT
+Project-URL: Homepage, https://www.klickanalytics.com
+Project-URL: Documentation, https://www.klickanalytics.com/cli_documentation.php
+Keywords: finance,stocks,cli,market-data,klickanalytics,agents,api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# KlickAnalytics CLI
+
+**Financial market intelligence from your terminal, scripts, and AI agents.**
+
+KlickAnalytics CLI provides a simple way for developers, traders, researchers, and AI systems to access financial market data directly from the command line.
+
+Instead of writing API requests manually, you can retrieve structured financial data instantly.
+
+Example:
+
+```bash
+ka profile -s TSLA
+ka quote -s NVDA
+ka prices -s AAPL -sd 2025-01-01 -ed 2025-12-31
+ka quantstats -s MSFT
+```
+
+---
+
+# Why KlickAnalytics CLI?
+
+Most financial API workflows involve unnecessary friction:
+
+- writing HTTP request code
+- building authentication headers
+- managing JSON parsing
+- creating repetitive scripts
+- integrating APIs with agents or automation pipelines
+
+KlickAnalytics CLI removes that friction by acting as a thin client that connects directly to the KlickAnalytics API platform.
+
+Benefits:
+
+- extremely simple command interface
+- direct integration with your terminal
+- easy automation via scripts
+- agent-friendly JSON output
+- server-driven command routing
+- future commands added without updating the CLI
+
+---
+
+# Built for Developers and AI Agents
+
+KlickAnalytics CLI is designed to integrate easily with modern development and automation workflows.
+
+It works well with:
+
+- local shell scripts
+- Python pipelines
+- research tools
+- cron jobs
+- AI agents
+- OpenClaw-style systems
+- MCP servers
+- local developer tools
+- automation pipelines
+
+Because the CLI supports structured JSON output, agents can consume financial data without writing API wrappers.
+
+Example:
+
+```bash
+ka --json quote -s MSFT
+```
+
+This allows AI tools or scripts to receive structured responses instantly.
+
+---
+
+# Installation
+
+Install from PyPI:
+
+```bash
+pip install klickanalytics-cli
+```
+
+After installation, the `ka` command becomes available globally.
+
+---
+
+# Setting Your API Key
+
+Create your account and generate your CLI API key in seconds.
+
+## Steps
+
+1. **Register a free account**
+
+   👉 https://klickanalytics.com/signup
+
+2. **Generate your API key**
+
+   👉 https://klickanalytics.com/user_apis
+
+3. **Export your API key**
+
+```bash
+export KLICKANALYTICS_CLI_API_KEY="your_api_key_here"
+```
+
+A fallback environment variable is also supported:
+
+```bash
+export KA_API_KEY="your_api_key_here"
+```
+
+---
+
+# Basic Usage
+
+Display help:
+
+```bash
+ka help
+```
+
+List commands:
+
+```bash
+ka commands
+```
+
+Retrieve symbol profile:
+
+```bash
+ka profile -s TSLA
+```
+
+Get latest quote:
+
+```bash
+ka quote -s TSLA
+```
+
+Retrieve historical prices:
+
+```bash
+ka prices -s TSLA -sd 2025-01-01 -ed 2025-12-31
+```
+
+---
+
+# JSON Output
+
+For scripts, automation, and AI workflows, you can request JSON output:
+
+```bash
+ka --json profile -s NVDA
+```
+
+Example output:
+
+```json
+{
+  "symbol": "NVDA",
+  "name": "NVIDIA Corporation",
+  "sector": "Technology"
+}
+```
+
+---
+
+# Local Development
+
+To connect the CLI to a local or staging API server:
+
+```bash
+export KA_DEV_ENDPOINT="http://127.0.0.1:8000/cli"
+```
+
+This allows you to test new commands or endpoints locally.
+
+---
+
+# Protocol Version
+
+Optional protocol version override:
+
+```bash
+export KA_PROTO=v1
+```
+
+Or specify at runtime:
+
+```bash
+ka --version v2 profile -s TSLA
+```
+
+---
+
+# Example Workflows
+
+## Shell Automation
+
+```bash
+for s in AAPL MSFT NVDA TSLA
+do
+  ka quote -s $s
+done
+```
+
+---
+
+## Data Pipeline
+
+```bash
+ka --json prices -s NVDA > prices.json
+```
+
+---
+
+## AI Agent Workflow
+
+```bash
+ka --json volatility -s NVDA -sd 2025-01-01 -ed 2025-12-31
+```
+
+The structured output can be consumed directly by:
+
+- AI agents
+- Python scripts
+- automation workers
+- research pipelines
+
+---
+
+# Environment Variables
+
+| Variable | Description |
+|---------|-------------|
+| KLICKANALYTICS_CLI_API_KEY | API key for CLI authentication |
+| KA_API_KEY | fallback API key |
+| KA_DEV_ENDPOINT | optional local/staging API endpoint |
+| KA_PROTO | protocol version override |
+
+---
+
+# Design Philosophy
+
+The CLI intentionally stays lightweight.
+
+The client does **not hardcode commands locally**. Instead:
+
+- commands are forwarded to the server
+- the server validates and routes them
+- authentication is handled server-side
+- new commands can be added without updating the CLI
+
+This architecture keeps the CLI simple and future-proof.
+
+---
+
+# Development Install
+
+Clone the repository:
+
+```bash
+git clone https://github.com/klickanalytics/klickanalytics-cli.git
+cd klickanalytics-cli
+```
+
+Install locally:
+
+```bash
+pip install -e .
+```
+
+---
+
+# Documentation
+
+Full CLI documentation:
+
+https://www.klickanalytics.com/cli_documentation
+
+---
+
+# License
+
+MIT License

klickanalytics_cli-0.1.0/README.md

@@ -0,0 +1,282 @@
+# KlickAnalytics CLI
+
+**Financial market intelligence from your terminal, scripts, and AI agents.**
+
+KlickAnalytics CLI provides a simple way for developers, traders, researchers, and AI systems to access financial market data directly from the command line.
+
+Instead of writing API requests manually, you can retrieve structured financial data instantly.
+
+Example:
+
+```bash
+ka profile -s TSLA
+ka quote -s NVDA
+ka prices -s AAPL -sd 2025-01-01 -ed 2025-12-31
+ka quantstats -s MSFT
+```
+
+---
+
+# Why KlickAnalytics CLI?
+
+Most financial API workflows involve unnecessary friction:
+
+- writing HTTP request code
+- building authentication headers
+- managing JSON parsing
+- creating repetitive scripts
+- integrating APIs with agents or automation pipelines
+
+KlickAnalytics CLI removes that friction by acting as a thin client that connects directly to the KlickAnalytics API platform.
+
+Benefits:
+
+- extremely simple command interface
+- direct integration with your terminal
+- easy automation via scripts
+- agent-friendly JSON output
+- server-driven command routing
+- future commands added without updating the CLI
+
+---
+
+# Built for Developers and AI Agents
+
+KlickAnalytics CLI is designed to integrate easily with modern development and automation workflows.
+
+It works well with:
+
+- local shell scripts
+- Python pipelines
+- research tools
+- cron jobs
+- AI agents
+- OpenClaw-style systems
+- MCP servers
+- local developer tools
+- automation pipelines
+
+Because the CLI supports structured JSON output, agents can consume financial data without writing API wrappers.
+
+Example:
+
+```bash
+ka --json quote -s MSFT
+```
+
+This allows AI tools or scripts to receive structured responses instantly.
+
+---
+
+# Installation
+
+Install from PyPI:
+
+```bash
+pip install klickanalytics-cli
+```
+
+After installation, the `ka` command becomes available globally.
+
+---
+
+# Setting Your API Key
+
+Create your account and generate your CLI API key in seconds.
+
+## Steps
+
+1. **Register a free account**
+
+   👉 https://klickanalytics.com/signup
+
+2. **Generate your API key**
+
+   👉 https://klickanalytics.com/user_apis
+
+3. **Export your API key**
+
+```bash
+export KLICKANALYTICS_CLI_API_KEY="your_api_key_here"
+```
+
+A fallback environment variable is also supported:
+
+```bash
+export KA_API_KEY="your_api_key_here"
+```
+
+---
+
+# Basic Usage
+
+Display help:
+
+```bash
+ka help
+```
+
+List commands:
+
+```bash
+ka commands
+```
+
+Retrieve symbol profile:
+
+```bash
+ka profile -s TSLA
+```
+
+Get latest quote:
+
+```bash
+ka quote -s TSLA
+```
+
+Retrieve historical prices:
+
+```bash
+ka prices -s TSLA -sd 2025-01-01 -ed 2025-12-31
+```
+
+---
+
+# JSON Output
+
+For scripts, automation, and AI workflows, you can request JSON output:
+
+```bash
+ka --json profile -s NVDA
+```
+
+Example output:
+
+```json
+{
+  "symbol": "NVDA",
+  "name": "NVIDIA Corporation",
+  "sector": "Technology"
+}
+```
+
+---
+
+# Local Development
+
+To connect the CLI to a local or staging API server:
+
+```bash
+export KA_DEV_ENDPOINT="http://127.0.0.1:8000/cli"
+```
+
+This allows you to test new commands or endpoints locally.
+
+---
+
+# Protocol Version
+
+Optional protocol version override:
+
+```bash
+export KA_PROTO=v1
+```
+
+Or specify at runtime:
+
+```bash
+ka --version v2 profile -s TSLA
+```
+
+---
+
+# Example Workflows
+
+## Shell Automation
+
+```bash
+for s in AAPL MSFT NVDA TSLA
+do
+  ka quote -s $s
+done
+```
+
+---
+
+## Data Pipeline
+
+```bash
+ka --json prices -s NVDA > prices.json
+```
+
+---
+
+## AI Agent Workflow
+
+```bash
+ka --json volatility -s NVDA -sd 2025-01-01 -ed 2025-12-31
+```
+
+The structured output can be consumed directly by:
+
+- AI agents
+- Python scripts
+- automation workers
+- research pipelines
+
+---
+
+# Environment Variables
+
+| Variable | Description |
+|---------|-------------|
+| KLICKANALYTICS_CLI_API_KEY | API key for CLI authentication |
+| KA_API_KEY | fallback API key |
+| KA_DEV_ENDPOINT | optional local/staging API endpoint |
+| KA_PROTO | protocol version override |
+
+---
+
+# Design Philosophy
+
+The CLI intentionally stays lightweight.
+
+The client does **not hardcode commands locally**. Instead:
+
+- commands are forwarded to the server
+- the server validates and routes them
+- authentication is handled server-side
+- new commands can be added without updating the CLI
+
+This architecture keeps the CLI simple and future-proof.
+
+---
+
+# Development Install
+
+Clone the repository:
+
+```bash
+git clone https://github.com/klickanalytics/klickanalytics-cli.git
+cd klickanalytics-cli
+```
+
+Install locally:
+
+```bash
+pip install -e .
+```
+
+---
+
+# Documentation
+
+Full CLI documentation:
+
+https://www.klickanalytics.com/cli_documentation
+
+---
+
+# License
+
+MIT License

klickanalytics_cli-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "klickanalytics-cli"
+version = "0.1.0"
+description = "Official CLI for KlickAnalytics APIs"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "KlickAnalytics", email = "support@klickanalytics.com" }
+]
+keywords = ["finance", "stocks", "cli", "market-data", "klickanalytics", "agents", "api"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Office/Business :: Financial",
+  "Topic :: Software Development :: Libraries :: Python Modules"
+]
+dependencies = [
+  "requests>=2.31.0"
+]
+
+[project.urls]
+Homepage = "https://www.klickanalytics.com"
+Documentation = "https://www.klickanalytics.com/cli_documentation.php"
+
+[project.scripts]
+ka = "klickanalytics_cli.ka_cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

klickanalytics_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

klickanalytics_cli-0.1.0/src/klickanalytics_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

klickanalytics_cli-0.1.0/src/klickanalytics_cli/ka_cli.py

@@ -0,0 +1,208 @@
+#!/usr/bin/env python3
+"""
+KlickAnalytics CLI
+
+Examples:
+  ka help
+  ka commands
+  ka profile -s TSLA
+  ka quote -s TSLA
+  ka prices -s TSLA -sd 2025-01-01 -ed 2025-12-31
+
+Environment:
+  KLICKANALYTICS_CLI_API_KEY   API key for CLI access
+  KA_DEV_ENDPOINT              Optional override endpoint for local/dev
+  KA_PROTO                     Optional protocol version override (v1 or v2)
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from typing import Optional, Dict, Any, List, Tuple
+
+import requests
+
+DEFAULT_ENDPOINT = "https://api.klickanalytics.com/cli"
+CLI_VERSION = "0.1.0"
+
+
+def endpoint() -> str:
+    val = (os.environ.get("KA_DEV_ENDPOINT") or DEFAULT_ENDPOINT).strip()
+    return val.rstrip("/")
+
+
+def detect_proto_default() -> str:
+    proto = (os.environ.get("KA_PROTO") or "v1").strip().lower()
+    if proto in ("v1", "1"):
+        return "v1"
+    if proto in ("v2", "2"):
+        return "v2"
+    return "v1"
+
+
+def get_api_key() -> str:
+    return (
+        os.environ.get("KLICKANALYTICS_CLI_API_KEY")
+        or os.environ.get("KA_API_KEY")
+        or ""
+    ).strip()
+
+
+def read_stdin_if_piped() -> Optional[str]:
+    if sys.stdin is None or sys.stdin.isatty():
+        return None
+    try:
+        return sys.stdin.read()
+    except Exception:
+        return None
+
+
+def strip_local_flags(argv: List[str]) -> Tuple[List[str], bool, Optional[str]]:
+    """
+    Client-side flags handled locally:
+      --json
+      --version <v1|v2>
+
+    Everything else is forwarded to server unchanged.
+    """
+    want_json = False
+    proto = None
+    out: List[str] = []
+
+    i = 0
+    while i < len(argv):
+        a = argv[i]
+
+        if a == "--json":
+            want_json = True
+            i += 1
+            continue
+
+        if a == "--version":
+            if i + 1 >= len(argv):
+                sys.stderr.write("Error: --version requires a value (v1 or v2)\n")
+                sys.exit(2)
+
+            proto = argv[i + 1].strip().lower()
+            if proto == "1":
+                proto = "v1"
+            elif proto == "2":
+                proto = "v2"
+            elif proto not in ("v1", "v2"):
+                sys.stderr.write("Error: --version must be v1 or v2\n")
+                sys.exit(2)
+
+            i += 2
+            continue
+
+        out.append(a)
+        i += 1
+
+    return out, want_json, proto
+
+
+def call_server(
+    argv_forward: List[str],
+    stdin: Optional[str],
+    want_json: bool,
+    proto: Optional[str],
+) -> Dict[str, Any]:
+    api_key = get_api_key()
+
+    headers = {
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+        "User-Agent": f"klickanalytics-cli/{CLI_VERSION}",
+    }
+
+    if api_key:
+        headers["KLICKANALYTICS-CLI-API-KEY"] = api_key
+
+    if not argv_forward:
+        argv_forward = ["help"]
+
+    payload = {
+        "argv": argv_forward,
+        "raw": " ".join(argv_forward),
+        "stdin": stdin,
+        "proto": proto or detect_proto_default(),
+        "want": "json" if want_json else "text",
+        "client": {
+            "cli": "klickanalytics-cli",
+            "cli_version": CLI_VERSION,
+            "platform": sys.platform,
+            "python": sys.version.split()[0],
+        },
+    }
+
+    r = requests.post(endpoint(), json=payload, headers=headers, timeout=60)
+    r.raise_for_status()
+    return r.json()
+
+
+def print_response(resp: Dict[str, Any], want_json: bool) -> None:
+    if resp.get("stderr"):
+        sys.stderr.write(str(resp["stderr"]))
+
+    exit_code = int(resp.get("exit_code", 0))
+
+    if want_json:
+        if resp.get("data") is not None:
+            sys.stdout.write(json.dumps(resp["data"], indent=2) + "\n")
+        else:
+            sys.stdout.write(json.dumps(resp, indent=2) + "\n")
+        sys.exit(exit_code)
+
+    if resp.get("stdout"):
+        sys.stdout.write(str(resp["stdout"]))
+    elif resp.get("data") is not None:
+        sys.stdout.write(json.dumps(resp["data"], indent=2) + "\n")
+    else:
+        sys.stdout.write(json.dumps(resp, indent=2) + "\n")
+
+    sys.exit(exit_code)
+
+
+def main() -> None:
+    argv_forward, want_json, proto = strip_local_flags(sys.argv[1:])
+    stdin_data = read_stdin_if_piped()
+
+    try:
+        resp = call_server(
+            argv_forward=argv_forward,
+            stdin=stdin_data,
+            want_json=want_json,
+            proto=proto,
+        )
+    except requests.exceptions.ConnectionError:
+        sys.stderr.write(
+            "ConnectionError: cannot reach KlickAnalytics endpoint.\n"
+            f"Endpoint: {endpoint()}\n\n"
+        )
+        sys.exit(1)
+    except requests.exceptions.Timeout:
+        sys.stderr.write("Timeout: server took too long to respond.\n")
+        sys.exit(1)
+    except requests.HTTPError as e:
+        body = ""
+        try:
+            body = e.response.text if e.response is not None else ""
+        except Exception:
+            pass
+
+        sys.stderr.write(f"HTTPError: {e}\n")
+        if body:
+            sys.stderr.write(body + "\n")
+        sys.stderr.write(f"Endpoint: {endpoint()}\n")
+        sys.exit(1)
+    except Exception as e:
+        sys.stderr.write(f"Unexpected error: {e}\n")
+        sys.exit(1)
+
+    print_response(resp, want_json)
+
+
+if __name__ == "__main__":
+    main()

klickanalytics_cli-0.1.0/src/klickanalytics_cli.egg-info/PKG-INFO

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: klickanalytics-cli
+Version: 0.1.0
+Summary: Official CLI for KlickAnalytics APIs
+Author-email: KlickAnalytics <support@klickanalytics.com>
+License: MIT
+Project-URL: Homepage, https://www.klickanalytics.com
+Project-URL: Documentation, https://www.klickanalytics.com/cli_documentation.php
+Keywords: finance,stocks,cli,market-data,klickanalytics,agents,api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# KlickAnalytics CLI
+
+**Financial market intelligence from your terminal, scripts, and AI agents.**
+
+KlickAnalytics CLI provides a simple way for developers, traders, researchers, and AI systems to access financial market data directly from the command line.
+
+Instead of writing API requests manually, you can retrieve structured financial data instantly.
+
+Example:
+
+```bash
+ka profile -s TSLA
+ka quote -s NVDA
+ka prices -s AAPL -sd 2025-01-01 -ed 2025-12-31
+ka quantstats -s MSFT
+```
+
+---
+
+# Why KlickAnalytics CLI?
+
+Most financial API workflows involve unnecessary friction:
+
+- writing HTTP request code
+- building authentication headers
+- managing JSON parsing
+- creating repetitive scripts
+- integrating APIs with agents or automation pipelines
+
+KlickAnalytics CLI removes that friction by acting as a thin client that connects directly to the KlickAnalytics API platform.
+
+Benefits:
+
+- extremely simple command interface
+- direct integration with your terminal
+- easy automation via scripts
+- agent-friendly JSON output
+- server-driven command routing
+- future commands added without updating the CLI
+
+---
+
+# Built for Developers and AI Agents
+
+KlickAnalytics CLI is designed to integrate easily with modern development and automation workflows.
+
+It works well with:
+
+- local shell scripts
+- Python pipelines
+- research tools
+- cron jobs
+- AI agents
+- OpenClaw-style systems
+- MCP servers
+- local developer tools
+- automation pipelines
+
+Because the CLI supports structured JSON output, agents can consume financial data without writing API wrappers.
+
+Example:
+
+```bash
+ka --json quote -s MSFT
+```
+
+This allows AI tools or scripts to receive structured responses instantly.
+
+---
+
+# Installation
+
+Install from PyPI:
+
+```bash
+pip install klickanalytics-cli
+```
+
+After installation, the `ka` command becomes available globally.
+
+---
+
+# Setting Your API Key
+
+Create your account and generate your CLI API key in seconds.
+
+## Steps
+
+1. **Register a free account**
+
+   👉 https://klickanalytics.com/signup
+
+2. **Generate your API key**
+
+   👉 https://klickanalytics.com/user_apis
+
+3. **Export your API key**
+
+```bash
+export KLICKANALYTICS_CLI_API_KEY="your_api_key_here"
+```
+
+A fallback environment variable is also supported:
+
+```bash
+export KA_API_KEY="your_api_key_here"
+```
+
+---
+
+# Basic Usage
+
+Display help:
+
+```bash
+ka help
+```
+
+List commands:
+
+```bash
+ka commands
+```
+
+Retrieve symbol profile:
+
+```bash
+ka profile -s TSLA
+```
+
+Get latest quote:
+
+```bash
+ka quote -s TSLA
+```
+
+Retrieve historical prices:
+
+```bash
+ka prices -s TSLA -sd 2025-01-01 -ed 2025-12-31
+```
+
+---
+
+# JSON Output
+
+For scripts, automation, and AI workflows, you can request JSON output:
+
+```bash
+ka --json profile -s NVDA
+```
+
+Example output:
+
+```json
+{
+  "symbol": "NVDA",
+  "name": "NVIDIA Corporation",
+  "sector": "Technology"
+}
+```
+
+---
+
+# Local Development
+
+To connect the CLI to a local or staging API server:
+
+```bash
+export KA_DEV_ENDPOINT="http://127.0.0.1:8000/cli"
+```
+
+This allows you to test new commands or endpoints locally.
+
+---
+
+# Protocol Version
+
+Optional protocol version override:
+
+```bash
+export KA_PROTO=v1
+```
+
+Or specify at runtime:
+
+```bash
+ka --version v2 profile -s TSLA
+```
+
+---
+
+# Example Workflows
+
+## Shell Automation
+
+```bash
+for s in AAPL MSFT NVDA TSLA
+do
+  ka quote -s $s
+done
+```
+
+---
+
+## Data Pipeline
+
+```bash
+ka --json prices -s NVDA > prices.json
+```
+
+---
+
+## AI Agent Workflow
+
+```bash
+ka --json volatility -s NVDA -sd 2025-01-01 -ed 2025-12-31
+```
+
+The structured output can be consumed directly by:
+
+- AI agents
+- Python scripts
+- automation workers
+- research pipelines
+
+---
+
+# Environment Variables
+
+| Variable | Description |
+|---------|-------------|
+| KLICKANALYTICS_CLI_API_KEY | API key for CLI authentication |
+| KA_API_KEY | fallback API key |
+| KA_DEV_ENDPOINT | optional local/staging API endpoint |
+| KA_PROTO | protocol version override |
+
+---
+
+# Design Philosophy
+
+The CLI intentionally stays lightweight.
+
+The client does **not hardcode commands locally**. Instead:
+
+- commands are forwarded to the server
+- the server validates and routes them
+- authentication is handled server-side
+- new commands can be added without updating the CLI
+
+This architecture keeps the CLI simple and future-proof.
+
+---
+
+# Development Install
+
+Clone the repository:
+
+```bash
+git clone https://github.com/klickanalytics/klickanalytics-cli.git
+cd klickanalytics-cli
+```
+
+Install locally:
+
+```bash
+pip install -e .
+```
+
+---
+
+# Documentation
+
+Full CLI documentation:
+
+https://www.klickanalytics.com/cli_documentation
+
+---
+
+# License
+
+MIT License

klickanalytics_cli-0.1.0/src/klickanalytics_cli.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/klickanalytics_cli/__init__.py
+src/klickanalytics_cli/ka_cli.py
+src/klickanalytics_cli.egg-info/PKG-INFO
+src/klickanalytics_cli.egg-info/SOURCES.txt
+src/klickanalytics_cli.egg-info/dependency_links.txt
+src/klickanalytics_cli.egg-info/entry_points.txt
+src/klickanalytics_cli.egg-info/requires.txt
+src/klickanalytics_cli.egg-info/top_level.txt
+tests/test_imports.py

klickanalytics_cli-0.1.0/src/klickanalytics_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

klickanalytics_cli-0.1.0/src/klickanalytics_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ka = klickanalytics_cli.ka_cli:main

klickanalytics_cli-0.1.0/src/klickanalytics_cli.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.31.0

klickanalytics_cli-0.1.0/src/klickanalytics_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+klickanalytics_cli

klickanalytics_cli-0.1.0/tests/test_imports.py

@@ -0,0 +1,3 @@
+def test_import():
+    import klickanalytics_cli
+    assert klickanalytics_cli is not None