Integraciones
SDK de Python
Asigna tareas a los teléfonos y automatízalos desde Python en pocas líneas.
Instalación
Terminal
pip install clousd export CLOUSD_API_KEY=cl_live_…
Una tarea
Python
from clousd import Clousd c = Clousd() # key from CLOUSD_API_KEY run = c.run("Open Settings and tell me the Android version", device="c3f9a41d2", wait=True) print(run.status, run.answer) # completed Android 15 # the same task on several phones at once run = c.run("Open the app and tell me what the first screen shows", devices=["c3f9a41d2", "c81d07e5a"], wait=True) for r in run.children: print(r.device, r.status, r.answer)
Seguirla y responder
Python
login = c.credentials("com.example.shop")[0] # names only; the values never leave Clousd
run = c.run("Sign in and tell me how many orders there are", device="c3f9a41d2", credentials=[login], mode="ask",
output_schema={"type": "object", "properties": {"orders": {"type": "integer"}}})
for ev in run.events(): # live: status, plan, step, card, answer, end
if ev["event"] == "step":
print(ev["data"]["n"], ev["data"]["tool"], ev["data"]["result"])
if ev["event"] == "card":
run.reply(allow=True) # or run.reply("the first one")
print(run.refresh().structured_output) # {"orders": 3}| Tareas | Accesos, horarios, webhooks |
|---|---|
c.run(task, device=… / devices=[…]), device.run(task) | c.credentials(), c.add_credential(package, name, fields) |
run.wait(), run.events(), run.trajectory() | c.schedules(), c.add_schedule(task, devices, at, days, tz, every="hour", trigger="api", more=[…]), c.run_schedule(id) |
run.reply(), run.message(), run.cancel(), c.runs() | c.webhooks(), c.add_webhook(url, events) |
Paso a paso
Python
phone = c.device("c3f9a41d2")
phone.open_app("com.android.chrome") # act
phone.tap_text("Search")
phone.type("weather in Berlin")
phone.key("enter")
phone.wait_text("Berlin", timeout=30) # check
png = phone.screenshot(width=540) # look| Mirar | Actuar |
|---|---|
screenshot(), screen_text(), find_text() | tap(), swipe(), scroll(), type(), key() |
observe(), size(), installed() | open_app(), open_url(), tap_text(), wait_text() |
notifications(), crashes(), health() | start(), stop(), restart(), reset() |
Las operaciones largas del dispositivo devuelven un Job y esperan por defecto; pasa wait=False para consultarlo tú. Los errores lanzan ClousdError con el estado HTTP y un mensaje. El cliente espera y reintenta ante un 429. Desde la terminal: clousd run "…" --device … muestra los pasos en vivo.
Código fuente y ejemplos: clousd-sdk en GitHub.