Conectează Apple Search Ads la Claude sau ChatGPT în cinci minute

Conectorul Hermoso pentru Apple Search Ads leagă contul tău Apple Ads de Claude, ChatGPT, Cursor, CLI sau HTTP simplu, astfel încât un agent să poată rula reclamele tale de căutare din App Store. Construiește campania, grupul de reclame, cuvintele cheie de targetare și cele negative, citește înapoi ce a salvat efectiv Apple și raportează performanța până la termenul de căutare pe care cineva l-a tastat înainte să instaleze aplicația. Tot ce creează este creat în pauză, iar activarea cheltuielilor este un pas separat, confirmat explicit. Rapoartele pot ajunge într-un Google Sheet, într-un tablou Looker Studio sau într-un fișier JSON, iar pagina MCP Apple Ads listează tot ce poate face conectorul.

Conectarea durează aproximativ cinci minute. Nu vei rula openssl, iar nicio parolă Apple nu ajunge în Hermoso.

Conectează Apple Search Ads la Claude

Pentru a conecta Apple Search Ads la Claude, adaugă Hermoso în Claude ca un conector, apoi conectează contul tău Apple Ads în Hermoso, o singură dată. În Claude, deschide Customize › Connectors › Add custom connector, dă-i numele Hermoso, lipește https://app.hermoso.ai/mcp și aprobă-l cu contul tău Hermoso. Nu există nicio cheie de lipit în Claude. Apoi conectează Apple Ads în Hermoso, la Setări › Conectori, urmând pașii de mai jos de pe această pagină. De atunci, Claude poate apela fiecare unealtă Apple Ads pe care o are Hermoso: cere un raport, o modificare de cuvânt cheie sau o campanie nouă, în cuvinte simple. În Claude Code, în schimb, sunt două comenzi: /plugin marketplace add hermoso-ai/hermoso, apoi /plugin install hermoso@hermoso. Hermoso în Claude are pașii complet.

Conectează Apple Search Ads la ChatGPT

ChatGPT funcționează la fel. În ChatGPT, deschide Plugins, apoi Add › Create MCP App, dă-i numele Hermoso, lipește https://app.hermoso.ai/mcp ca Server URL, lasă Authentication pe OAuth și aprobă-l cu contul tău Hermoso. Dacă Create MCP App nu apare, activează o dată Developer mode din Settings › Plugins › Developer mode. Cu Apple Ads conectat în Hermoso, ChatGPT îți poate extrage raportul de cuvinte cheie, îl poate scrie într-un Google Sheet sau poate pregăti o campanie pe care s-o verifici. Hermoso în ChatGPT explică pas cu pas.

Cursor, Codex și orice alt client MCP

Orice client care vorbește Model Context Protocol ajunge la aceleași unelte, la aceeași adresă. Cursor citește https://app.hermoso.ai/mcp din mcp.json; Codex preia pluginul Hermoso cu codex plugin marketplace add hermoso-ai/hermoso, care rulează aceleași unelte din terminal. Indiferent de clientul pe care îl folosești, credențialele tale Apple nu trec niciodată prin chat. Agentul apelează uneltele Hermoso, iar Hermoso semnează fiecare cerere către Apple cu cheia pe care o păstrează. Pagina MCP Apple Ads listează fiecare unealtă.

Ce să ceri odată ce este conectat

• „Scoate performanța Apple Search Ads din săptămâna trecută, pe cuvinte cheie, și arată-mi cele zece cu cel mai mare cost pe achiziție.”
• „Pune cheltuielile, instalările și CPA din ultimele 30 de zile, pe campanie, într-un Google Sheet nou numit Apple Ads.” (Conectează mai întâi Google Drive.)
• „Ce termeni de căutare au adus instalări în campania mea din SUA în luna aceasta și pe care nu îi licitez încă drept cuvinte cheie exacte?”
• „Adaugă ‘budget planner’ și ‘expense tracker’ ca cuvinte cheie cu potrivire exactă în grupul de reclame Brand, iar ‘jobs’ ca negativ.”
• „Ce cuvinte cheie îmi sugerează Apple pentru aplicația mea și ce pondere din impresii obțin pe cele pe care deja licitez?”
• „Construiește o campanie în pauză pentru aplicația mea în Marea Britanie, cu un buget zilnic de 50 de dolari, apoi arată-mi ce a salvat Apple.”

Citirea unui raport nu atinge niciodată cheltuielile. Orice construiește agentul este creat în pauză, iar comutatorul care pornește cheltuielile așteaptă confirmarea ta explicită.

Mai întâi, lucrul care oprește cei mai mulți

Instrucțiunile Apple spun: „Din interfața Ads, alege Account Settings › API. Lipește cheia în câmpul Public Key.”

Câmpul acela nu există pentru un administrator de cont. Autentifică-te ca administrator în contul tău, deschide Account Settings › API, și ce apare este un tabel intitulat Manage API Access (o listă de furnizori de servicii terți, cu o singură acțiune, Remove Access) și niciun câmp de cheie nicăieri pe pagină. Arată exact ca o funcționalitate lipsă, de aceea oamenii se opresc aici și concluzionează că API-ul nu este disponibil pentru ei.

Este disponibil. Câmpul Public Key aparține unui utilizator care deține un rol API, iar a fi administratorul contului nu este unul. Dialogul de invitație Apple oferă șase roluri, dintre care exact două sunt roluri API:

• API Account Manager: „acces de citire și scriere la toate grupurile de campanii pentru gestionarea API-ului”. Acesta este cel pe care trebuie să-l alegi dacă vrei ca Hermoso să construiască campanii, nu doar să raporteze.
• API Account Read Only: „acces doar de citire la toate grupurile de campanii pentru gestionarea API-ului”. Ajunge pentru raportare și nimic altceva.

Celelalte patru (Account Admin, Account Finance, Account Read Only și Limited Access) nu pot genera deloc credențiale API. Așa că soluția este o invitație pe care ți-o trimiți singur:

1. Deschide Account Settings › User Management și alege Invite Users.
2. Invită o adresă pe care o controlezi (a ta sau una comună, precum ads-api@yourcompany.com, ca credențialul să supraviețuiască oricărei persoane) cu rolul API Account Manager.
3. Acceptă invitația din acea căsuță poștală, apoi autentifică-te în Apple Ads ca acel utilizator.

Acum, Account Settings › API are un câmp Public Key.

Conexiunea, pas cu pas

1. Pornește-o în Hermoso. Setări › Conectori › Apple Ads › Connect. Hermoso generează o cheie de semnare EC P-256 (aceeași cheie prime256v1 pe care ar fi produs-o cele două comenzi openssl ale Apple) și îți arată doar jumătatea publică. Copiaz-o.
2. Dă jumătatea publică Apple-ului. Ca utilizator cu rol API, deschide Account Settings › API, lipește-o în Public Key și apasă Save.
3. Copiază înapoi cele trei id-uri. Apple afișează acum clientId, teamId și keyId deasupra acelui câmp. Toate trei.
4. Finalizează în Hermoso. Lipește cele trei id-uri și salvează. Hermoso schimbă un token cu Apple și citește lista ta de organizații înainte să stocheze ceva, deci un id greșit eșuează chiar acolo, cât timp mai vezi ce ai lipit, nu la primul raport, o oră mai târziu.
5. Alege organizația, dacă credențialele tale acoperă mai multe. Conexiunea este fixată pe cea pe care o alegi.

Dacă ceva nu merge

Nu există câmp Public Key pe pagina API

Ești autentificat ca Account Admin sau cu oricare dintre cele patru roluri non-API. Invită-te ca API Account Manager și autentifică-te ca acel utilizator. Acesta este cel mai frecvent motiv pentru care o conexiune Apple Ads nu se face niciodată.

Apple respinge credențialele

Cele trei id-uri trebuie să aparțină cheii pe care o ține Apple. Recopiază clientId, teamId și keyId chiar de deasupra câmpului Public Key, nu dintr-o cheie mai veche pe care ai înlocuit-o. Dacă tot eșuează, pornește din nou conexiunea în Hermoso: asta generează o pereche de chei nouă, iar tu lipești noua jumătate publică în Apple.

Sesiunea de configurare a expirat

Hermoso ține cheia privată generată timp de 24 de ore, cât te duci să lipești jumătatea publică în Apple. După aceea dispare, intenționat. Pornește din nou conexiunea și lipește noua cheie publică.

Am generat deja o cheie cu openssl

Atunci folosește-o. Lipește cheia ta privată EC P-256 existentă când te conectezi, în loc să o iei pe cea a Hermoso, iar cheia publică deja prezentă în contul tău Apple continuă să funcționeze. Trebuie să fie o cheie EC P-256 (prime256v1). Apple nu acceptă nicio altă curbă.

Gestionez mai multe organizații Apple Ads

Conectează fiecare într-un profil Hermoso propriu. O conexiune este fixată pe o singură organizație, ceea ce împiedică ajungerea unei campanii a unei agenții în contul greșit al clientului.

Ce poate face conectorul Apple Search Ads

Construiește: 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.

Citește: list_apple_ads_campaigns (stare, starea de difuzare, bugetul zilnic și total, țările în care rulează o campanie și motivul spus de Apple atunci când nu poate rula), list_apple_ads_ad_groups (oferta implicită și dacă Search Match-ul Apple este activ), list_apple_ads_keywords (targetare și negative, cu tipul de potrivire și oferta), apple_ads_report (impresii, atingeri, instalări, cheltuieli, TTR, CPT și CPA la nivel de campanie, grup de reclame, cuvânt cheie, termen de căutare sau reclamă) și list_apple_ads_orgs.

Totul este apelabil din Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes sau din orice alt client MCP, și din studioul web. Este același motor, indiferent de drum. Vezi prezentarea MCP sau referința uneltelor de reclame.

Și mai mult: construiește creative și reclame (create_apple_ads_creative, create_apple_ads_ad), încarcă până la 1.000 de cuvinte cheie într-un singur apel (bulk_apple_ads_keywords) și citește datele proprii ale Apple: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity și apple_ads_change_history. Fiecare dintre ele poate fi apelată din același chat.

Exportă date din Apple Search Ads

Aceeași conexiune raportează. apple_ads_report extrage performanța pe campanie, grup de reclame, reclamă, cuvânt cheie și termen de căutare, fie ca totaluri, fie ca serie orară, zilnică, săptămânală sau lunară, până la 5.000 de rânduri pe pagină. Citirea unui raport nu atinge niciodată cheltuielile. Unde ajung rândurile mai departe depinde de tine, iar cele trei locuri cele mai comune sunt mai jos. Ghidul complet este Exportă date din Apple Search Ads.

Conectează Apple Search Ads la Google Sheets

Conectează Google Drive lângă Apple Ads (o singură autorizare Google acoperă Drive, Sheets și Docs), apoi cere agentului tău să pună raportul într-un sheet. Acesta apelează apple_ads_report, apoi create_sheet pentru o foaie de calcul nouă sau append_to_sheet ca să adauge rândurile din săptămâna aceasta la una existentă. Hermoso folosește scope-ul Google drive.file, deci ajunge doar la fișierele pe care le-a creat sau pe care le alegi tu. Pas cu pas: Conectează Apple Search Ads la Google Sheets.

Exportă Apple Search Ads în Looker Studio

Hermoso nu are un conector nativ pentru Looker Studio. Nu are nevoie de unul: Looker Studio citește Google Sheets cu propriul conector integrat, deci foaia de mai sus este puntea. Adaugă foaia o singură dată ca sursă de date Google Sheets, construiește tabloul, iar fiecare adăugare săptămânală apare la următoarea reîmprospătare. Power BI și Tableau citesc aceeași foaie în același fel. Pașii pentru Looker Studio.

Exportă Apple Search Ads în JSON

Pentru rândurile brute, apelează unealta prin API-ul REST Hermoso cu o cheie API: POST https://app.hermoso.ai/v1/tools/apple_ads_report cu argumentele raportului ca body JSON, și citești rândurile din data.rows din răspuns. Din terminal, npx -y hermoso call apple_ads_report --json '{...}' --structured afișează același rezultat ca JSON. Un exemplu complet de cerere.

Întrebări frecvente

Cum conectez Apple Search Ads la Claude?

Adaugă Hermoso în Claude ca un conector personalizat, cu adresa https://app.hermoso.ai/mcp, și aprobă-l cu contul tău Hermoso, apoi conectează Apple Ads în Hermoso la Setări › Conectori. Claude poate apoi să raporteze, să editeze și să construiască campaniile tale Apple Search Ads prin uneltele Apple Ads ale Hermoso.

Poate ChatGPT să-mi citească datele Apple Search Ads?

Da. Adaugă https://app.hermoso.ai/mcp în ChatGPT, la Plugins › Add › Create MCP App, și conectează Apple Ads în Hermoso. ChatGPT poate apoi să extragă impresii, atingeri, instalări, cheltuieli, TTR, CPT și CPA pe campanie, grup de reclame, reclamă, cuvânt cheie sau termen de căutare, și poate scrie rândurile într-un Google Sheet.

Există un server MCP pentru Apple Search Ads?

Da. Serverul MCP găzduit de Hermoso, la https://app.hermoso.ai/mcp, expune întregul set de unelte Apple Ads către Claude, ChatGPT, Cursor, Codex sau orice client MCP: raportare, campanii, grupuri de reclame, cuvinte cheie și negative, creative și reclame, plus sugestiile de cuvinte cheie ale Apple. Tot ce construiește este creat în pauză.

De ce nu există câmp Public Key pe pagina API Apple Ads?

Pentru că ești autentificat ca Account Admin. Apple afișează acel câmp doar unui utilizator cu rol API. Un administrator vede în schimb un tabel „Manage API Access” cu furnizori de servicii terți, fără niciun câmp de cheie pe pagină. Invită-te ca API Account Manager la Account Settings › User Management, autentifică-te ca acel utilizator, și câmpul apare.

Ce rol Apple Ads îmi trebuie?

API Account Manager, dacă vrei ca Hermoso să construiască campanii, grupuri de reclame și cuvinte cheie. Apple îl descrie ca „acces de citire și scriere la toate grupurile de campanii pentru gestionarea API-ului”. API Account Read Only ajunge dacă vrei doar raportare. Celelalte patru roluri oferite de Apple (Account Admin, Account Finance, Account Read Only și Limited Access) nu pot genera deloc credențiale API.

Trebuie să rulez openssl?

Nu. Instrucțiunile Apple îți dau două comenzi openssl; Hermoso generează pentru tine perechea de chei EC P-256 și îți arată doar jumătatea publică. Jumătatea privată este cea care semnează cererile tale, iar tu nu o vezi, nu o lipești și nu o stochezi. Dacă ai deja o cheie de la alt instrument, o poți aduce pe aceea.

Costă ceva conectarea Apple Ads sau riscă cheltuieli?

Nu. Citirile se pot apela gratuit, iar fiecare obiect pe care îl creează Hermoso este creat în PAUZĂ, fără excepție. Activarea unui obiect este singurul comutator care pornește cheltuieli reale, și cere confirmare explicită.

Ce sunt clientId, teamId și keyId?

Cele trei identificatoare pe care Apple le afișează deasupra câmpului Public Key, după ce salvezi cheia. Ele îl identifică pe utilizatorul tău API în fața Apple; cheia privată dovedește că ești tu. Lipește toate trei înapoi în Hermoso și conexiunea este gata.

Poate o singură conexiune să acopere mai multe organizații Apple Ads?

O conexiune este fixată pe singura organizație pe care o alegi când o faci. Apple tratează un orgId cam ca pe un grup de campanii, deci un singur login poate acoperi mai multe. O agenție cu câte o organizație per client se conectează în profilul Hermoso propriu al fiecăruia.

Trebuie să rotesc cheia la fiecare 180 de zile?

Nu. Apple limitează un secret de client la 180 de zile, motiv pentru care instrucțiunile ei îți cer să notezi o rotație. Hermoso păstrează cheia privată și generează un secret proaspăt, de scurtă durată, pentru fiecare schimb de token, deci nu există nimic într-un fișier de configurare care să expire.

Pot exporta date Apple Search Ads în Google Sheets sau Looker Studio?

Da. Conectează Google Drive lângă Apple Ads, iar agentul tău scrie raportul într-un Google Sheet, cu create_sheet sau append_to_sheet. Hermoso nu are un conector nativ pentru Looker Studio; Looker Studio citește acea foaie cu propriul conector Google Sheets.

Pot primi datele Apple Search Ads ca JSON?

Da. Apelează POST /v1/tools/apple_ads_report pe API-ul Hermoso cu o cheie API și citește data.rows, sau rulează hermoso call apple_ads_report cu --structured din CLI.