Koble Apple Search Ads til Claude eller ChatGPT på fem minutter

Hermoso-koblingen for Apple Search Ads knytter annonsekontoen din til Claude, ChatGPT, Cursor, CLI-en eller vanlig HTTP, slik at en agent kan kjøre App Store-søkeannonsene dine for deg. Den bygger kampanjen, annonsegruppen, søkeordene for målretting og de negative søkeordene, leser tilbake det Apple faktisk lagret, og rapporterer resultatene helt ned til søketermen noen skrev inn før de installerte appen. Alt som opprettes, blir opprettet pauset, og å aktivere forbruk er et eget steg som må bekreftes eksplisitt. Rapporter kan havne i et Google-regneark, en Looker Studio-dashbord eller en JSON-fil, og siden om Apple Ads MCP lister alt koblingen kan gjøre.

Tilkoblingen tar rundt fem minutter. Du trenger ikke kjøre openssl, og ingen Apple-passord havner hos Hermoso.

Koble Apple Search Ads til Claude

For å koble Apple Search Ads til Claude legger du til Hermoso som en kobling i Claude, og kobler deretter Apple Ads-kontoen din til i Hermoso én gang. I Claude åpner du Customize › Connectors › Add custom connector, gir den navnet Hermoso, limer inn https://app.hermoso.ai/mcp og godkjenner med Hermoso-kontoen din. Du trenger ingen nøkkel å lime inn i Claude. Koble deretter til Apple Ads i Hermoso under Innstillinger › Koblinger, etter stegene lenger ned på denne siden. Fra da av kan Claude kalle alle Apple Ads-verktøyene Hermoso har: be om en rapport, en endring av søkeord eller en ny kampanje med vanlige ord. I Claude Code er det to kommandoer i stedet: /plugin marketplace add hermoso-ai/hermoso, og deretter /plugin install hermoso@hermoso. Hermoso i Claude har alle stegene.

Koble Apple Search Ads til ChatGPT

ChatGPT fungerer på samme måte. I ChatGPT åpner du Plugins, deretter Add › Create MCP App, gir den navnet Hermoso, limer inn https://app.hermoso.ai/mcp som Server URL, beholder Authentication på OAuth og godkjenner med Hermoso-kontoen din. Hvis Create MCP App ikke finnes, slår du på Developer mode én gang under Settings › Plugins › Developer mode. Når Apple Ads er koblet til i Hermoso, kan ChatGPT hente søkeordrapporten din, skrive den inn i et Google-regneark eller lage et kampanjeutkast som du kan sjekke. Hermoso i ChatGPT går gjennom det.

Cursor, Codex og andre MCP-klienter

Alle klienter som snakker Model Context Protocol, når de samme verktøyene på samme adresse. Cursor leser https://app.hermoso.ai/mcp fra mcp.json. Codex henter Hermoso-pluginen med codex plugin marketplace add hermoso-ai/hermoso, som kjører de samme verktøyene fra terminalen. Uansett hvilken klient du bruker, går ikke Apple-påloggingen din gjennom chatten. Agenten kaller Hermoso-verktøyene, og Hermoso signerer hver forespørsel til Apple med nøkkelen den har. Siden om Apple Ads MCP lister alle verktøyene.

Hva du kan spørre om når det er koblet til

• “Hent forrige ukes Apple Search Ads-resultater per søkeord, og vis meg de ti med høyest kostnad per installasjon.”
• “Legg forbruk, installasjoner og CPA per kampanje for de siste 30 dagene i et nytt Google-regneark som heter Apple Ads.” (Koble til Google Drive først.)
• “Hvilke søketermer ga installasjoner i US-kampanjen min denne måneden, som jeg ikke byr på som eksakte søkeord ennå?”
• “Legg til ‘budget planner’ og ‘expense tracker’ som eksakte søkeord i Brand-annonsegruppen, og ‘jobs’ som negativt søkeord.”
• “Hvilke søkeord foreslår Apple for appen min, og hvor stor andel av visningene får jeg på dem jeg allerede byr på?”
• “Bygg en pauset kampanje for appen min i Storbritannia med et daglig budsjett på 50 dollar, og vis meg deretter hva Apple lagret.”

Å lese en rapport rører aldri forbruket. Alt agenten bygger, blir opprettet pauset, og bryteren som slår på forbruk venter på din eksplisitte bekreftelse.

Først, det som stopper de fleste

Apples egne instruksjoner sier: “Fra Ads-grensesnittet velger du Account Settings › API. Lim nøkkelen inn i feltet Public Key.”

Det feltet finnes ikke for en Account Admin. Logger du inn som admin på din egen konto og åpner Account Settings › API, vises en tabell med overskriften Manage API Access (en liste over tredjeparts tjenesteleverandører med en enkelt handling, Remove Access), og ingen nøkkelfelt noe sted på siden. Det virker helt som en manglende funksjon, og derfor gir folk opp her og konkluderer med at API-et ikke er tilgjengelig for dem.

Det er tilgjengelig. Public Key-feltet hører til en bruker med en API-rolle, og å være kontoens admin er ikke en slik rolle. Apples invitasjonsdialog tilbyr seks roller, og nøyaktig to av dem er API-roller:

• API Account Manager: lese- og skrivetilgang til alle kampanjegrupper for API-administrasjon. Dette er den du bør velge hvis du vil at Hermoso skal bygge kampanjer, ikke bare rapportere på dem.
• API Account Read Only: skrivebeskyttet tilgang til alle kampanjegrupper for API-administrasjon. Holder for rapportering, og ikke noe mer.

De andre fire (Account Admin, Account Finance, Account Read Only og Limited Access) kan ikke opprette API-legitimasjon i det hele tatt. Løsningen er derfor en invitasjon du sender til deg selv:

1. Åpne Account Settings › User Management og velg Invite Users.
2. Inviter en adresse du kontrollerer (din egen, eller en delt adresse som ads-api@yourcompany.com, slik at legitimasjonen overlever at én person slutter) med rollen API Account Manager.
3. Aksepter invitasjonen fra den innboksen, og logg deretter inn i Apple Ads som den brukeren.

Nå har Account Settings › API et Public Key-felt.

Tilkoblingen, steg for steg

1. Start den i Hermoso. Innstillinger › Koblinger › Apple Ads › Connect. Hermoso lager et EC P-256-signeringsnøkkel (den samme prime256v1-nøkkelen som Apples to openssl-kommandoer ville ha laget) og viser deg bare den offentlige halvdelen. Kopier den.
2. Gi Apple den offentlige halvdelen. Som API-rollebrukeren åpner du Account Settings › API, limer den inn i Public Key og lagrer.
3. Kopier de tre id-ene tilbake. Apple skriver nå ut clientId, teamId og keyId over det feltet. Alle tre.
4. Fullfør i Hermoso. Lim inn de tre id-ene og lagre. Hermoso bytter et token med Apple og leser listen over organisasjonene dine før noe lagres, slik at en feil id feiler der og da, mens du fortsatt kan se det du limte inn, og ikke først ved den første rapporten en time senere.
5. Velg organisasjonen hvis legitimasjonen dekker mer enn én. Tilkoblingen låses til den du velger.

Hvis noe går galt

Det finnes ingen Public Key-felt på API-siden

Du er logget inn som Account Admin, eller som en av de fire ikke-API-rollene. Inviter deg selv som API Account Manager, og logg inn som den brukeren (se over). Dette er den enkeltårsaken som oftest gjør at en Apple Ads-tilkobling aldri blir laget.

Apple avviser legitimasjonen

De tre id-ene må høre til nøkkelen Apple har. Kopier clientId, teamId og keyId på nytt fra rett over Public Key-feltet, ikke fra en eldre nøkkel du har byttet ut. Hvis de fortsatt feiler, starter du tilkoblingen på nytt i Hermoso: det lager et nytt nøkkelpar, og du limer den nye offentlige halvdelen inn i Apple.

Oppsettsøkten har utløpt

Hermoso holder den genererte private nøkkelen i 24 timer mens du går og limer den offentlige halvdelen inn i Apple. Etter det er den borte, med vilje. Start tilkoblingen på nytt og lim inn den nye offentlige nøkkelen.

Jeg har allerede laget en nøkkel med openssl

Da kan du bruke den. Lim inn den eksisterende EC P-256-private nøkkelen når du kobler til, i stedet for å ta Hermoso sin, så fungerer den offentlige nøkkelen som allerede ligger i Apple-kontoen din fortsatt. Den må være en EC P-256 (prime256v1)-nøkkel. Apple godtar ingen andre kurver.

Jeg administrerer flere Apple Ads-organisasjoner

Koble til hver enkelt i sin egen Hermoso-profil. En tilkobling er låst til én organisasjon, og det er det som hindrer at en kampanje for byrået havner i feil kundes konto.

Hva Apple Search Ads-koblingen kan gjøre

Bygge: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object.

Lese: list_apple_ads_campaigns (status, leveringsstatus, dagsbudsjett og totalbudsjett, landene en kampanje kjører i, og Apples egen angitte grunn når en kampanje ikke kan kjøre), list_apple_ads_ad_groups (standardbud, og om Apples Search Match er på), list_apple_ads_keywords (målretting og negative, med matchtype og bud), apple_ads_report (visninger, trykk, installasjoner, forbruk, TTR, CPT og CPA på kampanje-, annonsegruppe-, søkeord-, søketerm- eller annonsenivå) og list_apple_ads_orgs.

Alt dette kan kalles fra Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes eller en annen MCP-klient, og fra webstudioet. Det er samme motor uansett. Se MCP-oversikten eller referansen for annonseverktøy.

Og mer: den bygger kreativer og annonser (create_apple_ads_creative, create_apple_ads_ad), laster opptil 1 000 søkeord i ett kall (bulk_apple_ads_keywords), og leser Apples egne data: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity og apple_ads_change_history. Alle disse kan kalles fra samme chat.

Eksporter data fra Apple Search Ads

Den samme tilkoblingen lager rapporter. apple_ads_report henter kampanje-, annonsegruppe-, annonse-, søkeord- og søketermresultater (visninger, trykk, installasjoner, forbruk, tap-through rate, kostnad per trykk og kostnad per installasjon), enten som totaler eller som en serie per time, dag, uke eller måned, opptil 5 000 rader per side. Å lese en rapport rører aldri forbruket. Hvor radene havner videre, er opp til deg, og de tre vanligste stedene er under. Den fullstendige guiden er Eksporter data fra Apple Search Ads.

Koble Apple Search Ads til Google Sheets

Koble Google Drive til sammen med Apple Ads (én Google-autorisasjon dekker Drive, Sheets og Docs), og be agenten din legge rapporten i et regneark. Den kaller apple_ads_report, og deretter create_sheet for et nytt regneark eller append_to_sheet for å legge til ukens rader i et eksisterende. Hermoso bruker Googles drive.file-tilgang, så den når bare filer den har laget eller du har valgt. Steg for steg: Koble Apple Search Ads til Google Sheets.

Eksporter Apple Search Ads til Looker Studio

Hermoso har ingen innebygd Looker Studio-kobling. Looker Studio leser Google Sheets med sin egen kobling, så regnearket over er broen: legg det til én gang som datakilde for Google Sheets, bygg dashbordet, og hver ukentlige tillegging vises ved neste oppdatering. Power BI og Tableau leser det samme regnearket på samme måte. Stegene for Looker Studio.

Eksporter Apple Search Ads til JSON

For rårader kaller du verktøyet via Hermoso REST API med en API-nøkkel: POST https://app.hermoso.ai/v1/tools/apple_ads_report med rapportargumentene som JSON-body, og leser radene fra data.rows i svaret. Fra terminalen skriver npx -y hermoso call apple_ads_report --json '{...}' --structured ut det samme resultatet som JSON. Et fullstendig eksempel på forespørsel.

Ofte stilte spørsmål

Hvordan kobler jeg Apple Search Ads til Claude?

Legg til Hermoso i Claude som en egendefinert kobling med adressen https://app.hermoso.ai/mcp, og godkjenn med Hermoso-kontoen din. Koble deretter til Apple Ads i Hermoso under Innstillinger › Koblinger. Claude kan da rapportere på, redigere og bygge Apple Search Ads-kampanjene dine gjennom Hermosos Apple Ads-verktøy.

Kan ChatGPT lese Apple Search Ads-dataene mine?

Ja. Legg til https://app.hermoso.ai/mcp i ChatGPT under Plugins › Add › Create MCP App, og koble til Apple Ads i Hermoso. ChatGPT kan da hente visninger, trykk, installasjoner, forbruk, TTR, CPT og CPA per kampanje, annonsegruppe, annonse, søkeord eller søketerm, og skrive radene inn i et Google-regneark.

Finnes det en MCP-server for Apple Search Ads?

Ja. Hermoso sin hostede MCP-server på https://app.hermoso.ai/mcp gir hele Apple Ads-verktøysettet til Claude, ChatGPT, Cursor, Codex eller en annen MCP-klient: rapportering, kampanjer, annonsegrupper, søkeord og negative søkeord, kreativer og annonser, og Apples søkeordforslag. Alt den bygger, blir opprettet pauset.

Hvorfor finnes det ikke noe Public Key-felt på Apple Ads API-siden?

Fordi du er logget inn som Account Admin. Apple viser bare det feltet til en bruker med en API-rolle. En admin ser i stedet en tabell med overskriften “Manage API Access” med tredjeparts tjenesteleverandører, uten nøkkelfelt noe sted på siden. Inviter deg selv som API Account Manager under Account Settings › User Management, logg inn som den brukeren, så er feltet der.

Hvilken Apple Ads-rolle trenger jeg?

API Account Manager hvis du vil at Hermoso skal bygge kampanjer, annonsegrupper og søkeord. Apple beskriver den som “read and write access to all campaign groups for API management”. API Account Read Only holder hvis du bare vil ha rapportering. De andre fire rollene Apple tilbyr (Account Admin, Account Finance, Account Read Only og Limited Access) kan ikke opprette API-legitimasjon i det hele tatt.

Må jeg kjøre openssl?

Nei. Apples egne instruksjoner gir deg to openssl-kommandoer. Hermoso lager EC P-256-nøkkelparet for deg og viser deg bare den offentlige halvdelen. Den private halvdelen er det som signerer forespørslene dine, og du ser den aldri, limer den aldri inn og lagrer den aldri. Har du allerede en nøkkel fra et annet verktøy, kan du ta den med i stedet.

Koster det noe å koble til Apple Ads, eller risikerer jeg forbruk?

Nei. Lesing er gratis å kalle, og alt Hermoso oppretter, blir opprettet PAUSET uten mulighet for overstyring. Å aktivere et objekt er den eneste bryteren som slår på reelt forbruk, og den krever en eksplisitt bekreftelse.

Hva er clientId, teamId og keyId?

De tre identifikatorene Apple skriver ut over Public Key-feltet når du har lagret nøkkelen din. De identifiserer API-brukeren din overfor Apple; den private nøkkelen beviser at det er deg. Lim alle tre tilbake i Hermoso, så er tilkoblingen ferdig.

Kan én tilkobling dekke flere Apple Ads-organisasjoner?

En tilkobling er låst til den ene organisasjonen du velger når du lager den. Apple behandler en orgId litt som en kampanjegruppe, så én innlogging kan dekke flere. Et byrå med én organisasjon per kunde kobler til hver enkelt i sin egen Hermoso-profil.

Må jeg rotere nøkkelen hvert 180. dag?

Nei. Apple begrenser en klienthemmelighet til 180 dager, og det er derfor Apples egne instruksjoner får deg til å notere en rotasjon i kalenderen. Hermoso holder den private nøkkelen og lager en ny kortlivet hemmelighet for hver tokenutveksling, så det er ingenting i en konfigurasjonsfil som kan utløpe.

Kan jeg eksportere Apple Search Ads-data til Google Sheets eller Looker Studio?

Ja. Koble til Google Drive ved siden av Apple Ads, så skriver agenten rapporten inn i et Google-regneark med create_sheet eller append_to_sheet. Hermoso har ingen innebygd Looker Studio-kobling. Looker Studio leser regnearket med sin egen Google Sheets-kobling.

Kan jeg få Apple Search Ads-data som JSON?

Ja. Kall POST /v1/tools/apple_ads_report på Hermosos API med en API-nøkkel og les data.rows, eller kjør hermoso call apple_ads_report med --structured fra CLI-en.