appstore-ads-operatorlisted
Install: claude install-skill Xopoko/plug-n-skills
# App Store Ads Operator
Apple Ads auth is separate from App Store Connect auth. Start read-only and require approval before live mutations.
## Ground Rules
- Check `asc ads --help` or subgroup help before scripting.
- Use `--output json` for automation.
- Most commands need an org ID; prefer `--org`, or set `ASC_ADS_ORG_ID`.
- Never guess payload fields. Put Apple Ads JSON in files and pass `--file`.
- Do not mutate until the user names the org and approves the resource type.
## Auth And Org
```bash
asc ads auth login --name "Marketing" --client-id "$ASC_ADS_CLIENT_ID" \
--team-id "$ASC_ADS_TEAM_ID" --key-id "$ASC_ADS_KEY_ID" \
--private-key "$ASC_ADS_PRIVATE_KEY_PATH" --org "$ASC_ADS_ORG_ID" --network
export ASC_ADS_CLIENT_ID="SEARCHADS_CLIENT_ID"
export ASC_ADS_TEAM_ID="SEARCHADS_TEAM_ID"
export ASC_ADS_KEY_ID="KEY_ID"
export ASC_ADS_PRIVATE_KEY_PATH="$HOME/.asc/apple-ads-private-key.pem"
export ASC_ADS_ORG_ID="123456"
asc ads auth status --validate --output json
asc ads auth doctor --output json
asc ads me view --output json
asc ads acls --output json
```
Org precedence: `--org`, `ASC_ADS_ORG_ID`, stored profile `org_id`, config `ads.org_id`.
## Reads
```bash
asc ads campaigns --org "123456" --paginate --output json
asc ads campaigns view --org "123456" --campaign 987654321 --output json
asc ads ad-groups list --org "123456" --campaign 987654321 --output json
asc ads apps search --org "123456" --query "My App" --limit 10 --output json
asc ads product-pages l