Apple Search Ads in fünf Minuten mit Claude oder ChatGPT verbinden

Der Hermoso-Connector für Apple Search Ads verbindet dein Apple-Ads-Konto mit Claude, ChatGPT, Cursor, der CLI oder einfachem HTTP, damit ein Agent deine App-Store-Suchanzeigen für dich betreiben kann. Er baut die Kampagne, die Anzeigengruppe, die Targeting-Keywords und die Negativ-Keywords, liest zurück, was Apple tatsächlich gespeichert hat, und meldet die Performance bis hinunter zu dem Suchbegriff, den jemand eingetippt hat, bevor er die App installiert hat. Alles, was er anlegt, wird pausiert erstellt, und das Aktivieren von Ausgaben ist ein eigener Schritt, den du ausdrücklich bestätigst. Berichte können in einer Google Tabelle, einem Looker-Studio-Dashboard oder einer JSON-Datei landen, und die Seite zu Apple Ads MCP listet alles auf, was der Connector kann.

Die Verbindung dauert etwa fünf Minuten. Du musst kein openssl ausführen, und kein Apple-Passwort kommt in die Nähe von Hermoso.

Apple Search Ads mit Claude verbinden

Um Apple Search Ads mit Claude zu verbinden, füge Hermoso in Claude als Connector hinzu und verbinde dann einmal dein Apple-Ads-Konto in Hermoso. In Claude öffnest du Customize › Connectors › Add custom connector, nennst ihn Hermoso, fügst https://app.hermoso.ai/mcp ein und bestätigst mit deinem Hermoso-Konto. Einen Schlüssel musst du in Claude nicht eintragen. Verbinde danach Apple Ads in Hermoso unter Einstellungen › Connectoren, mit den Schritten weiter unten auf dieser Seite. Ab dann kann Claude jedes Apple-Ads-Tool aufrufen, das Hermoso hat: Bitte um einen Bericht, eine Keyword-Änderung oder eine neue Kampagne in einfachen Worten. In Claude Code sind es stattdessen zwei Befehle: /plugin marketplace add hermoso-ai/hermoso, dann /plugin install hermoso@hermoso. Hermoso in Claude enthält die vollständigen Schritte.

Apple Search Ads mit ChatGPT verbinden

ChatGPT funktioniert genauso. Öffne in ChatGPT Plugins, dann Add › Create MCP App, nenne den Eintrag Hermoso, füge https://app.hermoso.ai/mcp als Server URL ein, lasse Authentication auf OAuth und bestätige mit deinem Hermoso-Konto. Wenn Create MCP App nicht dort steht, schalte einmalig unter Settings › Plugins › Developer mode den Entwicklermodus ein. Mit verbundenem Apple Ads in Hermoso kann ChatGPT deinen Keyword-Bericht abrufen, ihn in eine Google Tabelle schreiben oder eine Kampagne zur Prüfung für dich entwerfen. Hermoso in ChatGPT führt dich durch die Schritte.

Cursor, Codex und jeder andere MCP-Client

Jeder Client, der das Model Context Protocol spricht, erreicht dieselben Tools unter derselben Adresse. Cursor liest https://app.hermoso.ai/mcp aus seiner mcp.json; Codex nimmt das Hermoso-Plugin mit codex plugin marketplace add hermoso-ai/hermoso auf, was dieselben Tools aus dem Terminal steuert. Welchen Client du auch nutzt, deine Apple-Zugangsdaten gehen nie durch den Chat. Der Agent ruft die Tools von Hermoso auf, und Hermoso signiert jede Anfrage an Apple mit dem Schlüssel, den es verwahrt. Die Seite zu Apple Ads MCP listet jedes Tool auf.

Was du fragen kannst, wenn es verbunden ist

• “Hol dir die Apple-Search-Ads-Performance der letzten Woche nach Keyword und zeig mir die zehn mit den höchsten Kosten pro Akquisition.”
• “Trag die Ausgaben, Installationen und den CPA der letzten 30 Tage nach Kampagne in eine neue Google Tabelle namens Apple Ads ein.” (Verbinde vorher Google Drive.)
• “Welche Suchbegriffe haben diesen Monat in meiner US-Kampagne Installationen gebracht, auf die ich noch nicht als exakte Keywords biete?”
• “Füge ‘budget planner’ und ‘expense tracker’ als Keywords mit exakter Übereinstimmung in der Anzeigengruppe Brand hinzu und ‘jobs’ als Negativ-Keyword.”
• “Welche Keywords schlägt Apple für meine App vor, und welchen Anteil an Impressionen bekomme ich bei den Keywords, auf die ich schon biete?”
• “Erstelle eine pausierte Kampagne für meine App in Großbritannien mit 50 Dollar Tagesbudget und zeig mir dann, was Apple gespeichert hat.”

Einen Bericht zu lesen berührt nie die Ausgaben. Alles, was der Agent anlegt, wird pausiert erstellt, und der Schalter, der die Ausgaben einschaltet, wartet auf deine ausdrückliche Bestätigung.

Zuerst das, woran die meisten scheitern

Apples eigene Anleitung sagt: “Wähle in der Ads-Oberfläche Account Settings › API und füge den Schlüssel in das Feld Public Key ein.”

Dieses Feld gibt es für einen Account Admin nicht. Melde dich als Admin in deinem eigenen Konto an, öffne Account Settings › API, und du siehst eine Tabelle mit der Überschrift Manage API Access (eine Liste von Drittanbieter-Dienstleistern mit einer einzigen Aktion, Remove Access) und nirgendwo auf der Seite ein Schlüsselfeld. Das wirkt genau wie ein fehlendes Feature, deshalb hören die Leute hier auf und schließen daraus, dass die API für sie nicht verfügbar ist.

Sie ist aber verfügbar. Das Feld Public Key gehört einem Benutzer mit einer API-Rolle, und Admin des Kontos zu sein, ist keine solche Rolle. Apples Einladungsdialog bietet sechs Rollen an, davon sind genau zwei API-Rollen:

• API Account Manager: “Lese- und Schreibzugriff auf alle Kampagnengruppen für die API-Verwaltung”. Die solltest du wählen, wenn Hermoso Kampagnen anlegen soll und nicht nur berichten.
• API Account Read Only: “Nur-Lese-Zugriff auf alle Kampagnengruppen für die API-Verwaltung”. Reicht zum Berichten, mehr aber auch nicht.

Die anderen vier (Account Admin, Account Finance, Account Read Only und Limited Access) können überhaupt keine API-Zugangsdaten erzeugen. Die Lösung ist also eine Einladung, die du dir selbst schickst:

1. Öffne Account Settings › User Management und wähle Invite Users.
2. Lade eine Adresse ein, die du kontrollierst (deine eigene oder eine gemeinsame wie ads-api@yourcompany.com, damit die Zugangsdaten eine einzelne Person überdauern), mit der Rolle API Account Manager.
3. Nimm die Einladung aus diesem Postfach an und melde dich dann bei Apple Ads als dieser Benutzer an.

Jetzt hat Account Settings › API ein Feld Public Key.

Die Verbindung, Schritt für Schritt

1. Starte sie in Hermoso. Einstellungen › Connectoren › Apple Ads › Connect. Hermoso erzeugt einen EC P-256-Signaturschlüssel (denselben prime256v1-Schlüssel, den Apples zwei openssl-Befehle erzeugt hätten) und zeigt dir nur die öffentliche Hälfte. Kopiere sie.
2. Gib Apple die öffentliche Hälfte. Öffne als dein API-Rollen-Benutzer Account Settings › API, füge sie unter Public Key ein und klicke auf Save.
3. Kopiere die drei IDs zurück. Apple zeigt jetzt clientId, teamId und keyId über diesem Feld an. Alle drei.
4. Schließe es in Hermoso ab. Füge die drei IDs ein und speichere. Hermoso tauscht bei Apple ein Token aus und liest deine Organisationsliste, bevor es etwas speichert. Eine vertippte ID schlägt also genau an dieser Stelle fehl, während du noch siehst, was du eingefügt hast, und nicht erst beim ersten Bericht eine Stunde später.
5. Wähle die Organisation, falls deine Zugangsdaten mehr als eine abdecken. Die Verbindung wird auf die gewählte festgelegt.

Wenn etwas schiefgeht

Auf der API-Seite gibt es kein Feld Public Key

Du bist als Account Admin angemeldet oder mit einer der vier Nicht-API-Rollen. Lade dich selbst als API Account Manager ein und melde dich als dieser Benutzer an (siehe oben). Das ist der mit Abstand häufigste Grund, warum nie eine Apple-Ads-Verbindung zustande kommt.

Apple lehnt die Zugangsdaten ab

Die drei IDs müssen zu dem Schlüssel gehören, den Apple verwahrt. Kopiere clientId, teamId und keyId erneut von direkt über dem Feld Public Key, nicht von einem älteren Schlüssel, den du ersetzt hast. Wenn sie immer noch scheitern, starte die Verbindung in Hermoso neu: Das erzeugt ein frisches Schlüsselpaar, und du fügst die neue öffentliche Hälfte bei Apple ein.

Die Einrichtungssitzung ist abgelaufen

Hermoso hält den erzeugten privaten Schlüssel 24 Stunden lang, während du die öffentliche Hälfte bei Apple einfügst. Danach ist er absichtlich weg. Starte die Verbindung neu und füge den neuen öffentlichen Schlüssel ein.

Ich habe schon einen Schlüssel mit openssl erzeugt

Dann verwende ihn. Füge beim Verbinden deinen vorhandenen privaten EC P-256-Schlüssel ein, statt den von Hermoso zu nehmen, und der öffentliche Schlüssel, der bereits in deinem Apple-Konto liegt, funktioniert weiter. Es muss ein EC P-256-Schlüssel (prime256v1) sein. Apple akzeptiert keine andere Kurve.

Ich verwalte mehrere Apple-Ads-Organisationen

Verbinde jede in ihrem eigenen Hermoso-Profil. Eine Verbindung ist an eine einzelne Organisation gebunden, und genau das verhindert, dass eine Kampagne einer Agentur im Konto des falschen Kunden landet.

Was der Apple-Search-Ads-Connector kann

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

Lesen: list_apple_ads_campaigns (Status, Auslieferungsstatus, Tages- und Gesamtbudget, die Länder, in denen eine Kampagne läuft, und Apples eigene Begründung, wenn eine Kampagne nicht laufen kann), list_apple_ads_ad_groups (Standardgebot und ob Apples Search Match aktiv ist), list_apple_ads_keywords (Targeting und Negativ-Keywords mit Übereinstimmungstyp und Gebot), apple_ads_report (Impressionen, Taps, Installationen, Ausgaben, TTR, CPT und CPA auf Ebene von Kampagne, Anzeigengruppe, Keyword, Suchbegriff oder Anzeige) und list_apple_ads_orgs.

Alles davon ist aus Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes oder jedem anderen MCP-Client aufrufbar und aus dem Web-Studio. Es ist in beiden Fällen dieselbe Engine. Siehe die MCP-Übersicht oder die Referenz der Ads-Tools.

Und mehr: Es baut Creatives und Anzeigen (create_apple_ads_creative, create_apple_ads_ad), lädt bis zu 1.000 Keywords mit einem Aufruf (bulk_apple_ads_keywords) und liest Apples eigene Daten: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity und apple_ads_change_history. Jedes davon ist aus demselben Chat aufrufbar.

Daten aus Apple Search Ads exportieren

Dieselbe Verbindung liefert auch Berichte. apple_ads_report holt Performance-Daten für Kampagne, Anzeigengruppe, Anzeige, Keyword und Suchbegriff (Impressionen, Taps, Installationen, Ausgaben, Tap-Through-Rate, Kosten pro Tap und Kosten pro Akquisition), als Summen oder als Reihe stündlich, täglich, wöchentlich oder monatlich, bis zu 5.000 Zeilen pro Seite. Einen Bericht zu lesen berührt nie die Ausgaben. Wohin die Zeilen danach gehen, entscheidest du, und die drei häufigsten Ziele stehen unten. Die vollständige Anleitung findest du unter Daten aus Apple Search Ads exportieren.

Apple Search Ads mit Google Tabellen verbinden

Verbinde Google Drive neben Apple Ads (eine Google-Autorisierung deckt Drive, Tabellen und Docs ab) und bitte deinen Agenten, den Bericht in eine Tabelle zu schreiben. Er ruft apple_ads_report auf und dann create_sheet für eine neue Tabelle oder append_to_sheet, um die Zeilen dieser Woche an eine bestehende anzuhängen. Hermoso nutzt den Google-Scope drive.file, erreicht also nur Dateien, die es selbst erstellt hat oder die du ausgewählt hast. Schritt für Schritt: Apple Search Ads mit Google Tabellen verbinden.

Apple Search Ads nach Looker Studio exportieren

Hermoso hat keinen nativen Looker-Studio-Connector. Looker Studio liest Google Tabellen mit eigenem Connector, deshalb ist die Tabelle oben die Brücke: Füge sie einmal als Google-Tabellen-Datenquelle hinzu, baue das Dashboard, und jeder wöchentliche Anhang erscheint bei der nächsten Aktualisierung. Power BI und Tableau lesen dieselbe Tabelle auf dieselbe Weise. Die Schritte für Looker Studio.

Apple Search Ads als JSON exportieren

Für rohe Zeilen rufst du das Tool über die Hermoso-REST-API mit einem API-Schlüssel auf: POST https://app.hermoso.ai/v1/tools/apple_ads_report mit den Berichtsargumenten als JSON-Body, und die Zeilen liest du aus data.rows in der Antwort. Aus dem Terminal gibt npx -y hermoso call apple_ads_report --json '{...}' --structured dasselbe Ergebnis als JSON aus. Ein vollständiges Beispiel.

Häufig gestellte Fragen

Wie verbinde ich Apple Search Ads mit Claude?

Füge Hermoso in Claude als benutzerdefinierten Connector mit der URL https://app.hermoso.ai/mcp hinzu und bestätige mit deinem Hermoso-Konto. Verbinde dann Apple Ads in Hermoso unter Einstellungen › Connectoren. Claude kann danach deine Apple-Search-Ads-Kampagnen über die Apple-Ads-Tools von Hermoso auswerten, bearbeiten und aufbauen.

Kann ChatGPT meine Apple-Search-Ads-Daten lesen?

Ja. Füge https://app.hermoso.ai/mcp in ChatGPT unter Plugins › Add › Create MCP App hinzu und verbinde Apple Ads in Hermoso. ChatGPT kann dann Impressionen, Taps, Installationen, Ausgaben, TTR, CPT und CPA nach Kampagne, Anzeigengruppe, Anzeige, Keyword oder Suchbegriff abrufen und die Zeilen in eine Google Tabelle schreiben.

Gibt es einen MCP-Server für Apple Search Ads?

Ja. Der gehostete MCP-Server von Hermoso unter https://app.hermoso.ai/mcp stellt das vollständige Apple-Ads-Toolset für Claude, ChatGPT, Cursor, Codex oder jeden MCP-Client bereit: Berichte, Kampagnen, Anzeigengruppen, Keywords und Negativ-Keywords, Creatives und Anzeigen sowie Apples Keyword-Vorschläge. Alles, was er anlegt, wird pausiert erstellt.

Warum gibt es auf der Apple-Ads-API-Seite kein Feld Public Key?

Weil du als Account Admin angemeldet bist. Apple zeigt dieses Feld nur einem Benutzer mit einer API-Rolle. Ein Admin sieht stattdessen eine Tabelle „Manage API Access“ mit Drittanbieter-Dienstleistern, und nirgendwo auf der Seite gibt es ein Schlüsselfeld. Lade dich unter Account Settings › User Management als API Account Manager ein, melde dich als dieser Benutzer an, dann ist das Feld da.

Welche Apple-Ads-Rolle brauche ich?

API Account Manager, wenn Hermoso Kampagnen, Anzeigengruppen und Keywords anlegen soll. Apple beschreibt sie als “Lese- und Schreibzugriff auf alle Kampagnengruppen für die API-Verwaltung”. API Account Read Only reicht, wenn du nur Berichte willst. Die anderen vier Rollen, die Apple anbietet (Account Admin, Account Finance, Account Read Only und Limited Access), können überhaupt keine API-Zugangsdaten erzeugen.

Muss ich openssl ausführen?

Nein. Apples eigene Anleitung gibt dir zwei openssl-Befehle; Hermoso erzeugt das EC-P-256-Schlüsselpaar für dich und zeigt dir nur die öffentliche Hälfte. Die private Hälfte signiert deine Anfragen, und du siehst, fügst sie nie ein und speicherst sie nie. Wenn du schon einen Schlüssel aus einem anderen Tool hast, kannst du stattdessen diesen mitbringen.

Kostet das Verbinden von Apple Ads etwas oder riskiert es Ausgaben?

Nein. Die Lesezugriffe sind kostenlos, und jedes Objekt, das Hermoso anlegt, wird PAUSIERT erstellt, ohne Ausnahme. Das Aktivieren eines Objekts ist der einzige Schalter, der echte Ausgaben scharfstellt, und er verlangt eine ausdrückliche Bestätigung.

Was sind clientId, teamId und keyId?

Die drei Kennungen, die Apple über dem Feld Public Key anzeigt, sobald du deinen Schlüssel speicherst. Sie identifizieren deinen API-Benutzer bei Apple; der private Schlüssel beweist, dass du es bist. Füge alle drei in Hermoso ein, dann ist die Verbindung fertig.

Kann eine Verbindung mehrere Apple-Ads-Organisationen abdecken?

Eine Verbindung ist auf die einzelne Organisation festgelegt, die du beim Erstellen wählst. Apple behandelt eine orgId ungefähr wie eine Kampagnengruppe, deshalb kann ein Login mehrere abdecken. Eine Agentur mit einem Kunden pro Organisation verbindet jede in ihrem eigenen Hermoso-Profil.

Muss ich den Schlüssel alle 180 Tage erneuern?

Nein. Apple begrenzt ein Client Secret auf 180 Tage, deshalb sieht Apples Anleitung eine Erneuerung im Kalender vor. Hermoso hält den privaten Schlüssel und erzeugt für jeden Token-Austausch ein neues kurzlebiges Secret, sodass in keiner Konfigurationsdatei etwas abläuft.

Kann ich Apple-Search-Ads-Daten nach Google Tabellen oder Looker Studio exportieren?

Ja. Verbinde Google Drive neben Apple Ads, und dein Agent schreibt den Bericht mit create_sheet oder append_to_sheet in eine Google Tabelle. Hermoso hat keinen nativen Looker-Studio-Connector; Looker Studio liest diese Tabelle mit seinem eigenen Google-Tabellen-Connector.

Kann ich Apple-Search-Ads-Daten als JSON bekommen?

Ja. Rufe POST /v1/tools/apple_ads_report auf der Hermoso-API mit einem API-Schlüssel auf und lies data.rows aus der Antwort, oder führe in der CLI hermoso call apple_ads_report mit --structured aus.