geelark-handle-change

GeeLark Handle Change Skill

Change X/Twitter account handles (usernames) using GeeLark cloud phone automation. The tool navigates to X's settings page on a cloud phone, types the new handle, waits for X's real-time validation, and taps Save.

When to Use This Skill

• Changing an X account's handle/username
• Checking if a handle is available (attempt the change; X validates in real-time)
• Updating handles for managed accounts after domain/brand decisions
• Rotating handles on warming accounts

Tool Discovery

search_tools({ query: "geelark_change_handle" })
search_tools({ query: "geelark_check_job" })

Available Tools

Tool	Purpose
geelark_change_handle	Start an async handle change job
geelark_check_job_status	Poll job progress/result

Usage

Change a Handle

// 1. Start the handle change (async job)
geelark_change_handle({
  phone_id: "phone-profile-id",
  account_id: "vault-account-uuid",
  new_handle: "mynewhandle",
  auto_stop: true  // optional, default true — stops phone after completion
})
// Returns: { job_id: "uuid", status: "running" }

// 2. Poll for completion (every 10-15 seconds)
geelark_check_job_status({ job_id: "uuid" })
// Returns: { status: "completed", result: { success: true, previousHandle: "oldname", newHandle: "mynewhandle" } }

Handle Taken

If the handle is already taken, X's real-time validation catches it before Save is tapped:

{
  "status": "completed",
  "result": {
    "success": false,
    "previousHandle": "oldname",
    "newHandle": "takenhandle",
    "error": "That username has been taken. Please choose another.",
    "errorCode": "handle_taken"
  }
}

Error Codes

Code	Meaning
handle_taken	Another account already has this handle
invalid_format	Handle contains invalid characters or wrong length (must be 4-15, alphanumeric + underscore)
rate_limited	X is rate-limiting handle changes (try again later)
save_failed	Save button tap didn't succeed
navigation_failed	Could not load the settings page
input_not_found	Could not find the username input field