#ASO Tools

Tools for App Store Optimization data management.

#Tools

#aso-to-public (pull)

Converts ASO data from .aso/pullData/ to public/products/[slug]/ format.

Input:

• slug (required): Product slug
• locale (optional): Target locale (defaults to all available)

Output:

• Conversion prompts for each locale
• Structured data ready for web use

#public-to-aso (push)

Converts public/products/[slug]/ data back to ASO format for .aso/pushData/.

Input:

• slug (required): Product slug
• dryRun (optional): Preview without writing files
• locales (optional): Specific locales to process

Output:

• Store-ready ASO data
• Screenshot paths for upload

#improve-public

Generates ASO optimization prompts for existing public data.

Input:

• slug (required): Product slug
• locale (optional): Target locale for optimization
• mode (optional): primary (keyword optimization) or localize (translation)

Output:

• Keyword analysis
• Optimization suggestions
• Localization prompts

#validate-aso

Validates ASO data against store field limits and rules.

Input:

• slug (required): Product slug
• store (optional): appStore, googlePlay, or both

Output:

• Field length validation
• Keyword uniqueness check
• Policy compliance warnings

#keyword-research

Manages keyword research data for ASO optimization.

Input:

• slug (required): Product slug
• locale (required): Target locale
• platform (optional): ios or android

Output:

• Keyword research file paths
• Research prompts for analysis

#localize-screenshots

Translates app screenshots to multiple languages using Gemini API. Default model: gemini-3.1-flash-image-preview (optionally gemini-3-pro-image-preview).

Requirements:

• Gemini API key must be configured (see Configuration)
• Screenshots must exist in public/products/{slug}/screenshots/{locale}/phone/ and/or tablet/

Input:

• appName (required): App name, slug, bundleId, or packageName
• targetLocales (optional): Specific locales to translate to (defaults to all supported locales)
• deviceTypes (optional): ["phone"], ["tablet"], or ["phone", "tablet"] (default: both)
• dryRun (optional): Preview mode without actual translation (default: false)
• skipExisting (optional): Skip if translated file exists (default: true)
• screenshotNumbers (optional): Specific screenshot numbers to process
  • Array for all devices: [1, 3, 5]
  • Object for per-device: { phone: [1, 2], tablet: [1, 3, 5] }
  • If not provided, all screenshots will be processed
• preserveWords (optional): Words to keep untranslated (e.g., ["Pabal", "Pro", "AI"])
• imageModel (optional): "flash" (default) or "pro"

Output:

• Translated screenshots saved to screenshots/{targetLocale}/phone/ and tablet/
• Images automatically resized to match source dimensions

Cost Information:

• Image generation costs approximately $0.13 per image

Supported Languages:

For best performance, only the following languages are supported for image generation, as specified in the Gemini API documentation:

Similar locales are grouped together to reduce API calls. For example, translating to Spanish (es-MX) will automatically save the same image to es-419, es-ES, and es-US folders.

Locales not in the supported list will be skipped during translation.

Example:

screenshots/
├── en-US/           # Source (primary locale)
│   ├── phone/
│   │   ├── 1.png
│   │   └── 2.png
│   └── tablet/
│       └── 1.png
├── ko-KR/           # Generated
│   ├── phone/
│   │   ├── 1.png
│   │   └── 2.png
│   └── tablet/
│       └── 1.png
└── ja-JP/           # Generated
    └── ...

#Gemini API Configuration

The localize-screenshots tool requires a Gemini API key.

#Getting a Gemini API Key

1. Go to Google AI Studio
2. Sign in with your Google account
3. Click "Create API Key"
4. Copy the generated API key
5. Important: Link a billing account at Google Cloud Console to enable the Imagen API

#Configuration

Add to ~/.config/pabal-mcp/config.json:

{
  "dataDir": "/path/to/your/project",
  "gemini": {
    "apiKey": "your-gemini-api-key"
  }
}

Alternatively, set the GEMINI_API_KEY environment variable.

#Field Limits Reference

#Apple App Store

#Google Play