Asc apple ads

Skill rorkai/app-store-connect-cli-skills/skills/asc-apple-ads

Use when managing Apple Ads with asc, including auth, org lookup, campaigns, ad groups, ads, keywords, reports, raw API calls, and safe live testing.From its SKILL.md

Install

npx -y skills add rorkai/app-store-connect-cli-skills --skill asc-apple-ads

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

reads credentialsReads from 6 credential sources: `ASC_ADS_CLIENT_ID` and 5 more.
runs commandsInstructs the agent to run 7 commands, including `asc ads --help` and 6 more.

SKILL.md

4.7 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

asc Apple Ads

Use this skill when a task involves Apple Ads or asc ads.

Ground Rules

Run asc ads --help or the specific subgroup help before scripting a command.
Apple Ads auth is separate from App Store Connect auth. asc auth login does not configure asc ads.
Use JSON output for automation: --output json.
Most commands need an org ID. Prefer --org for one-off commands and ASC_ADS_ORG_ID for a scoped session.
Never guess payload fields. Use Apple Ads request JSON in a file and pass it with --file.
Do not mutate a live account until the user has named the org and approved the resource type. Prefer read-only checks first.

Auth

Stored profile:

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

Environment auth:

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"

Short-lived token auth:

export ASC_ADS_ACCESS_TOKEN="ACCESS_TOKEN"
export ASC_ADS_ORG_ID="123456"

Useful checks:

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 Resolution

When the org ID is unknown:

asc ads acls --output json

Use the returned org ID:

asc ads campaigns --org "123456" --limit 10 --output json

Org precedence is --org, ASC_ADS_ORG_ID, stored profile org_id, then config ads.org_id.

Read Workflows

Campaigns and ad groups:

asc ads campaigns --org "123456" --limit 100 --output json
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

Discovery:

asc ads apps search --org "123456" --query "My App" --limit 10 --output json
asc ads product-pages list --org "123456" --adam-id 1234567890 --states VISIBLE --output json
asc ads creatives list --org "123456" --limit 100 --output json
asc ads geo search --org "123456" --query "San Francisco" --country-code US --limit 10 --output json

Reports:

asc ads reports campaigns --org "123456" --file reporting-request.json --output json
asc ads reports keywords --org "123456" --campaign 987654321 --file reporting-request.json --output json

Reporting and find endpoints keep pagination in the JSON body.

Mutating Workflows

Create and update commands take Apple Ads JSON files:

asc ads campaigns create --org "123456" --file campaign.json --output json
asc ads campaigns update --org "123456" --campaign 987654321 --file campaign-update.json --output json
asc ads ad-groups create --org "123456" --campaign 987654321 --file ad-group.json --output json

Bulk endpoints often require arrays:

asc ads targeting-keywords create-bulk \
  --org "123456" \
  --campaign 987654321 \
  --ad-group 123456789 \
  --file keywords.json \
  --output json

Delete commands require --confirm:

asc ads targeting-keywords delete-bulk \
  --org "123456" \
  --campaign 987654321 \
  --ad-group 123456789 \
  --file keyword-ids.json \
  --confirm \
  --output json

asc ads campaigns delete --org "123456" --campaign 987654321 --confirm

For live tests, create paused resources with names such as ASC CLI Live Test <timestamp>. Clean up only the parent campaign or ad group created for that test. Apple may reject direct deletion for default product page creative ads, but deleting the test parent campaign or ad group can clean up the test resource.

Raw API

Use raw requests when Apple adds a field before the first-class command surface changes:

asc ads api request \
  --method POST \
  --path v5/campaigns/find \
  --org "123456" \
  --file selector.json \
  --output json

Raw requests accept only Apple Ads v5 paths or https://api.searchads.apple.com/api/v5/... URLs. DELETE still requires --confirm.

Live Test Checklist

Start with asc ads me view --output json and asc ads acls --output json.
Print the target org ID before mutations.
Create paused or future-dated resources.
Use a unique test name.
Save created IDs from JSON output.
Delete only the test parent campaign or ad group created during the run.
Run a final campaigns find/list query to confirm cleanup.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most marketing audience skills give in ~1.2k tokens

Counted across 690 of the 894 authors here whose files we hold, read 2026-08-07

Apply Poppins font to headingsin 41 of 690, across 6 files
Apply Lora font to body textin 41 of 690, across 6 files
Use Arial fallback for headingsin 39 of 690, across 4 files
Use Georgia fallback for body textin 39 of 690, across 4 files
Maintain text hierarchy and formattingin 39 of 690, across 4 files
Use accent colors for non-text shapesin 38 of 690, across 3 files
Use RGB values for precise color matchingin 38 of 690, across 3 files
Use brand colors for primary text and backgroundsin 36 of 690, across 1 file
Read product marketing context file before asking questions, starting, or auditingin 35 of 690, across 23 files
Use active voice instead of passive voicein 26 of 690, across 10 files
Implement or generate appropriate JSON-LD structured datain 24 of 690, across 17 files
Prioritize clarity over clevernessin 22 of 690, across 8 files

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.