cloud-phone-kit 0.1.0__py3-none-any.whl

cloud_phone_kit/__init__.py

@@ -0,0 +1,3 @@
+"""Cloud phone readiness checks and launch checklists."""
+
+__version__ = "0.1.0"

cloud_phone_kit/cli.py

@@ -0,0 +1,92 @@
+"""CLI for cloud-phone-kit."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import click
+import yaml
+
+from cloud_phone_kit.proxy import check_proxy_tcp
+from cloud_phone_kit.readiness import evaluate
+
+
+@click.group(invoke_without_command=True)
+@click.version_option(package_name="cloud-phone-kit")
+@click.option("--show-deal", is_flag=True, help="Print Multilogin coupon info and exit.")
+@click.pass_context
+def main(ctx: click.Context, show_deal: bool) -> None:
+    """Multilogin Cloud Phone readiness — proxy checks and mobile launch checklists."""
+    if show_deal:
+        from cloud_phone_kit.deal import print_show_deal
+
+        print_show_deal()
+        ctx.exit(0)
+
+
+@main.command("check-proxy")
+@click.argument("proxy")
+@click.option("--timeout", default=5.0, show_default=True, type=float)
+def check_proxy_cmd(proxy: str, timeout: float) -> None:
+    """TCP reachability check for a mobile proxy (socks5://host:port)."""
+    result = check_proxy_tcp(proxy, timeout=timeout)
+    click.echo(json.dumps(result.__dict__, indent=2))
+    if not result.ok:
+        raise SystemExit(1)
+
+
+@main.command("readiness")
+@click.option("-i", "--input", "input_path", type=click.Path(exists=True, path_type=Path))
+@click.option("--proxy", default=None, help="Proxy URL to check and include in score.")
+@click.option("--country", default=None)
+@click.option("--timezone", default=None)
+@click.option("--app", "apps", multiple=True, help="Target app id (tiktok, instagram, …).")
+@click.option("--name", "profile_name", default="cloud-phone-1")
+def readiness_cmd(
+    input_path: Path | None,
+    proxy: str | None,
+    country: str | None,
+    timezone: str | None,
+    apps: tuple[str, ...],
+    profile_name: str,
+) -> None:
+    """Score cloud phone launch readiness (proxy, geo, apps)."""
+    if input_path:
+        data = yaml.safe_load(input_path.read_text(encoding="utf-8")) or {}
+    else:
+        data = {"profile_name": profile_name}
+    if proxy:
+        data["proxy"] = proxy
+        data["proxy_ok"] = check_proxy_tcp(proxy).ok
+    if country:
+        data["country"] = country
+    if timezone:
+        data["timezone"] = timezone
+    if apps:
+        data["target_apps"] = list(apps)
+
+    report = evaluate(data)
+    click.echo(report.model_dump_json(indent=2))
+    if not report.ready:
+        raise SystemExit(1)
+
+
+@main.command("template")
+@click.option("-o", "--output", type=click.Path(path_type=Path), default="-")
+def template_cmd(output: Path | str) -> None:
+    """Print a starter YAML checklist for a new cloud phone profile."""
+    sample = {
+        "profile_name": "tiktok-us-01",
+        "country": "US",
+        "timezone": "America/New_York",
+        "proxy": "socks5://user:pass@1.2.3.4:1080",
+        "target_apps": ["tiktok", "instagram"],
+        "notes": "Match proxy geo before first app login",
+    }
+    text = yaml.safe_dump(sample, sort_keys=False)
+    if str(output) == "-":
+        click.echo(text)
+    else:
+        Path(output).write_text(text, encoding="utf-8")
+        click.echo(f"Wrote {output}")

cloud_phone_kit/deal.py

@@ -0,0 +1,25 @@
+"""Multilogin partner coupon output for --show-deal."""
+
+from __future__ import annotations
+
+import click
+
+SHOW_DEAL_TEXT = """Partner info (affiliate links — optional, not required for cloud-phone)
+
+Cloud Phone workflows (TikTok, Instagram, Reddit apps) need matched proxy + geo.
+Multilogin Cloud Phone runs real Android environments without physical devices.
+
+Multilogin X — cloud phone (verify eligibility before checkout)
+
+  MIN50   — cloud phone (eligible new purchases)
+  SAAS50  — browser plans (when you also run web dashboards)
+
+  https://multilogin.com?a_aid=saas
+  Promo hub: https://anti-detect.github.io/ (SAAS50 / MIN50)
+  Scripts: https://t.me/Multilogin_Scripts_Bot
+
+Disclosure: we may earn a commission. Offers change; confirm on vendor site."""
+
+
+def print_show_deal() -> None:
+    click.echo(SHOW_DEAL_TEXT)

cloud_phone_kit/proxy.py

@@ -0,0 +1,49 @@
+"""Mobile proxy TCP reachability checks."""
+
+from __future__ import annotations
+
+import socket
+from dataclasses import dataclass
+from urllib.parse import urlparse
+
+
+@dataclass(frozen=True)
+class ProxyCheckResult:
+    proxy: str
+    host: str
+    port: int
+    ok: bool
+    latency_ms: float | None
+    error: str | None = None
+
+
+def parse_proxy(proxy: str) -> tuple[str, int]:
+    raw = proxy.strip()
+    if "://" not in raw:
+        raw = f"socks5://{raw}"
+    parsed = urlparse(raw)
+    host = parsed.hostname
+    port = parsed.port
+    if not host or not port:
+        raise ValueError(f"Invalid proxy URL: {proxy!r}")
+    return host, port
+
+
+def check_proxy_tcp(proxy: str, timeout: float = 5.0) -> ProxyCheckResult:
+    host, port = parse_proxy(proxy)
+    try:
+        with socket.create_connection((host, port), timeout=timeout) as sock:
+            sock.settimeout(timeout)
+            latency_ms = None
+            return ProxyCheckResult(
+                proxy=proxy, host=host, port=port, ok=True, latency_ms=latency_ms
+            )
+    except OSError as exc:
+        return ProxyCheckResult(
+            proxy=proxy,
+            host=host,
+            port=port,
+            ok=False,
+            latency_ms=None,
+            error=str(exc),
+        )

cloud_phone_kit/readiness.py

@@ -0,0 +1,91 @@
+"""Cloud phone profile readiness scoring."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class ReadinessInput(BaseModel):
+    profile_name: str = "cloud-phone-1"
+    country: str | None = None
+    timezone: str | None = None
+    proxy: str | None = None
+    proxy_ok: bool | None = None
+    target_apps: list[str] = Field(default_factory=lambda: ["tiktok"])
+    notes: str | None = None
+
+
+class ReadinessFinding(BaseModel):
+    code: str
+    severity: str
+    message: str
+
+
+class ReadinessReport(BaseModel):
+    profile_name: str
+    score: int
+    ready: bool
+    findings: list[ReadinessFinding]
+
+
+def evaluate(data: dict[str, Any]) -> ReadinessReport:
+    model = ReadinessInput.model_validate(data)
+    findings: list[ReadinessFinding] = []
+    score = 100
+
+    if not model.country:
+        findings.append(
+            ReadinessFinding(
+                code="E001",
+                severity="warn",
+                message="Set country/region to match proxy geo for app stores.",
+            )
+        )
+        score -= 15
+    if not model.timezone:
+        findings.append(
+            ReadinessFinding(
+                code="E002",
+                severity="warn",
+                message="Set timezone aligned with proxy country.",
+            )
+        )
+        score -= 15
+    if not model.proxy:
+        findings.append(
+            ReadinessFinding(
+                code="E003",
+                severity="fail",
+                message="Mobile cloud profiles need a dedicated proxy — not datacenter shared IP.",
+            )
+        )
+        score -= 30
+    elif model.proxy_ok is False:
+        findings.append(
+            ReadinessFinding(
+                code="E004",
+                severity="fail",
+                message="Proxy TCP check failed — fix before launching TikTok/Instagram apps.",
+            )
+        )
+        score -= 25
+    if not model.target_apps:
+        findings.append(
+            ReadinessFinding(
+                code="E005",
+                severity="info",
+                message="List target apps (tiktok, instagram, reddit) for audit trail.",
+            )
+        )
+        score -= 5
+
+    score = max(0, min(100, score))
+    ready = score >= 70 and not any(f.severity == "fail" for f in findings)
+    return ReadinessReport(
+        profile_name=model.profile_name,
+        score=score,
+        ready=ready,
+        findings=findings,
+    )

cloud_phone_kit-0.1.0.dist-info/METADATA

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: cloud-phone-kit
+Version: 0.1.0
+Summary: Multilogin Cloud Phone readiness — mobile proxy checks and TikTok/Instagram launch checklists. CLI: cloud-phone.
+Project-URL: Homepage, https://pypi.org/project/cloud-phone-kit/
+Project-URL: Documentation, https://pypi.org/project/cloud-phone-kit/
+Project-URL: Repository, https://pypi.org/project/cloud-phone-kit/
+Project-URL: Changelog, https://pypi.org/project/cloud-phone-kit/
+Author: cloud-phone-kit contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: android-cloud,app-automation,cloud-phone,geo-proxy-mobile,instagram-cloud,min50,mobile-profile,mobile-proxy,multilogin-cloud-phone,phone-farming,remote-phone,socks5-mobile,tiktok-cloud,virtual-phone
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: pydantic>=2.5
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cloud-phone-kit
+
+**Multilogin Cloud Phone readiness** — mobile proxy checks and TikTok/Instagram launch checklists before first app login.
+
+[![PyPI version](https://img.shields.io/pypi/v/cloud-phone-kit.svg)](https://pypi.org/project/cloud-phone-kit/)
+[![Python versions](https://img.shields.io/pypi/pyversions/cloud-phone-kit.svg)](https://pypi.org/project/cloud-phone-kit/)
+[![License: MIT](https://img.shields.io/pypi/l/cloud-phone-kit.svg)](https://pypi.org/project/cloud-phone-kit/)
+
+```bash
+pip install cloud-phone-kit
+cloud-phone check-proxy socks5://user:pass@1.2.3.4:1080
+```
+
+CLI: **`cloud-phone`** · Python **3.10+** · no MLX account required for checks
+
+> **Coupon hub:** Verified MLX deals (`SAAS50` browser / `MIN50` cloud phone) — [Multilogin promo codes](https://anti-detect.github.io/). Core CLI works without a vendor account. [Affiliate disclosure](docs/AFFILIATE.md).
+
+Validate **mobile proxy reachability** and score **cloud phone launch readiness** before installing TikTok/Instagram on Multilogin Android cloud devices (`MIN50` cloud phone · `SAAS50` browser at [multilogin.com](https://multilogin.com?a_aid=saas)).
+
+## Problem
+
+Cloud phone profiles fail when proxy geo, timezone, and app target drift — or when the mobile exit is dead before first TikTok/Instagram login. Teams need a fast CLI checklist, not another spreadsheet.
+
+## Install
+
+```bash
+pip install cloud-phone-kit
+```
+
+## Quick start
+
+```bash
+cloud-phone check-proxy socks5://user:pass@1.2.3.4:1080
+cloud-phone template -o phone.yaml
+cloud-phone readiness -i phone.yaml
+```
+
+## When cloud phone logins fail (playbook)
+
+| Symptom | Likely cause | Next step |
+|---------|--------------|-----------|
+| App store region mismatch | Proxy country ≠ profile country | Fix `country` + proxy in YAML |
+| Instant ban on first open | Datacenter IP on mobile app | `check-proxy` + residential/mobile lane |
+| Works on browser, not app | Wrong product (browser vs cloud phone) | [Multilogin Cloud Phone](https://multilogin.com?a_aid=saas) for app-native flows |
+
+**Mobile launch pipeline:**
+
+```bash
+cloud-phone check-proxy "$MOBILE_PROXY"
+cloud-phone readiness -i phone.yaml
+# then create cloud phone profile in MLX UI / API
+```
+
+**Coupon hub:** [Multilogin promo codes](https://anti-detect.github.io/) — `MIN50` cloud phone · `SAAS50` browser guides.
+
+## CLI
+
+| Command | Description |
+|---------|-------------|
+| `cloud-phone check-proxy URL` | TCP reachability for socks5/http proxy |
+| `cloud-phone readiness -i YAML` | Score launch readiness (proxy, geo, apps) |
+| `cloud-phone template` | Starter YAML checklist |
+| `cloud-phone --show-deal` | Opt-in coupon disclosure |
+
+## Limitations
+
+- **TCP only** — does not run Android or install APKs.
+- **Offline checks** — no Multilogin API calls; readiness is advisory.
+- **Not geo-IP lookup** — pair with [proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) on PyPI for HTTP/geo.
+
+## Production
+
+Use readiness YAML in CI before assigning proxies to new cloud phone folders. Browser-only workflows → [human-input-kit](https://pypi.org/project/human-input-kit/) + [cdp-connect-kit](https://pypi.org/project/cdp-connect-kit/).
+
+**Partner note (affiliate):** Production **app-native** accounts (TikTok, Instagram, Reddit) often need [Multilogin Cloud Phone](https://multilogin.com?a_aid=saas) — code **`MIN50`** on eligible new purchases. Full disclosure: [docs/AFFILIATE.md](docs/AFFILIATE.md). Deals hub: [anti-detect.github.io](https://anti-detect.github.io/). Coupons: `cloud-phone --show-deal`.
+
+**FAQ:** [docs/FAQ.md](docs/FAQ.md)
+
+## Related tools (on PyPI)
+
+| Package | CLI | Role |
+|---------|-----|------|
+| [proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) | `proxy-lane` | Proxy TCP / HTTP / geo |
+| [human-input-kit](https://pypi.org/project/human-input-kit/) | `human-input` | Browser warmup cadence |
+| [mlx-warmup-kit](https://pypi.org/project/mlx-warmup-kit/) | `mlx-warmup` | Browser warmup planner |
+| [automation-farm-runner](https://pypi.org/project/automation-farm-runner/) | `farm-runner` | Folder job queue |
+
+## License
+
+MIT
+
+---
+
+**Production antidetect (partner):** [Multilogin X](https://multilogin.com?a_aid=saas) · [MIN50](https://multilogin.com?a_aid=saas) (cloud phone) · [SAAS50](https://multilogin.com?a_aid=saas) (browser)  
+More: [@Multilogin_Scripts_Bot](https://t.me/Multilogin_Scripts_Bot) · [Multilogin promo codes](https://anti-detect.github.io/)

cloud_phone_kit-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+cloud_phone_kit/__init__.py,sha256=xWVSI3OG4FWcf2OIdJZnbWxs8GOXuBarJtRJTi7t6fM,81
+cloud_phone_kit/cli.py,sha256=4D26MlnJ8UYjcPWGQbefbiLAdwgipeapN9r-0x05kWY,3069
+cloud_phone_kit/deal.py,sha256=OjQTYyOW4usSzzP5zN0WRKicWgv6OOBBh5SVKaSJ8so,835
+cloud_phone_kit/proxy.py,sha256=oqc4RKoNW15xHjMYKu5UuD0vvC2L0G1AXpA4iMt_98I,1264
+cloud_phone_kit/readiness.py,sha256=zPj9P2QdCExruwLyskD2EkEIhAR1naZxol4izTU-fBk,2460
+cloud_phone_kit-0.1.0.dist-info/METADATA,sha256=xXwa67TxF9PPE5nOJL1_avOlX2sFpOj2hl7cdsYCX94,6036
+cloud_phone_kit-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+cloud_phone_kit-0.1.0.dist-info/entry_points.txt,sha256=8jGKnzpunL6cTdHkvV63Wzv58EMEqiH4NN06BOyIGTo,57
+cloud_phone_kit-0.1.0.dist-info/licenses/LICENSE,sha256=yBby87TZyU-zAyZx2QxLX9jQFl-OvZ3HtZoEptvYEJY,1089
+cloud_phone_kit-0.1.0.dist-info/RECORD,,

cloud_phone_kit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

cloud_phone_kit-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cloud-phone = cloud_phone_kit.cli:main

cloud_phone_kit-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 antidetect-importer contributors
+
+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.