ghost/tiktok

TikTok — user's-own-account actions: nav, account switching, self-stats, self-uploads. ToS-safe surface only.

Draft Score 7/100 Official hard skill python filesnotifications

High terms-of-service risk. The vendor's terms prohibit automated access or bot-created accounts. Published for research: do not run it against live accounts. Not vendor-approved.

8actions not benchmarked yet

No clean demo yet. Recordings will start on HOME and show the app launching.

tiktok

Ghost in the Droid skill: TikTok automation for your own account. ToS-safe surface only.

8 actions, all deterministic hard-skill:

ActionWhat it does
open_my_profileNavigate to your profile tab
open_inboxNavigate to your inbox
get_active_accountReturn current active @handle
get_unread_countRead the unread-notifications badge count
get_my_statsScrape your handle + display-name + followers/following/likes
list_accountsEnumerate all logged-in accounts on this device
switch_accountSwitch active account to a given @handle
upload_videoUpload a video via share intent: caption, hashtags, optional TTS, draft or post

Install

pip install ghost-in-the-droid>=1.6.0   # 1.6.0 is not on PyPI yet: until it ships, git clone the repo and `pip install -e .`
ghost skill install ghost/tiktok

Use

# Simple: read your own stats
ghost "how many followers do I have on tiktok" --device asus

# Switch accounts
ghost "switch to my my_other_account tiktok" --device asus

# Upload a draft
ghost "upload cat.mp4 to tiktok as a draft with caption 'look at this' and #cat #fyp" --device asus

Or programmatically via MCP:

run_skill(name="ghost/tiktok", action="get_my_stats")
# → {"stats": {"handle": "yourhandle", "following": 62, "followers": 10, ...}}

run_skill(name="ghost/tiktok", action="switch_account", params={"handle": "my_other_account"})
# → {"switched_to": "my_other_account"}

run_skill(name="ghost/tiktok", action="upload_video", params={
    "video_path": "/sdcard/DCIM/cat.mp4",
    "caption": "look at this",
    "hashtags": ["cat", "fyp"],
    "action_mode": "draft",
})

Fingerprint

  • Android ≥13
  • Any hardware (wildcard; tested on ASUS ROG )
  • TikTok app com.zhiliaoapp.musically ≥44.0.0

Fingerprint mismatch: the engine falls back to Tier 2 Adapt (LLM re-mines the flow using SOFT.md as reference).

Data access

  • files (video upload)
  • notifications (unread badge read)

Popup handling

skill.yaml declares 10 popup detectors auto-dismissed before every step: FB/Contacts access, notifications enable, TikTok Shop relevance, draft resume overlay, rate-app nag, security checkup, invisible promo overlays, etc.

Unknown popups: the engine takes a screenshot and raises UnknownPopupError so the catalog can be extended.

Not in this skill

  • Outreach / DMs to strangers
  • Mass-crawl / mass-scrape
  • Auto-like / auto-comment / auto-follow
  • Account signup (would be a soft-skill with HITL captcha)
  • Account deletion

References

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceEvidence
44.3.312 (run artifact fingerprint)asus/ASUS_I002D (ROG, physical, 1080x2400)1 signed self-run in runs/ (get_my_stats, pass, 2026-10-05)
44.3.3as abovesame ROGmaintainer live runs, not signed artifacts: 7/8 actions green, later 8/8 with upload_video 10/10 steps (2026-10-05)

Untested: emulators (TikTok is not installable there without a Play account), other OEMs, other screen sizes, locales other than en-US.

Recorded failures

None in the signed self-runs. Known from maintainer runs: upload_video once stopped at 9/10 steps because the hashtag autocomplete list covered the Drafts button.

Popups and first-run screens handled

FB friends and contacts access, Facebook access, TikTok Shop relevance, shared collections, notifications, security checkup, rate-the-app, draft resume overlay, avatar upsell (BACK), precise-location upgrade. Storage permission is allowed (os_popup_policy) for uploads.

Other known failure modes

  • The home feed autoplays video, so the accessibility tree never reaches idle: uiautomator dump fails there. Navigation to Profile uses a coordinate tap on the bottom bar (y 2214 on 1080x2400) and only reads the tree on the static profile page; other screen heights need a new coordinate.
  • dumpsys reports SplashActivity for 30 s or more after the feed is visible; wait on the Profile content-desc instead.
  • The display name that opens the account switcher has no stable id; helpers.py falls back to coordinates.
  • "Learn more" alone is too broad to use as a promo detector (it appears on feed captions and ads).
  • New TikTok versions add popups; unknown ones raise UnknownPopupError with a screenshot so the catalog can grow.

Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.

open_my_profile

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • Open my TikTok profile
  • open my profile
  • go to my TikTok profile page
  • show me my profile
ghost skill run ghost/tiktok open_my_profile

open_inbox

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • Open my TikTok inbox
  • open my inbox
  • check my TikTok messages
ghost skill run ghost/tiktok open_inbox

get_active_account

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • What TikTok account am I logged in as?
  • which account am I using
  • current tiktok handle
  • who am I logged in as on tiktok
ghost skill run ghost/tiktok get_active_account

get_unread_count

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • How many unread TikTok notifications do I have?
  • check my tiktok notifications count
  • how many unread messages on tiktok
ghost skill run ghost/tiktok get_unread_count

get_my_stats

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • How many followers do I have on TikTok?
  • my tiktok stats
  • follower count
  • how many likes do I have on tiktok
ghost skill run ghost/tiktok get_my_stats

list_accounts

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • List all my TikTok accounts on this phone
  • list all my tiktok accounts
  • which tiktok accounts are logged in
  • show me all my tiktoks
ghost skill run ghost/tiktok list_accounts

switch_account

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • Switch to my my_other_account TikTok account
  • switch to my_other_account on tiktok
  • log into my my_other_account account
ghost skill run ghost/tiktok switch_account

upload_video

no demo yet
Requires: logged in

auto-login runner: beta

Try asking

  • Upload cat.mp4 to TikTok as a draft with caption 'look at this' and hashtags #cat #fyp
  • upload cat.mp4 to tiktok as a draft
  • post this video to tiktok
  • share my video on TikTok with caption 'hi' and tag #test
ghost skill run ghost/tiktok upload_video