Anslut Apple Search Ads till Claude eller ChatGPT på fem minuter

Hermoso-anslutningen för Apple Search Ads kopplar ditt Apple Ads-konto till Claude, ChatGPT, Cursor, CLI:t eller vanlig HTTP, så att en agent kan köra dina App Store-sökannonser åt dig. Den bygger kampanjen, annonsgruppen, sökordsinriktningen och de negativa sökorden, läser tillbaka det Apple faktiskt sparade och rapporterar resultatet ända ner till sökordet som någon skrev innan de installerade appen. Allt som skapas skapas pausat, och att aktivera utgifter är ett eget steg som du uttryckligen bekräftar. Rapporter kan landa i ett Google Sheets-kalkylark, en Looker Studio-instrumentpanel eller en JSON-fil, och sidan för Apple Ads MCP listar allt som anslutningen kan göra.

Anslutningen tar ungefär fem minuter. Du kommer inte att köra openssl, och inget Apple-lösenord hamnar hos Hermoso.

Anslut Apple Search Ads till Claude

För att ansluta Apple Search Ads till Claude lägger du till Hermoso som en kontakt i Claude och kopplar sedan ditt Apple Ads-konto i Hermoso en gång. I Claude öppnar du Customize › Connectors › Add custom connector, namnger den Hermoso, klistrar in https://app.hermoso.ai/mcp och godkänner med ditt Hermoso-konto. Du behöver ingen nyckel i Claude. Koppla sedan Apple Ads i Hermoso under Inställningar › Anslutningar, med stegen längre ned på den här sidan. Från och med då kan Claude anropa varje Apple Ads-verktyg som Hermoso har: be om en rapport, en sökordsändring eller en ny kampanj med vanliga ord. I Claude Code är det i stället två kommandon: /plugin marketplace add hermoso-ai/hermoso och sedan /plugin install hermoso@hermoso. Hermoso i Claude har hela stegen.

Anslut Apple Search Ads till ChatGPT

ChatGPT fungerar på samma sätt. I ChatGPT öppnar du Plugins, sedan Add › Create MCP App, namnger den Hermoso, klistrar in https://app.hermoso.ai/mcp som Server URL, behåller Authentication på OAuth och godkänner med ditt Hermoso-konto. Om Create MCP App inte finns där slår du på Developer mode en gång under Settings › Plugins › Developer mode. När Apple Ads är anslutet i Hermoso kan ChatGPT hämta din sökordsrapport, skriva den till ett Google Sheets-kalkylark eller ta fram ett utkast till en kampanj som du granskar. Hermoso i ChatGPT går igenom stegen.

Cursor, Codex och alla andra MCP-klienter

Alla klienter som talar Model Context Protocol når samma verktyg på samma adress. Cursor läser https://app.hermoso.ai/mcp från sin mcp.json; Codex tar Hermoso-pluginet med codex plugin marketplace add hermoso-ai/hermoso, som kör samma verktyg från terminalen. Oavsett vilken klient du använder går dina Apple-uppgifter aldrig genom chatten. Agenten anropar Hermosos verktyg, och Hermoso signerar varje förfrågan till Apple med nyckeln den har. Sidan för Apple Ads MCP listar varje verktyg.

Vad du kan fråga när det är anslutet

• “Hämta förra veckans Apple Search Ads-resultat per sökord och visa de tio med högst CPA.”
• “Lägg de senaste 30 dagarnas utgifter, installationer och CPA per kampanj i ett nytt Google Sheets-kalkylark som heter Apple Ads.” (Anslut Google Drive först.)
• “Vilka sökterm gav installationer i min amerikanska kampanj den här månaden som jag ännu inte budar på som exakta sökord?”
• “Lägg till ‘budget planner’ och ‘expense tracker’ som exakta sökord i annonsgruppen Brand, och ‘jobs’ som negativt sökord.”
• “Vilka sökord föreslår Apple för min app, och hur stor andel av visningarna får jag på de sökord jag redan budar på?”
• “Bygg en pausad kampanj för min app i Storbritannien med en daglig budget på 50 dollar, och visa sedan vad Apple sparade.”

Att läsa en rapport rör aldrig utgifterna. Allt agenten bygger skapas pausat, och omkopplaren som startar utgifterna väntar på din uttryckliga bekräftelse.

Först, det som stoppar de flesta

Apples egna anvisningar säger: “Från annonsgränssnittet väljer du Account Settings › API. Klistra in nyckeln i fältet Public Key.”

Det fältet finns inte för en Account Admin. Logga in som administratör på ditt eget konto, öppna Account Settings › API, och det som visas är en tabell med rubriken Manage API Access (en lista över tredjepartsleverantörer med en enda åtgärd, Remove Access) och inget nyckelfält någonstans på sidan. Det ser precis ut som en saknad funktion, vilket är anledningen till att folk stannar här och drar slutsatsen att API:t inte är tillgängligt för dem.

Det är tillgängligt. Fältet Public Key tillhör en användare med en API-roll, och att vara kontots administratör är inte en sådan. Apples inbjudningsdialog erbjuder sex roller, av vilka exakt två är API-roller:

• API Account Manager: “läs- och skrivåtkomst till alla kampanjgrupper för API-hantering”. Den här väljer du om du vill att Hermoso ska bygga kampanjer, inte bara rapportera om dem.
• API Account Read Only: “endast läsåtkomst till alla kampanjgrupper för API-hantering”. Räcker för rapportering, och inget annat.

De övriga fyra (Account Admin, Account Finance, Account Read Only och Limited Access) kan inte skapa API-uppgifter alls. Lösningen är alltså en inbjudan som du skickar till dig själv:

1. Öppna Account Settings › User Management och välj Invite Users.
2. Bjud in en adress du kontrollerar (din egen, eller en delad som ads-api@yourcompany.com så att uppgifterna lever kvar oberoende av en enskild person) med rollen API Account Manager.
3. Acceptera inbjudan från den inkorgen och logga sedan in på Apple Ads som den användaren.

Nu finns ett fält Public Key under Account Settings › API.

Anslutningen, steg för steg

1. Starta den i Hermoso. Inställningar › Anslutningar › Apple Ads › Connect. Hermoso genererar en EC P-256-signeringsnyckel (samma prime256v1-nyckel som Apples två openssl-kommandon hade skapat) och visar dig bara den publika halvan. Kopiera den.
2. Ge Apple den publika halvan. Som användaren med API-roll öppnar du Account Settings › API, klistrar in den i Public Key och sparar.
3. Kopiera tillbaka de tre id:na. Apple skriver nu ut clientId, teamId och keyId ovanför det fältet. Alla tre.
4. Slutför i Hermoso. Klistra in de tre id:na och spara. Hermoso växlar en token med Apple och läser din organisationslista innan något lagras, så ett felskrivet id misslyckas direkt, medan du fortfarande kan se vad du klistrade in, och inte först vid din första rapport en timme senare.
5. Välj organisation, om dina uppgifter täcker fler än en. Anslutningen låses till den du väljer.

Om något går fel

Det finns inget fält Public Key på API-sidan

Du är inloggad som Account Admin, eller som någon av de fyra icke-API-rollerna. Bjud in dig själv som API Account Manager och logga in som den användaren (se ovan). Det här är den enskilt vanligaste orsaken till att en Apple Ads-anslutning aldrig blir av.

Apple avvisar uppgifterna

De tre id:na måste tillhöra nyckeln som Apple har. Kopiera clientId, teamId och keyId på nytt från precis ovanför fältet Public Key, inte från en äldre nyckel som du ersatte. Om de fortfarande misslyckas startar du anslutningen på nytt i Hermoso: det skapar ett nytt nyckelpar, och du klistrar in den nya publika halvan i Apple.

Installationssessionen gick ut

Hermoso håller den genererade privata nyckeln i 24 timmar medan du går och klistrar in dess publika halva i Apple. Efter det är den borta, medvetet. Starta anslutningen igen och klistra in den nya publika nyckeln.

Jag har redan skapat en nyckel med openssl

Använd den då. Klistra in din befintliga EC P-256-privatnyckel när du ansluter i stället för Hermosos, så fortsätter den publika nyckeln som redan finns på ditt Apple-konto att fungera. Det måste vara en EC P-256-nyckel (prime256v1). Apple accepterar ingen annan kurva.

Jag hanterar flera Apple Ads-organisationer

Anslut var och en i sin egen Hermoso-profil. En anslutning är låst till en enda organisation, vilket hindrar att en byrås kampanj hamnar på fel kunds konto.

Vad Apple Search Ads-anslutningen kan göra

Bygg: 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, leveransstatus, daglig och total budget, de länder en kampanj körs i, och Apples egna angivna skäl när den inte kan köras), list_apple_ads_ad_groups (standardbud, och om Apples Search Match är på), list_apple_ads_keywords (inriktning och negativa, med matchningstyp och bud), apple_ads_report (visningar, tryck, installationer, utgifter, TTR, CPT och CPA på kampanj-, annonsgrupps-, annons-, sökords- eller sökterm-nivå) och list_apple_ads_orgs.

Allt detta kan anropas från Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes eller någon annan MCP-klient, och från webbstudion. Det är samma motor oavsett. Se MCP-översikten eller referensen för annonsverktyg.

Och mer: den bygger kreativ och annonser (create_apple_ads_creative, create_apple_ads_ad), laddar upp till 1 000 sökord i ett anrop (bulk_apple_ads_keywords) och läser Apples egen data: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity och apple_ads_change_history. Alla är anropbara från samma chatt.

Exportera data från Apple Search Ads

Samma anslutning rapporterar. apple_ads_report hämtar kampanj-, annonsgrupps-, annons-, sökords- och sökterm-prestanda (visningar, tryck, installationer, utgifter, tap-through rate, kostnad per tryck och kostnad per förvärv), som totalsummor eller som en serie per timme, dag, vecka eller månad, upp till 5 000 rader per sida. Att läsa en rapport rör aldrig utgifterna. Vart raderna sedan går bestämmer du, och de tre vanligaste platserna finns nedan. Hela guiden finns på Exportera data från Apple Search Ads.

Anslut Apple Search Ads till Google Sheets

Anslut Google Drive vid sidan av Apple Ads (en Google-auktorisering täcker Drive, Sheets och Docs) och be din agent lägga rapporten i ett kalkylark. Den anropar apple_ads_report, sedan create_sheet för ett nytt kalkylark eller append_to_sheet för att lägga till veckans rader i ett befintligt. Hermoso använder Googles drive.file-omfång, så det når bara filer som det skapat eller som du valt. Steg för steg: Anslut Apple Search Ads till Google Sheets.

Exportera Apple Search Ads till Looker Studio

Hermoso har ingen inbyggd Looker Studio-koppling. Looker Studio läser Google Sheets med sin egen inbyggda koppling, så kalkylarket ovan är bron. Lägg till det en gång som datakälla, bygg instrumentpanelen, och varje veckotillägg syns vid nästa datauppdatering. Power BI och Tableau läser samma kalkylark på samma sätt. Stegen för Looker Studio.

Exportera Apple Search Ads till JSON

För råa rader anropar du verktyget via Hermoso REST API med en API-nyckel: POST https://app.hermoso.ai/v1/tools/apple_ads_report med rapportargumenten som JSON-kropp, och läser raderna från data.rows i svaret. Från en terminal skriver npx -y hermoso call apple_ads_report --json '{...}' --structured ut samma resultat som JSON. Ett fullständigt exempel på förfrågan.

Vanliga frågor

Hur ansluter jag Apple Search Ads till Claude?

Lägg till Hermoso i Claude som en egen kontakt med URL:en https://app.hermoso.ai/mcp och godkänn med ditt Hermoso-konto, anslut sedan Apple Ads i Hermoso under Inställningar › Anslutningar. Claude kan därefter rapportera om, redigera och bygga dina Apple Search Ads-kampanjer via Hermosos Apple Ads-verktyg.

Kan ChatGPT läsa mina Apple Search Ads-data?

Ja. Lägg till https://app.hermoso.ai/mcp i ChatGPT under Plugins › Add › Create MCP App och anslut Apple Ads i Hermoso. ChatGPT kan då hämta visningar, tryck, installationer, utgifter, TTR, CPT och CPA per kampanj, annonsgrupp, annons, sökord eller sökterm, och skriva raderna till ett Google Sheets-kalkylark.

Finns det en MCP-server för Apple Search Ads?

Ja. Hermoso:s hostade MCP-server på https://app.hermoso.ai/mcp exponerar hela Apple Ads-verktygsuppsättningen för Claude, ChatGPT, Cursor, Codex eller vilken MCP-klient som helst: rapportering, kampanjer, annonsgrupper, sökord och negativa sökord, kreativ och annonser samt Apples sökordsförslag. Allt som byggs skapas pausat.

Varför finns inget fält Public Key på Apple Ads API-sidan?

För att du är inloggad som Account Admin. Apple visar bara det fältet för en användare med en API-roll. En administratör ser i stället en tabell med tredjepartsleverantörer under rubriken “Manage API Access”, och inget nyckelfält någonstans på sidan. Bjud in dig själv som API Account Manager under Account Settings › User Management, logga in som den användaren, så finns fältet där.

Vilken Apple Ads-roll behöver jag?

API Account Manager om du vill att Hermoso ska bygga kampanjer, annonsgrupper och sökord. Apple beskriver den som “läs- och skrivåtkomst till alla kampanjgrupper för API-hantering”. API Account Read Only räcker om du bara vill ha rapportering. De övriga fyra roller Apple erbjuder (Account Admin, Account Finance, Account Read Only och Limited Access) kan inte skapa API-uppgifter alls.

Måste jag köra openssl?

Nej. Apples egna anvisningar ger dig två openssl-kommandon; Hermoso genererar EC P-256-nyckelparet åt dig och visar bara den publika halvan. Den privata halvan är det som signerar dina förfrågningar, och du ser den, klistrar in den eller lagrar den aldrig. Har du redan en nyckel från ett annat verktyg kan du ta med den i stället.

Kostar det något att ansluta Apple Ads, eller riskerar det utgifter?

Nej. Läsningarna är gratis att anropa, och varje objekt som Hermoso skapar skapas PAUSAT utan undantag. Att aktivera ett objekt är den enda omkopplaren som sätter igång riktiga utgifter, och den kräver en uttrycklig bekräftelse.

Vad är clientId, teamId och keyId?

De tre identifierare som Apple skriver ut ovanför fältet Public Key när du har sparat din nyckel. De identifierar din API-användare för Apple; den privata nyckeln bevisar att det är du. Klistra in alla tre i Hermoso så är anslutningen klar.

Kan en anslutning täcka flera Apple Ads-organisationer?

En anslutning är låst till den enda organisation du väljer när du skapar den. Apple behandlar ett orgId ungefär som en kampanjgrupp, så en inloggning kan täcka flera. En byrå med en kund per organisation ansluter var och en i sin egen Hermoso-profil.

Måste jag rotera nyckeln var 180:e dag?

Nej. Apple begränsar en klienthemlighet till 180 dagar, vilket är anledningen till att Apples egna anvisningar får dig att boka en rotation. Hermoso håller den privata nyckeln och skapar en färsk, kortlivad hemlighet för varje token-växling, så det finns ingenting i en konfigurationsfil som kan gå ut.

Kan jag exportera Apple Search Ads-data till Google Sheets eller Looker Studio?

Ja. Anslut Google Drive vid sidan av Apple Ads, så skriver din agent rapporten till ett Google Sheets-kalkylark med create_sheet eller append_to_sheet. Hermoso har ingen inbyggd Looker Studio-koppling; Looker Studio läser kalkylarket med sin egen Google Sheets-koppling.

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

Ja. Anropa POST /v1/tools/apple_ads_report på Hermoso API med en API-nyckel och läs data.rows, eller kör hermoso call apple_ads_report med --structured från CLI:t.