x-profile-setup

X Profile Setup Agent

Mission

Configure X accounts with profile information (display name, bio, location, avatar, banner) and change handles via GeeLark cloud phones. Uses X's REST API via CDP fetch() inside Chrome — existing session cookies are sufficient, NO fresh login needed.

Architecture

All profile updates use X's REST API executed via CDP fetch() inside Chrome on the GeeLark phone:

• Text fields (name, bio, location): POST /i/api/1.1/account/update_profile.json
• Avatar: POST /i/api/1.1/account/update_profile_image.json (base64 encoded)
• Banner: POST /i/api/1.1/account/update_profile_banner.json (base64 encoded)
• x-client-transaction-id: Auto-generated server-side for each endpoint
• Image resize: Server auto-resizes with sharp (200x200 JPEG q70 avatar, 600x200 JPEG q60 banner)
• Everything batched into ONE CDP call per phone session

CRITICAL: Do NOT Login Before Profile Setup

The geelark_setup_profile tool uses X's REST API via CDP fetch() with existing session cookies in Chrome. It does NOT need a fresh Chrome login. Logging in first:

• Wastes 3-5 minutes per account
• Frequently fails (verification challenges, rate limits)
• Is completely unnecessary

Only login (geelark_login_x_account) when:

• Cookies are expired AND you get HTTP 403 from the profile setup
• You specifically need to refresh cookies for the HTTP API layer
• The account has never been logged in on this phone

Tool Discovery

search_tools({ query: "geelark" })           // All geelark_* tools
search_tools({ query: "geelark_check_job" }) // Async polling

Workflow

Profile Setup (text + images)

// 1. Launch phone — NO LOGIN NEEDED
geelark_launch_phone({ phone_id: "PHONE_ID" })

// 2. Setup profile directly — the tool handles everything:
//    - Server downloads + resizes images with sharp
//    - Generates x-client-transaction-id for each API endpoint
//    - Builds JS file on phone with embedded base64 image data
//    - Chrome executes fetch() to X's REST API with session cookies
const { job_id } = geelark_setup_profile({
  phone_id: "PHONE_ID",
  account_id: "vault-uuid",
  display_name: "Display Name",
  bio: "Bio text (max 160 chars)",
  location: "City, ST",
  avatar_url: "https://example.com/avatar.png",  // Public URL, auto-resized
  banner_url: "https://example.com/banner.png",   // Public URL, auto-resized
  auto_stop: true  // Phone stops when done
})

// 3. Poll until done
geelark_check_job_status({ job_id })  // Every 15 seconds