Connecter Apple Search Ads à Claude ou ChatGPT en cinq minutes

Le connecteur Hermoso pour Apple Search Ads relie votre compte Apple Ads à Claude, ChatGPT, Cursor, la CLI ou du HTTP classique, afin qu’un agent puisse gérer vos annonces de recherche sur l’App Store à votre place. Il construit la campagne, le groupe d’annonces, les mots-clés de ciblage et les négatifs, relit ce qu’Apple a réellement enregistré, et rend compte des performances jusqu’au terme de recherche tapé par quelqu’un avant d’installer l’app. Tout ce qui est créé l’est en pause, et l’activation des dépenses est une étape distincte, qui demande une confirmation explicite. Les rapports peuvent atterrir dans une Google Sheet, un tableau de bord Looker Studio ou un fichier JSON, et la page MCP Apple Ads liste tout ce que le connecteur sait faire.

La connexion prend environ cinq minutes. Vous n’aurez pas à lancer openssl, et aucun mot de passe Apple ne passe par Hermoso.

Connecter Apple Search Ads à Claude

Pour connecter Apple Search Ads à Claude, ajoutez Hermoso à Claude comme connecteur, puis connectez votre compte Apple Ads dans Hermoso une seule fois. Dans Claude, ouvrez Customize › Connectors › Add custom connector, nommez-le Hermoso, collez https://app.hermoso.ai/mcp et approuvez avec votre compte Hermoso. Il n’y a aucune clé à coller dans Claude. Connectez ensuite Apple Ads dans Hermoso sous Paramètres › Connecteurs, en suivant les étapes plus bas sur cette page. À partir de là, Claude peut appeler tous les outils Apple Ads d’Hermoso : demandez un rapport, une modification de mot-clé ou une nouvelle campagne avec des mots simples. Dans Claude Code, il suffit de deux commandes : /plugin marketplace add hermoso-ai/hermoso, puis /plugin install hermoso@hermoso. Hermoso dans Claude détaille toutes les étapes.

Connecter Apple Search Ads à ChatGPT

ChatGPT fonctionne de la même façon. Dans ChatGPT, ouvrez Plugins, puis Add › Create MCP App, nommez-le Hermoso, collez https://app.hermoso.ai/mcp comme Server URL, laissez Authentication sur OAuth et approuvez avec votre compte Hermoso. Si Create MCP App n’apparaît pas, activez une fois le mode développeur sous Settings › Plugins › Developer mode. Une fois Apple Ads connecté dans Hermoso, ChatGPT peut extraire votre rapport de mots-clés, l’écrire dans une Google Sheet ou préparer une campagne que vous vérifierez. Hermoso dans ChatGPT détaille la démarche.

Cursor, Codex et tout autre client MCP

Tout client qui parle le Model Context Protocol atteint les mêmes outils à la même adresse. Cursor lit https://app.hermoso.ai/mcp depuis son mcp.json ; Codex accepte le plugin Hermoso avec codex plugin marketplace add hermoso-ai/hermoso, qui pilote les mêmes outils depuis le terminal. Quel que soit le client, vos identifiants Apple ne passent jamais par la conversation. L’agent appelle les outils d’Hermoso, et Hermoso signe chaque requête adressée à Apple avec la clé qu’il détient. La page MCP Apple Ads liste chaque outil.

Que demander une fois la connexion faite

• « Donne-moi les performances Apple Search Ads de la semaine passée par mot-clé et montre-moi les dix qui ont le coût par acquisition le plus élevé. »
• « Place les dépenses, installations et CPA des 30 derniers jours par campagne dans une nouvelle Google Sheet appelée Apple Ads. » (Connectez d’abord Google Drive.)
• « Quels termes de recherche ont apporté des installations dans ma campagne américaine ce mois-ci sans que je les enchérisse encore en mots-clés exacts ? »
• « Ajoute « budget planner » et « expense tracker » comme mots-clés en correspondance exacte dans le groupe d’annonces Brand, et « jobs » comme négatif. »
• « Quels mots-clés Apple suggère-t-il pour mon app, et quelle part des impressions ai-je sur ceux sur lesquels j’enchéris déjà ? »
• « Crée une campagne en pause pour mon app au Royaume-Uni avec un budget quotidien de 50 dollars, puis montre-moi ce qu’Apple a enregistré. »

La lecture d’un rapport ne touche jamais aux dépenses. Tout ce que l’agent crée est en pause, et l’interrupteur qui active les dépenses attend votre confirmation explicite.

D’abord, ce qui arrête la plupart des gens

Les instructions d’Apple disent : « From the Ads UI, choose Account Settings › API. Paste the key into the Public Key field. »

Ce champ n’existe pas pour un administrateur de compte. Connectez-vous en tant qu’administrateur sur votre propre compte, ouvrez Account Settings › API, et ce qui s’affiche est un tableau intitulé Manage API Access (une liste de fournisseurs de services tiers avec une seule action, Remove Access), sans aucun champ de clé nulle part sur la page. Cela ressemble exactement à une fonctionnalité absente, c’est pourquoi les gens s’arrêtent là et concluent que l’API n’est pas disponible pour eux.

Elle l’est. Le champ Public Key appartient à un utilisateur qui détient un rôle API, et être administrateur du compte n’en est pas un. L’invitation d’Apple propose six rôles, dont exactement deux sont des rôles API :

• API Account Manager : « read and write access to all campaign groups for API management ». C’est celui à choisir si vous voulez qu’Hermoso construise des campagnes, et pas seulement qu’il en fasse le rapport.
• API Account Read Only : « read only access to all campaign groups for API management ». Suffisant pour le reporting, et rien d’autre.

Les quatre autres (Account Admin, Account Finance, Account Read Only et Limited Access) ne peuvent pas du tout créer d’identifiants API. La solution consiste donc à vous envoyer une invitation à vous-même :

1. Ouvrez Account Settings › User Management et choisissez Invite Users.
2. Invitez une adresse que vous contrôlez (la vôtre, ou une adresse partagée comme ads-api@yourcompany.com, pour que l’identifiant survive à une personne en particulier) avec le rôle API Account Manager.
3. Acceptez l’invitation depuis cette boîte, puis connectez-vous à Apple Ads en tant que cet utilisateur.

Account Settings › API affiche désormais un champ Public Key.

La connexion, étape par étape

1. Démarrez-la dans Hermoso. Paramètres › Connecteurs › Apple Ads › Connect. Hermoso génère une clé de signature EC P-256 (la même clé prime256v1 que produiraient les deux commandes openssl d’Apple) et vous montre uniquement la moitié publique. Copiez-la.
2. Donnez la moitié publique à Apple. En tant qu’utilisateur au rôle API, ouvrez Account Settings › API, collez-la dans Public Key, puis enregistrez.
3. Recopiez les trois identifiants. Apple affiche désormais clientId, teamId et keyId au-dessus de ce champ. Les trois.
4. Terminez dans Hermoso. Collez les trois identifiants et enregistrez. Hermoso échange un jeton avec Apple et lit la liste de vos organisations avant de stocker quoi que ce soit : un identifiant mal saisi échoue immédiatement, tandis que vous voyez encore ce que vous avez collé, et non à votre premier rapport une heure plus tard.
5. Choisissez l’organisation, si vos identifiants en couvrent plusieurs. La connexion est liée à celle que vous choisissez.

En cas de problème

Il n’y a pas de champ Public Key sur la page API

Vous êtes connecté en tant qu’Account Admin, ou avec l’un des quatre rôles non API. Invitez-vous comme API Account Manager et connectez-vous en tant que cet utilisateur (voir plus haut). C’est la raison la plus fréquente pour laquelle une connexion Apple Ads ne se fait jamais.

Apple refuse les identifiants

Les trois identifiants doivent appartenir à la clé que détient Apple. Recopiez clientId, teamId et keyId depuis le haut du champ Public Key, et non depuis une ancienne clé que vous avez remplacée. S’ils échouent toujours, relancez la connexion dans Hermoso : cela crée une nouvelle paire de clés, et vous collez la nouvelle moitié publique dans Apple.

La session de configuration a expiré

Hermoso conserve la clé privée générée pendant 24 heures, le temps que vous alliez coller sa moitié publique dans Apple. Passé ce délai, elle est effacée, volontairement. Relancez la connexion et collez la nouvelle clé publique.

J’ai déjà généré une clé avec openssl

Alors utilisez-la. Collez votre clé privée EC P-256 existante lors de la connexion, au lieu de prendre celle d’Hermoso, et la clé publique déjà présente dans votre compte Apple continue de fonctionner. Elle doit être une clé EC P-256 (prime256v1). Apple n’accepte aucune autre courbe.

Je gère plusieurs organisations Apple Ads

Connectez chacune dans son propre profil Hermoso. Une connexion est liée à une seule organisation, ce qui empêche qu’une campagne d’agence atterrisse dans le compte du mauvais client.

Ce que le connecteur Apple Search Ads peut faire

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

Lire : list_apple_ads_campaigns (statut, statut de diffusion, budget quotidien et total, les pays où diffuse une campagne, et la raison donnée par Apple lorsqu’elle ne peut pas tourner), list_apple_ads_ad_groups (enchère par défaut, et l’activation ou non de Search Match d’Apple), list_apple_ads_keywords (ciblage et négatifs, avec type de correspondance et enchère), apple_ads_report (impressions, taps, installations, dépenses, TTR, CPT et CPA au niveau campagne, groupe d’annonces, mot-clé, terme de recherche ou annonce) et list_apple_ads_orgs.

Tout cela est appelable depuis Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes ou tout autre client MCP, ainsi que depuis le studio web. C’est le même moteur dans tous les cas. Voir la présentation MCP ou la référence des outils publicitaires.

Et plus encore : il crée des créations et des annonces (create_apple_ads_creative, create_apple_ads_ad), charge jusqu’à 1 000 mots-clés en un seul appel (bulk_apple_ads_keywords), et lit les données propres à Apple : apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity et apple_ads_change_history. Chacun de ces outils est appelable depuis la même conversation.

Exporter les données d’Apple Search Ads

La même connexion sert aussi au reporting. apple_ads_report récupère les performances par campagne, groupe d’annonces, annonce, mot-clé et terme de recherche (impressions, taps, installations, dépenses, taux de tap, coût par tap et coût par acquisition), en totaux ou en série horaire, quotidienne, hebdomadaire ou mensuelle, jusqu’à 5 000 lignes par page. La lecture d’un rapport ne touche jamais aux dépenses. La destination des lignes vous appartient, et les trois endroits les plus courants sont présentés ci-dessous. Le guide complet est Exporter les données d’Apple Search Ads.

Connecter Apple Search Ads à Google Sheets

Connectez Google Drive à côté d’Apple Ads (une seule autorisation Google couvre Drive, Sheets et Docs), puis demandez à votre agent de placer le rapport dans une feuille. Il appelle apple_ads_report, puis create_sheet pour un nouveau tableur, ou append_to_sheet pour ajouter les lignes de la semaine à un tableur existant. Hermoso utilise le périmètre drive.file de Google, qui n’atteint que les fichiers qu’il a créés ou que vous avez choisis. Pas à pas : Connecter Apple Search Ads à Google Sheets.

Exporter Apple Search Ads vers Looker Studio

Hermoso n’a pas de connecteur Looker Studio natif. Looker Studio lit Google Sheets avec son propre connecteur, donc la feuille ci-dessus fait office de pont : ajoutez-la une fois comme source de données Google Sheets, construisez le tableau de bord, et chaque ajout hebdomadaire apparaît à l’actualisation suivante. Power BI et Tableau lisent la même feuille de la même façon. Les étapes Looker Studio.

Exporter Apple Search Ads en JSON

Pour des lignes brutes, appelez l’outil via l’API REST Hermoso avec une clé API : POST https://app.hermoso.ai/v1/tools/apple_ads_report avec les arguments du rapport dans le corps JSON, puis lisez les lignes dans data.rows de la réponse. Depuis un terminal, npx -y hermoso call apple_ads_report --json '{...}' --structured affiche le même résultat en JSON. Un exemple complet de requête.

Questions fréquentes

Comment connecter Apple Search Ads à Claude ?

Ajoutez Hermoso à Claude comme connecteur personnalisé avec l’URL https://app.hermoso.ai/mcp et approuvez avec votre compte Hermoso, puis connectez Apple Ads dans Hermoso sous Paramètres › Connecteurs. Claude peut ensuite établir des rapports, modifier et construire vos campagnes Apple Search Ads via les outils Apple Ads d’Hermoso.

ChatGPT peut-il lire mes données Apple Search Ads ?

Oui. Ajoutez https://app.hermoso.ai/mcp dans ChatGPT sous Plugins › Add › Create MCP App, et connectez Apple Ads dans Hermoso. ChatGPT peut alors extraire les impressions, taps, installations, dépenses, TTR, CPT et CPA par campagne, groupe d’annonces, annonce, mot-clé ou terme de recherche, et écrire les lignes dans une Google Sheet.

Existe-t-il un serveur MCP pour Apple Search Ads ?

Oui. Le serveur MCP hébergé par Hermoso à l’adresse https://app.hermoso.ai/mcp expose l’ensemble des outils Apple Ads à Claude, ChatGPT, Cursor, Codex ou tout client MCP : reporting, campagnes, groupes d’annonces, mots-clés et négatifs, créations et annonces, et suggestions de mots-clés d’Apple. Tout ce qu’il construit est créé en pause.

Pourquoi n’y a-t-il pas de champ Public Key sur la page API d’Apple Ads ?

Parce que vous êtes connecté en tant qu’Account Admin. Apple n’affiche ce champ qu’à un utilisateur qui détient un rôle API. Un administrateur voit à la place un tableau « Manage API Access » listant des fournisseurs de services tiers, sans aucun champ de clé sur la page. Invitez-vous comme API Account Manager sous Account Settings › User Management, connectez-vous en tant que cet utilisateur, et le champ apparaît.

Quel rôle Apple Ads me faut-il ?

API Account Manager si vous voulez qu’Hermoso construise des campagnes, des groupes d’annonces et des mots-clés. Apple le décrit comme « read and write access to all campaign groups for API management ». API Account Read Only suffit si vous voulez seulement le reporting. Les quatre autres rôles proposés par Apple (Account Admin, Account Finance, Account Read Only et Limited Access) ne peuvent pas du tout créer d’identifiants API.

Dois-je lancer openssl ?

Non. Les instructions d’Apple vous donnent deux commandes openssl ; Hermoso génère la paire de clés EC P-256 à votre place et ne vous montre que la moitié publique. La moitié privée sert à signer vos requêtes, et vous ne la voyez jamais, ne la collez jamais et ne la stockez jamais. Si vous avez déjà une clé issue d’un autre outil, vous pouvez l’apporter à la place.

Connecter Apple Ads coûte-t-il quelque chose ou risque-t-il de déclencher des dépenses ?

Non. Les lectures sont libres d’appel, et chaque objet créé par Hermoso l’est en PAUSE, sans dérogation possible. Activer un objet est le seul interrupteur qui met en marche de vraies dépenses, et il exige une confirmation explicite.

Que sont clientId, teamId et keyId ?

Les trois identifiants qu’Apple affiche au-dessus du champ Public Key une fois votre clé enregistrée. Ils identifient votre utilisateur API auprès d’Apple ; la clé privée prouve que c’est bien vous. Collez les trois dans Hermoso et la connexion est terminée.

Une seule connexion peut-elle couvrir plusieurs organisations Apple Ads ?

Une connexion est liée à la seule organisation que vous choisissez lors de sa création. Apple traite un orgId à peu près comme un groupe de campagnes, donc un seul identifiant peut en couvrir plusieurs. Une agence avec un client par organisation connecte chacune dans son propre profil Hermoso.

Dois-je faire tourner la clé tous les 180 jours ?

Non. Apple limite un secret client à 180 jours, ce qui explique pourquoi ses propres instructions vous demandent de noter une rotation dans votre agenda. Hermoso conserve la clé privée et génère un secret neuf, de courte durée, à chaque échange de jeton ; il n’y a donc rien dans un fichier de configuration qui puisse expirer.

Puis-je exporter les données Apple Search Ads vers Google Sheets ou Looker Studio ?

Oui. Connectez Google Drive à côté d’Apple Ads, et votre agent écrit le rapport dans une Google Sheet avec create_sheet ou append_to_sheet. Hermoso n’a pas de connecteur Looker Studio natif ; Looker Studio lit cette feuille avec son propre connecteur Google Sheets.

Puis-je obtenir les données Apple Search Ads en JSON ?

Oui. Appelez POST /v1/tools/apple_ads_report sur l’API Hermoso avec une clé API et lisez data.rows, ou lancez hermoso call apple_ads_report avec --structured depuis la CLI.