Metadata-Version: 2.4
Name: cloud-phone-geo
Version: 7.6.0
Summary: Cloud phone geo presets for Multilogin — country, locale, timezone, proxy match for TikTok, Instagram, Shopee antidetect mobile.
Author: Enterprise Automation Infra
License-Expression: MIT
Project-URL: Telegram, https://t.me/Multilogin_Scripts_Bot?start=pypi_cloud_phone_geo
Project-URL: Funding, https://saasverdict.com/?utm_source=pypi&utm_medium=funding&utm_campaign=cloud-phone-geo
Project-URL: Homepage, https://pypi.org/project/cloud-phone-geo/
Project-URL: Repository, https://github.com/enterprise-automation-infra/multilogin-automation
Project-URL: Documentation, https://docs.cloud-phone.dev/
Project-URL: Deals, https://saasverdict.com/?utm_source=pypi&utm_medium=deals&utm_campaign=cloud-phone-geo
Project-URL: LinkedIn, https://www.linkedin.com/in/multilogin-promo-code-saas50/
Keywords: multilogin,cloud phone,antidetect,android geo,mobile antidetect,tiktok country,proxy country,locale,timezone,phone farm,virtual android,android geo cloud phone,proxy country validation,locale timezone mobile,shopee indonesia cloud phone,phone farm country codes,mlx-cloud-phone,cloud-phone-warmup,cloud-phone-fleet
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: mlx
Requires-Dist: mlx-cloud-phone>=7.6.0; extra == "mlx"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=7.6.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=7.6.0; extra == "dev"
Requires-Dist: ruff>=0.4.0; extra == "dev"
Requires-Dist: mlx-cloud-phone>=7.6.0; extra == "dev"
Dynamic: license-file

# cloud-phone-geo

<!-- pypi-badges:start -->
<p align="center">
  <a href="https://pypi.org/project/cloud-phone-geo/"><img src="https://img.shields.io/badge/version-7.6.0-0078D4" alt="PyPI version" /></a>
  <a href="https://pypi.org/project/cloud-phone-geo/"><img src="https://img.shields.io/pypi/pyversions/cloud-phone-geo" alt="Python versions" /></a>
  <a href="https://pypistats.org/packages/cloud-phone-geo/"><img src="https://img.shields.io/pypi/dm/cloud-phone-geo?color=0078D4" alt="PyPI downloads" /></a>
  <a href="https://multilogin.com/mobile/cloud-phone/"><img src="https://img.shields.io/badge/Multilogin-Cloud_Phone-0078D4" alt="Multilogin Cloud Phone" /></a>
  <a href="https://saasverdict.com/"><img src="https://img.shields.io/badge/SAAS50-50%25_OFF-0078D4" alt="SAAS50" /></a>
  <a href="https://saasverdict.com/"><img src="https://img.shields.io/badge/MIN50-minutes-0078D4" alt="MIN50" /></a>
  <a href="https://t.me/Multilogin_Scripts_Bot?start=pypi_cloud_phone_geo"><img src="https://img.shields.io/badge/Telegram-Scripts-26A5E4?logo=telegram&logoColor=white" alt="Telegram bot" /></a>
</p>
<!-- pypi-badges:end -->

**41 country presets** for [Multilogin Cloud Phone](https://multilogin.com/mobile/cloud-phone/) — align **proxy geo**, **locale**, and **timezone** for **antidetect mobile** workflows on TikTok, Instagram, Shopee, and WhatsApp worldwide.

---

## Install

```bash
pip install cloud-phone-geo
pip install cloud-phone-geo[mlx]   # + mlx-cloud-phone
```

## Quick start

```python
from cloud_phone_geo import get_preset, validate_proxy_country, suggest_for_app

preset = get_preset("VN")  # Vietnam — TikTok Shop / Shopee
assert validate_proxy_country("VN", "VNM")
for p in suggest_for_app("tiktok shop"):
    print(p.code, p.mlx_country)
```

```bash
cloud-phone-geo list --region SEA
cloud-phone-geo suggest tiktok --limit 5
cloud-phone-geo build --name id-shop-01 --country ID --json
cloud-phone-geo validate --phone US --proxy USA
cloud-phone-geo search shopee
cloud-phone-geo apps
cloud-phone-geo positioning
```

---

## Why geo matters for antidetect cloud phones

| Mismatch | Risk |
|----------|------|
| US proxy + VN locale | App trust / verification friction |
| Random timezone | Session anomalies on mobile apps |
| Wrong MLX country code | Profile create fails or wrong market |

This package maps **ISO-2 → MLX ISO-3** (`US` → `USA`, `ID` → `IDN`) with locale and timezone baked in.

---

## Stack

| Package | Role |
|---------|------|
| [mlx-cloud-phone](https://pypi.org/project/mlx-cloud-phone/) | Create phones from presets (`mlx-phone create --geo US`) |
| **cloud-phone-geo** (this) | Country / locale / proxy validation |
| [cloud-phone-warmup](https://pypi.org/project/cloud-phone-warmup/) | Regional warmup plans |
| [cloud-phone-fleet](https://pypi.org/project/cloud-phone-fleet/) | Bulk CSV by country |

---

## Popular searches

- cloud phone country preset · android geo cloud phone
- tiktok country cloud phone · multilogin proxy country
- mobile antidetect geo · virtual phone usa tiktok
- shopee indonesia cloud phone · instagram geo mobile
- antidetect locale timezone · phone farm country codes

`cloud-phone-geo seo --json`

---

## FAQ

**Why ISO-3 for Multilogin?** MLX CLI uses `USA`, `GBR`, `IDN` — we accept `US`, `GB`, `ID` and normalize.

**Best preset for TikTok Shop SEA?** `cloud-phone-geo suggest "tiktok shop"` → ID, VN, PH, SG, MY.

**Works without Multilogin?** Presets are standalone; create phones via [mlx-cloud-phone](https://pypi.org/project/mlx-cloud-phone/).

---

<!-- stack-cross-links -->

## Full PyPI stack (install all)

```bash
pip install mlx-cloud-phone[stack]
```

| Package | Role |
|---------|------|
| [mlx-cloud-phone](https://pypi.org/project/mlx-cloud-phone/) | Hub SDK + `mlx-phone` CLI |
| [cloud-phone-geo](https://pypi.org/project/cloud-phone-geo/) | 41 country presets, proxy match |
| [cloud-phone-warmup](https://pypi.org/project/cloud-phone-warmup/) | TikTok / IG / Shopee warmup campaigns |
| [cloud-phone-fleet](https://pypi.org/project/cloud-phone-fleet/) | Batch create, health checks, campaigns |

Scripts & promo: [@Multilogin_Scripts_Bot](https://t.me/Multilogin_Scripts_Bot?start=pypi_cloud_phone_geo) · press `/start`

## Affiliate disclosure

| Product | Code | Links |
|---------|------|-------|
| Multilogin plans | **SAAS50** | [SaaSVerdict](https://saasverdict.com/?utm_source=pypi&utm_medium=readme&utm_campaign=cloud-phone-geo) |
| Cloud Phone minutes | **MIN50** | [LinkedIn](https://www.linkedin.com/in/multilogin-promo-code-saas50/) |

Verify checkout discount lines at [SaaSVerdict](https://saasverdict.com/).
<!-- telegram-cta -->

## Telegram — scripts & promo alerts

Join [**Multilogin ⚙️ Automation Scripts**](https://t.me/Multilogin_Scripts_Bot) on Telegram — antidetect scripts, Cloud Phone API tips, and live **SAAS50** / **MIN50** reminders. Press `/start` in the bot.

