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

Hermoso-forbindelsen til Apple Search Ads kobler din Apple Ads-konto til Claude, ChatGPT, Cursor, CLI'en eller almindelig HTTP, så en agent kan køre dine App Store-søgeannoncer for dig. Den bygger kampagnen, annoncegruppen, søgeordene til målretning og de negative søgeord, læser tilbage det Apple faktisk har gemt, og rapporterer resultater helt ned til det søgeord, som nogen skrev, før de installerede appen. Alt det opretter, oprettes på pause, og at aktivere forbrug er et separat trin, som skal bekræftes eksplicit. Rapporter kan havne i et Google Sheet, et Looker Studio-dashboard eller en JSON-fil, og siden om Apple Ads MCP viser alt, forbindelsen kan.

Forbindelsen tager cirka fem minutter. Du skal ikke køre openssl, og din Apple-adgangskode kommer aldrig i nærheden af Hermoso.

Forbind Apple Search Ads til Claude

Sådan forbinder du Apple Search Ads til Claude: tilføj Hermoso til Claude som en connector, og forbind derefter din Apple Ads-konto i Hermoso én gang. I Claude åbner du Customize › Connectors › Add custom connector, giver den navnet Hermoso, indsætter https://app.hermoso.ai/mcp og godkender den med din Hermoso-konto. Der er ingen nøgle at indsætte i Claude. Forbind derefter Apple Ads i Hermoso under Indstillinger › Forbindelser, med trinene længere nede på siden. Fra da af kan Claude kalde alle de Apple Ads-værktøjer, Hermoso har: bed om en rapport, en ændring af et søgeord eller en ny kampagne med almindelige ord. I Claude Code er det i stedet to kommandoer: /plugin marketplace add hermoso-ai/hermoso, og derefter /plugin install hermoso@hermoso. Hermoso i Claude har alle trinene.

Forbind Apple Search Ads til ChatGPT

ChatGPT virker på samme måde. Åbn Plugins i ChatGPT, og vælg derefter Add › Create MCP App, giv den navnet Hermoso, og indsæt https://app.hermoso.ai/mcp som Server URL. Lad Authentication stå på OAuth, og godkend med din Hermoso-konto. Hvis Create MCP App ikke findes, skal du slå Developer mode til én gang under Settings › Plugins › Developer mode. Når Apple Ads er forbundet i Hermoso, kan ChatGPT hente din søgeordsrapport, skrive den ind i et Google Sheet eller lave et kampagneudkast, som du selv kan tjekke. Hermoso i ChatGPT gennemgår det trin for trin.

Cursor, Codex og enhver anden MCP-klient

Enhver klient, der taler Model Context Protocol, når de samme værktøjer på den samme adresse. Cursor læser https://app.hermoso.ai/mcp fra sin mcp.json. Codex får Hermoso-pluginnet med codex plugin marketplace add hermoso-ai/hermoso, og det kører de samme værktøjer fra terminalen. Uanset klient går dine Apple-legitimationsoplysninger aldrig gennem chatten. Agenten kalder Hermosos værktøjer, og Hermoso signerer hver forespørgsel til Apple med den nøgle, den selv har. Siden om Apple Ads MCP viser hvert værktøj.

Hvad du kan spørge om, når det er forbundet

• “Hent sidste uges Apple Search Ads-resultater pr. søgeord, og vis mig de ti med de højeste omkostninger pr. erhvervelse.”
• “Læg de sidste 30 dages forbrug, installationer og CPA pr. kampagne i et nyt Google Sheet, der hedder Apple Ads.” (Forbind Google Drive først.)
• “Hvilke søgetermer gav installationer i min amerikanske kampagne denne måned, som jeg endnu ikke byder på som eksakte søgeord?”
• “Tilføj ‘budget planner’ og ‘expense tracker’ som eksakte søgeord i annoncegruppen Brand, og ‘jobs’ som negativt søgeord.”
• “Hvilke søgeord foreslår Apple til min app, og hvor stor en del af visningerne får jeg på dem, jeg allerede byder på?”
• “Byg en kampagne til min app i Storbritannien på pause med et dagligt budget på 50 dollars, og vis mig derefter, hvad Apple har gemt.”

Læsning af en rapport rører aldrig forbruget. Alt agenten bygger, oprettes på pause, og kontakten, der tænder for forbruget, venter på din eksplicitte bekræftelse.

Først det, der stopper de fleste

Apples egne instruktioner siger: “Vælg Account Settings › API i Ads-brugerfladen. Indsæt nøglen i feltet Public Key.”

Det felt findes ikke for en Account Admin. Log ind som admin på din egen konto, åbn Account Settings › API, og det, der vises, er en tabel med overskriften Manage API Access (en liste over tredjepartsudbydere med en enkelt handling, Remove Access) og intet nøglefelt nogen steder på siden. Det ligner præcis en manglende funktion, og det er derfor, folk stopper her og konkluderer, at API'et ikke er tilgængeligt for dem.

Det er det. Feltet Public Key hører til en bruger med en API-rolle, og at være kontoens admin er ikke en API-rolle. Apples invitationsdialog tilbyder seks roller, og præcis to af dem er API-roller:

• API Account Manager: “adgang til at læse og skrive alle kampagnegrupper til API-administration”. Den skal du vælge, hvis du vil have Hermoso til at bygge kampagner og ikke kun rapportere.
• API Account Read Only: “kun læseadgang til alle kampagnegrupper til API-administration”. Nok til rapportering og intet andet.

De fire andre (Account Admin, Account Finance, Account Read Only og Limited Access) kan slet ikke oprette API-legitimationsoplysninger. Løsningen er derfor en invitation, du sender til dig selv:

1. Åbn Account Settings › User Management, og vælg Invite Users.
2. Inviter en adresse, du selv kontrollerer (din egen, eller en fælles som ads-api@yourcompany.com, så legitimationsoplysningerne overlever en enkelt person), med rollen API Account Manager.
3. Accepter invitationen fra den indbakke, og log derefter ind på Apple Ads som den bruger.

Nu har Account Settings › API et felt til Public Key.

Forbindelsen, trin for trin

1. Start den i Hermoso. Indstillinger › Forbindelser › Apple Ads › Connect. Hermoso genererer en EC P-256-signeringsnøgle (den samme prime256v1-nøgle, som Apples to openssl-kommandoer ville have lavet) og viser dig kun den offentlige halvdel. Kopiér den.
2. Giv Apple den offentlige halvdel. Som din bruger med API-rolle åbner du Account Settings › API, indsætter nøglen i Public Key og klikker Save.
3. Kopiér de tre id'er tilbage. Apple viser nu clientId, teamId og keyId over det felt. Alle tre.
4. Afslut i Hermoso. Indsæt de tre id'er og gem. Hermoso udveksler et token med Apple og læser din organisationsliste, før den gemmer noget. Så fejler et forkert indtastet id lige der, mens du stadig kan se, hvad du indsatte, og ikke først ved din første rapport en time senere.
5. Vælg organisationen, hvis dine legitimationsoplysninger dækker mere end én. Forbindelsen låses til den, du vælger.

Hvis noget går galt

Der er intet Public Key-felt på API-siden

Du er logget ind som Account Admin, eller som en af de fire roller uden API-adgang. Invitér dig selv som API Account Manager, og log ind som den bruger (se ovenfor). Det er den enkeltstående hyppigste grund til, at en Apple Ads-forbindelse aldrig bliver oprettet.

Apple afviser legitimationsoplysningerne

De tre id'er skal høre til den nøgle, Apple har. Kopiér clientId, teamId og keyId igen fra lige over Public Key-feltet, ikke fra en ældre nøgle, du har erstattet. Hvis de stadig fejler, så start forbindelsen forfra i Hermoso. Det laver et nyt nøglepar, og du indsætter den nye offentlige halvdel i Apple.

Opsætningssessionen er udløbet

Hermoso gemmer den genererede private nøgle i 24 timer, mens du går hen og indsætter dens offentlige halvdel i Apple. Efter det er den væk, med vilje. Start forbindelsen forfra, og indsæt den nye offentlige nøgle.

Jeg har allerede lavet en nøgle med openssl

Så brug den. Indsæt din eksisterende EC P-256-private nøgle, når du forbinder, i stedet for Hermosos. Den offentlige nøgle, der allerede ligger på din Apple-konto, virker fortsat. Det skal være en EC P-256-nøgle (prime256v1). Apple accepterer ingen anden kurve.

Jeg administrerer flere Apple Ads-organisationer

Forbind hver enkelt i sin egen Hermoso-profil. En forbindelse er låst til én organisation, og det er det, der forhindrer, at en agenturkampagne havner i den forkerte kundes konto.

Hvad Apple Search Ads-forbindelsen kan

Byg: 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.

Læs: list_apple_ads_campaigns (status, leveringsstatus, dagligt og samlet budget, de lande en kampagne kører i, og Apples egen angivne grund, når en kampagne ikke kan køre), list_apple_ads_ad_groups (standardbud, og om Apples Search Match er slået til), list_apple_ads_keywords (målretning og negative, med matchtype og bud), apple_ads_report (visninger, tryk, installationer, forbrug, TTR, CPT og CPA på kampagne-, annoncegruppe-, søgeords-, søgetermer- eller annonceniveau) og list_apple_ads_orgs.

Alt det kan kaldes fra Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes eller enhver anden MCP-klient og fra webstudiet. Det er den samme motor begge veje. Se MCP-oversigten eller referencen for annonceværktøjer.

Og mere: den bygger kreativer og annoncer (create_apple_ads_creative, create_apple_ads_ad), indlæser op til 1.000 søgeord i ét kald (bulk_apple_ads_keywords) og læser Apples egne data: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity og apple_ads_change_history. Alle dem kan kaldes fra den samme chat.

Eksportér data fra Apple Search Ads

Den samme forbindelse laver rapporter. apple_ads_report henter resultater for kampagner, annoncegrupper, annoncer, søgeord og søgetermer (visninger, tryk, installationer, forbrug, tap-through rate, omkostning pr. tryk og omkostning pr. erhvervelse), enten som totaler eller som en serie pr. time, dag, uge eller måned, op til 5.000 rækker pr. side. Læsning af en rapport rører aldrig forbruget. Hvor rækkerne ender bagefter, er op til dig, og de tre mest almindelige steder står nedenfor. Den fulde guide er Eksportér data fra Apple Search Ads.

Forbind Apple Search Ads til Google Sheets

Forbind Google Drive ved siden af Apple Ads (én Google-godkendelse dækker Drive, Sheets og Docs), og bed din agent om at lægge rapporten i et ark. Den kalder apple_ads_report og derefter create_sheet for et nyt regneark eller append_to_sheet for at tilføje denne uges rækker til et eksisterende ark. Hermoso bruger Googles drive.file-scope, så det kun når filer, det selv har oprettet, eller som du har valgt. Trin for trin: Forbind Apple Search Ads til Google Sheets.

Eksportér Apple Search Ads til Looker Studio

Hermoso har ingen indbygget Looker Studio-connector. Looker Studio læser Google Sheets med sin egen connector, så arket ovenfor er broen: tilføj det én gang som datakilde af typen Google Sheets, byg dashboardet, og hver ugentlig tilføjelse dukker op ved næste opdatering. Power BI og Tableau læser det samme ark på samme måde. Trinene til Looker Studio.

Eksportér Apple Search Ads til JSON

Har du brug for rå rækker, kalder du værktøjet via Hermoso REST API med en API-nøgle: POST https://app.hermoso.ai/v1/tools/apple_ads_report med rapportargumenterne som JSON-body, og du læser rækkerne fra data.rows i svaret. Fra en terminal giver npx -y hermoso call apple_ads_report --json '{...}' --structured det samme resultat som JSON. Et komplet eksempel på et kald.

Ofte stillede spørgsmål

Hvordan forbinder jeg Apple Search Ads til Claude?

Tilføj Hermoso til Claude som en brugerdefineret connector med URL'en https://app.hermoso.ai/mcp, og godkend med din Hermoso-konto. Forbind derefter Apple Ads i Hermoso under Indstillinger › Forbindelser. Claude kan så lave rapporter om, redigere og bygge dine Apple Search Ads-kampagner via Hermosos Apple Ads-værktøjer.

Kan ChatGPT læse mine Apple Search Ads-data?

Ja. Tilføj https://app.hermoso.ai/mcp i ChatGPT under Plugins › Add › Create MCP App, og forbind Apple Ads i Hermoso. ChatGPT kan så hente visninger, tryk, installationer, forbrug, TTR, CPT og CPA pr. kampagne, annoncegruppe, annonce, søgeord eller søgeterm, og skrive rækkerne ind i et Google Sheet.

Findes der en Apple Search Ads MCP-server?

Ja. Hermosos hostede MCP-server på https://app.hermoso.ai/mcp giver Claude, ChatGPT, Cursor, Codex eller enhver MCP-klient hele Apple Ads-værktøjssættet: rapportering, kampagner, annoncegrupper, søgeord og negative søgeord, kreativer og annoncer samt Apples søgeordsforslag. Alt, der bygges, oprettes på pause.

Hvorfor findes der intet Public Key-felt på Apple Ads API-siden?

Fordi du er logget ind som Account Admin. Apple viser kun det felt for en bruger med en API-rolle. En admin ser i stedet en tabel “Manage API Access” med tredjepartsudbydere, uden nøglefelt nogen steder på siden. Invitér dig selv som API Account Manager under Account Settings › User Management, log ind som den bruger, så er feltet der.

Hvilken Apple Ads-rolle skal jeg bruge?

API Account Manager, hvis du vil have Hermoso til at bygge kampagner, annoncegrupper og søgeord. Apple beskriver den som “adgang til at læse og skrive alle kampagnegrupper til API-administration”. API Account Read Only er nok, hvis du kun vil have rapportering. De andre fire roller, Apple tilbyder (Account Admin, Account Finance, Account Read Only og Limited Access), kan slet ikke oprette API-legitimationsoplysninger.

Skal jeg køre openssl?

Nej. Apples egne instruktioner giver dig to openssl-kommandoer. Hermoso genererer EC P-256-nøgleparret for dig og viser dig kun den offentlige halvdel. Den private halvdel er den, der signerer dine forespørgsler, og den ser, indsætter eller gemmer du aldrig. Har du allerede en nøgle fra et andet værktøj, kan du medbringe den i stedet.

Koster det noget at forbinde Apple Ads, eller risikerer jeg forbrug?

Nej. Læsninger er gratis at kalde, og alt, Hermoso opretter, oprettes PAUSET uden undtagelse. At aktivere et objekt er den eneste kontakt, der tænder for rigtigt forbrug, og den kræver en eksplicit bekræftelse.

Hvad er clientId, teamId og keyId?

De tre identifikatorer, Apple viser over feltet Public Key, når du har gemt din nøgle. De identificerer din API-bruger over for Apple; den private nøgle beviser, at det er dig. Indsæt alle tre i Hermoso, så er forbindelsen klar.

Kan én forbindelse dække flere Apple Ads-organisationer?

En forbindelse er låst til den ene organisation, du vælger, når du opretter den. Apple behandler et orgId lidt som en kampagnegruppe, så ét login kan dække flere. Et bureau med en kunde pr. organisation forbinder hver enkelt i sin egen Hermoso-profil.

Skal jeg fornye nøglen hvert 180. dag?

Nej. Apple begrænser en klienthemmelighed til 180 dage, og det er grunden til, at Apples egne instruktioner får dig til at huske en fornyelse. Hermoso holder den private nøgle og laver en frisk, kortlivet hemmelighed til hver tokenudveksling, så der er intet i en konfigurationsfil, der kan udløbe.

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

Ja. Forbind Google Drive ved siden af Apple Ads, og din agent skriver rapporten ind i et Google Sheet med create_sheet eller append_to_sheet. Hermoso har ingen indbygget Looker Studio-connector. Looker Studio læser arket med sin egen Google Sheets-connector.

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

Ja. Kald POST /v1/tools/apple_ads_report på Hermoso API med en API-nøgle og læs data.rows, eller kør hermoso call apple_ads_report med --structured fra CLI'en.