osintkit 0.1.0

package/osintkit/setup.py

@@ -0,0 +1,157 @@
+"""First-time setup wizard for osintkit."""
+
+from pathlib import Path
+from rich.console import Console
+from rich.prompt import Prompt, Confirm
+from rich.panel import Panel
+from rich.table import Table
+import yaml
+
+console = Console()
+
+# Free API keys with their limits
+FREE_API_KEYS = {
+    "hibp": {
+        "name": "Have I Been Pwned",
+        "description": "Breach database lookups",
+        "limits": "10 requests/minute (free tier)",
+        "url": "https://haveibeenpwned.com/API/Key",
+        "required": False,
+    },
+    "numverify": {
+        "name": "NumVerify",
+        "description": "Phone number validation",
+        "limits": "100 requests/month (free tier)",
+        "url": "https://numverify.com/",
+        "required": False,
+    },
+    "intelbase": {
+        "name": "Intelbase",
+        "description": "Dark web & paste search",
+        "limits": "100 requests/month (free tier)",
+        "url": "https://intelbase.is",
+        "required": False,
+    },
+    "breachdirectory": {
+        "name": "BreachDirectory (RapidAPI)",
+        "description": "Breach lookups",
+        "limits": "50 requests/day (RapidAPI free tier)",
+        "url": "https://rapidapi.com/rohan-patel/api/breachdirectory",
+        "required": False,
+    },
+    "google_cse": {
+        "name": "Google Custom Search",
+        "description": "Data broker detection",
+        "limits": "100 requests/day (free tier)",
+        "url": "https://developers.google.com/custom-search/v1/introduction",
+        "required": False,
+        "needs_two_keys": True,  # key + cx
+    },
+}
+
+
+def is_first_run() -> bool:
+    """Check if this is the first run."""
+    config_path = Path.home() / ".osintkit" / "config.yaml"
+    return not config_path.exists()
+
+
+def run_setup_wizard():
+    """Run the first-time setup wizard."""
+    console.print(Panel.fit(
+        "[bold cyan]Welcome to osintkit![/bold cyan]\n\n"
+        "OSINT tool for personal digital footprint analysis.\n"
+        "Let's set up your API keys (all optional, free tiers available).",
+        title="🚀 First-Time Setup",
+    ))
+    
+    console.print("\n[yellow]API keys unlock more search capabilities.[/yellow]")
+    console.print("[dim]You can skip any key and add them later with 'osintkit setup'[/dim]\n")
+    
+    # Show available APIs
+    table = Table(title="Available Free APIs")
+    table.add_column("Service", style="cyan")
+    table.add_column("What it does")
+    table.add_column("Free Limits")
+    
+    for key_id, info in FREE_API_KEYS.items():
+        table.add_row(info["name"], info["description"], info["limits"])
+    
+    console.print(table)
+    console.print()
+    
+    # Collect API keys
+    api_keys = {}
+    
+    if Confirm.ask("\nConfigure API keys now?", default=True):
+        for key_id, info in FREE_API_KEYS.items():
+            console.print(f"\n[bold]{info['name']}[/bold] - {info['description']}")
+            console.print(f"[dim]Limits: {info['limits']}[/dim]")
+            console.print(f"[dim]Get key: {info['url']}[/dim]")
+            
+            if info.get("needs_two_keys"):
+                key = Prompt.ask(f"  API Key", default="")
+                cx = Prompt.ask(f"  Custom Search Engine ID (cx)", default="")
+                api_keys[f"{key_id}_key"] = key.strip()
+                api_keys[f"{key_id}_cx"] = cx.strip()
+            else:
+                key = Prompt.ask(f"  API Key (or press Enter to skip)", default="")
+                api_keys[key_id] = key.strip()
+    else:
+        # Initialize with empty keys
+        api_keys = {
+            "hibp": "",
+            "numverify": "",
+            "intelbase": "",
+            "breachdirectory": "",
+            "google_cse_key": "",
+            "google_cse_cx": "",
+        }
+    
+    # Save config
+    config_dir = Path.home() / ".osintkit"
+    config_dir.mkdir(parents=True, exist_ok=True)
+    
+    config = {
+        "output_dir": "~/osint-results",
+        "timeout_seconds": 120,
+        "api_keys": api_keys,
+    }
+    
+    config_path = config_dir / "config.yaml"
+    with open(config_path, "w") as f:
+        yaml.dump(config, f, default_flow_style=False)
+    
+    # Create profiles file
+    profiles_path = config_dir / "profiles.json"
+    if not profiles_path.exists():
+        profiles_path.write_text("{}")
+    
+    console.print(f"\n[green]✓[/green] Config saved to: {config_path}")
+    console.print("[green]✓[/green] Ready to use!")
+    console.print("\n[bold]Next steps:[/bold]")
+    console.print("  [cyan]osintkit new[/cyan]     - Create a new profile")
+    console.print("  [cyan]osintkit list[/cyan]    - List all profiles")
+    console.print("  [cyan]osintkit setup[/cyan]   - Reconfigure API keys")
+
+
+def update_api_key(key_name: str, key_value: str):
+    """Update a single API key in config."""
+    config_path = Path.home() / ".osintkit" / "config.yaml"
+    
+    if not config_path.exists():
+        run_setup_wizard()
+        return
+    
+    with open(config_path) as f:
+        config = yaml.safe_load(f)
+    
+    if "api_keys" not in config:
+        config["api_keys"] = {}
+    
+    config["api_keys"][key_name] = key_value
+    
+    with open(config_path, "w") as f:
+        yaml.dump(config, f, default_flow_style=False)
+    
+    console.print(f"[green]✓[/green] Updated {key_name}")

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "osintkit",
+  "version": "0.1.0",
+  "description": "OSINT CLI for personal digital footprint analysis",
+  "bin": {
+    "osintkit": "./bin/osintkit.js"
+  },
+  "scripts": {
+    "postinstall": "pip3 install -e . --quiet || true"
+  },
+  "files": [
+    "bin/",
+    "osintkit/",
+    "pyproject.toml",
+    "requirements.txt",
+    "README.md"
+  ],
+  "keywords": ["osint", "security", "privacy", "cli", "recon"],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16",
+    "python": ">=3.10"
+  }
+}

package/pyproject.toml

@@ -0,0 +1,44 @@
+[tool.poetry]
+name = "osintkit"
+version = "0.1.0"
+description = "OSINT CLI tool for personal digital footprint analysis"
+authors = ["Your Name <you@example.com>"]
+license = "MIT"
+readme = "README.md"
+packages = [{include = "osintkit"}]
+
+[tool.poetry.dependencies]
+python = ">=3.10"
+typer = {extras = ["all"], version = ">=0.12.0"}
+httpx = "^0.27.0"
+rich = "^13.7.0"
+jinja2 = "^3.1.2"
+pyyaml = "^6.0.1"
+pydantic = "^2.5.0"
+aiofiles = "^23.2.1"
+phonenumbers = ">=8.13"
+questionary = ">=2.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^7.4.0"
+pytest-asyncio = "^0.21.0"
+pytest-httpx = "^0.30"
+black = "^23.0.0"
+ruff = "^0.1.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.scripts]
+osintkit = "osintkit.cli:app"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+markers = [
+    "live: marks tests requiring real network",
+]

package/requirements.txt

@@ -0,0 +1,9 @@
+typer[all]>=0.9
+rich>=13.7
+httpx>=0.27
+pyyaml>=6.0
+pydantic>=2.5
+aiofiles>=23.2
+phonenumbers>=8.13
+questionary>=2.0
+jinja2>=3.1