Pp Google Play

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/marketing/google-play/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Google Play — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the google-play-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install google-play --cli-only

2. Verify: google-play-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/marketing/google-play/cmd/google-play-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Pull app details, top charts, search, reviews, similar apps, developer portfolios, permissions, and data safety from the public Play Store with no API key. Then go further than any existing scraper: snapshot charts and listings into a local database so 'movers', 'rank-history', 'keyword-history', and 'watch-listing' can answer week-over-week questions Google never exposes and commercial tools paywall.

When to Use This CLI

Use this CLI when you need structured, scriptable Google Play Store data without an API key: profiling an app and its competitive set, tracking chart and keyword rank over time, detecting listing changes, or mining reviews. It is built for mobile game and app market intelligence, ASO research, and AI agents that need clean JSON and a typed rate-limit signal.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to manage your own published apps (releases, store listings, replying to reviews) — that needs the Google Play Developer API and a service-account key, not the public store.
• Do not use it for download or revenue estimates, DAU/MAU, retention, or demographics — those come from panels and models, not the public store, and this CLI does not fabricate them.
• Do not point it at the Apple App Store; it only reads Google Play.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local history that compounds

• movers — See which games climbed, dropped, entered, or fell off a Play chart between two snapshots.

  Reach for this when an agent needs week-over-week rank movement that Play never exposes and Sensor Tower paywalls.

  google-play-pp-cli movers --collection TOP_GROSSING --category GAME_PUZZLE --country us --agent

• rank-history — Show one app's rank trajectory over time within a chart, including first-seen, peak, and last-seen rank.

  Pick this when you need the trend line for a single title, not the whole chart.

  google-play-pp-cli rank-history com.dreamgames.royalkingdom --collection TOP_GROSSING --category GAME --country us --agent

• watch-listing — Diff the two latest snapshots of a listing to surface what changed: title, icon, version, IAP range, ads flag, price, screenshots.

  Use this to catch a competitor's monetization or positioning shift the moment it ships, instead of eyeballing screenshots.

  google-play-pp-cli watch-listing com.yalla.yallagames --agent

ASO rank tracking

• keyword-rank — Run a live store search for a term and record where a target app ranks, persisting the data point for trend analysis.

  Reach for this to log today's keyword position so tomorrow's metadata change can be measured.

  google-play-pp-cli keyword-rank "merge puzzle" --country us --app com.yalla.yallagames --agent

• keyword-history — Show the rank-over-time series for a term, app, and country from captured keyword snapshots.

  Use this to prove whether a listing change actually moved a keyword over time.

  google-play-pp-cli keyword-history "merge puzzle" --country us --app com.yalla.yallagames --agent

Review intelligence

• review-digest — Aggregate synced reviews into star and per-version histograms, developer reply rate, and complaint-term frequency, with no NLP.

  Pick this for mechanical post-update sentiment stats; pipe the output to an LLM if you want prose.

  google-play-pp-cli review-digest com.yalla.yallagames --agent

• compare — Fetch details for several apps and lay their key fields side by side in one table.

  Use this to benchmark a title against its competitive set in a single call.

  google-play-pp-cli compare com.yalla.yallagames com.dreamgames.royalkingdom --agent --select items.appId,items.score,items.installs,items.offersIAP

Discovery Signals

This CLI was generated with browser-observed traffic context.

• Capture coverage: 6 API entries from 8 total network entries
• Protocols: ssr_embedded_data (95% confidence), google_batchexecute (95% confidence)
• Generation hints: standard_http: no browser transport or clearance cookie needed in the printed CLI, responses are positional protojson (anonymous nested arrays) under AF_initDataCallback or batchexecute framing; the printed CLI must hand-parse with index paths and fallbacks, not generic JSON field mapping, no auth: all surfaces answer anonymously; rate-limit risk via 429 / 503+captcha / PlayGatewayError-in-200, mitigate with throttle + backoff + caching
• Caveats: : batchexecute responses use the )]}' length-prefixed double-encoded JSON envelope; positional index paths shift on store redesigns roughly once a year

Command Reference

categories — Enumerate Google Play app/game categories from the public store

• google-play-pp-cli categories — List Google Play category slugs (GAME_ACTION, GAME_PUZZLE, ...) scraped from the store nav

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

google-play-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Profile an app for an agent

google-play-pp-cli app com.dreamgames.royalkingdom --agent --select appId,title,developer,score,realInstalls,offersIAP,containsAds

Narrow a verbose detail payload to the fields an agent actually needs.