# Appstore Pricing Planner

> App Store subscription and IAP pricing by territory with `asc`, including price points, PPP/localized CSV imports, availability, summaries, and schedules; mutating actions require confirmation.

- Skill: `xopoko/appstore-pricing-planner` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add xopoko/appstore-pricing-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xopoko/appstore-pricing-planner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: Xopoko (https://skillmd.com/u/xopoko)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xopoko/appstore-pricing-planner

---


# App Store Pricing Planner

Use current `asc` pricing families to inspect, dry-run, apply, and verify regional subscription/IAP prices.

## Preconditions

- `asc auth login` or `ASC_*`.
- App/product IDs resolved; pass `--app` or use `ASC_APP_ID`.
- Base territory chosen, usually `USA`.
- Run `asc pricing territories list --paginate` if territory IDs are unknown.

## Command Plan Helper

For a deterministic command plan, run the helper from the plugin root:

```bash
python3 "$PLUGIN_ROOT/skills/appstore-pricing-planner/scripts/pricing_plan.py" \
  --subscription-id "SUB_ID" --territory "USA" \
  --include-subscription-import --prices-csv "./ppp-prices.csv"
```

The helper prints commands only; it does not call ASC, import CSV data, or change prices. Commands that create products, apply imports, set prices, edit availability, or create schedules require `--confirming-actions`. Pass `--json` for machine-readable output.

## Workflow

1. Resolve app, subscription, IAP, territory, and price point IDs before planning mutations.
2. Inspect summaries and price lists first, especially the base territory and high-revenue localized territories.
3. For PPP or regional bulk changes, prepare CSV with required `territory` and `price`; optional fields include `currency_code`, `start_date`, `preserved`, `preserve_current_price`, and `price_point_id`.
4. Dry-run broad subscription CSV imports before applying.
5. Verify summaries after applying important price, schedule, or availability changes.
6. Expect propagation delay in App Store Connect/storefronts. Older `asc subscriptions prices ...` paths may exist, but the `pricing` family is canonical.

## References

- `references/appstore-pricing-planner.md` for detailed subscription setup, IAP setup, CSV import, manual override, availability, and schedule commands.