com-android-vending-search-app

name	com.android.vending.search-app
clawperator-skill-type	replay
description	Search for Android apps in the Google Play Store and list the first visible search results.

Searches for a named app in the Google Play Store and returns the first visible search results in UI order, similar to the Amazon search skill.

Current behavior:

• opens the Play Store search surface
• enters the query
• waits for the results surface to become readable
• parses the first 5 visible app rows
• emits a terminal [Clawperator-Skill-Result] frame with structured results

Usage

./skills/com.android.vending.search-app/scripts/search_play_store.sh <device_id> <query> [operator_package]

Examples:

./skills/com.android.vending.search-app/scripts/search_play_store.sh <device_serial> "VLC"

Output

On success, prints the first visible search results including:

• App name
• Developer
• Sponsored state when visible
• Install state when visible
• A terminal ✅ summary line
• A terminal [Clawperator-Skill-Result] frame with structured results

Blocking states

• Login prompt: If the user is not signed in to Google Play, an account picker or sign-in screen will appear. Script exits with an error message.
• App not found: If no results are returned for the query, script exits with an error.

Notes

• No resource-ids are present on Play Store UI elements. All selectors use text, content-desc, or role matchers.
• content-desc attributes in Play Store use HTML entity encoding (' etc). Use contentDescContains for substring matching instead of exact matches.
• The search input field has no resource-id; use role: "textfield" to target it.
• This skill now reports search results rather than navigating into an app details page.
• The runtime uses wait_for_node and bounded snapshot polling instead of fixed sleeps so it can react to the Play Store becoming ready instead of guessing delays.
• The optional package_id arg is currently accepted for compatibility but ignored by the runtime script.
• If snapshot extraction fails (step returns success: false with data.error: "SNAPSHOT_EXTRACTION_FAILED", or the skill exits with "No snapshot returned" despite the device being on the correct screen), the clawperator binary may be out of date with the Android Operator APK. Set CLAWPERATOR_BIN to the local build: export CLAWPERATOR_BIN=/path/to/clawperator/apps/node/dist/cli/index.js Then verify with: clawperator snapshot --device <id>