AustineA/app-landing-seo

# App Landing Page SEO

End-to-end workflow for turning an app's store listing into a high-converting, SEO-optimized landing site with long-tail guide pages. Default stack: **Vite + React with build-time prerendering** (architecture in Phase 3). If the repo already has a web framework (Next.js, Astro), build inside that instead and adapt the output paths. Every phase ends with verification.

This skill depends on the separately installed **`gpt-image`** skill included in the same repository. When guide images are needed, load that skill and follow its instructions. Do not assume its helper lives inside this skill's directory.

## Phase 1 — Pull the store listing (source of truth)

1. Fetch full metadata from the iTunes lookup API (no auth needed):
   ```bash
   curl -s "https://itunes.apple.com/lookup?id=<APP_ID>&country=us"
   ```
   Extract: name, bundleId, description, price/IAP terms, genres, rating count, screenshots, icon, version, seller. Check for a Google Play listing too (`play.google.com/store/apps/details?id=<bundleId>`) — don't assume iOS-only.

# GPT Image

Generate images with OpenAI's `gpt-image-2` Images API through this skill's bundled helper.

## Setup

- Prefer `uv`; the script declares its `openai` dependency inline.
- Otherwise install `openai` with `python3 -m pip install -r requirements.txt` from this skill directory.
- Require `GPT_API_KEY` or `OPENAI_API_KEY` in the environment.
- Resolve `GPT_IMAGE_SKILL_DIR` to the directory containing this `SKILL.md`. Run the helper as `"$GPT_IMAGE_SKILL_DIR/scripts/generate_image.py"` so it works from any project directory.

## Generate

```bash