Apple Search Ads csatlakoztatása Claude-hoz vagy ChatGPT-hez öt perc alatt

A Hermoso Apple Search Ads csatlakozója összeköti az Apple Ads-fiókodat a Claude-dal, a ChatGPT-vel, a Cursorral, a CLI-vel vagy sima HTTP-n keresztül, így egy ügynök helyetted futtathatja az App Store-keresési hirdetéseidet. Megépíti a kampányt, a hirdetéscsoportot, a célzókulcsszavakat és a negatív kulcsszavakat, visszaolvassa, amit az Apple ténylegesen tárolt, és a teljesítményt is jelenti egészen addig a keresőkifejezésig, amelyet valaki beírt, mielőtt telepítette volna az appot. Minden, amit létrehoz, szüneteltetve jön létre, a költés bekapcsolása pedig külön, kifejezetten megerősített lépés. A jelentések Google Táblázatba, Looker Studio műszerfalra vagy JSON-fájlba mehetnek, az Apple Ads MCP oldala pedig felsorolja mindazt, amire a csatlakozó képes.

A csatlakoztatás körülbelül öt percet vesz igénybe. Nem kell openssl-t futtatnod, és egyetlen Apple-jelszó sem kerül a csevegésbe.

Apple Search Ads csatlakoztatása Claude-hoz

Az Apple Search Ads Claude-hoz kötéséhez vedd fel a Hermoso-t connectorként a Claude-ba, majd csatlakoztasd az Apple Ads-fiókodat a Hermoso-ban egyszer. A Claude-ban nyisd meg a Customize › Connectors › Add custom connector menüt, nevezd el Hermoso-nak, illeszd be a https://app.hermoso.ai/mcp címet, és hagyd jóvá a Hermoso-fiókoddal. Claude-ba nem kell beilleszteni kulcsot. Ezután csatlakoztasd az Apple Ads-et a Hermoso-ban a Beállítások › Csatlakozók menüpont alatt, az alábbi lépésekkel. Innentől Claude minden Apple Ads-eszközt meghívhat, amelyet a Hermoso kínál: kérhetsz jelentést, kulcsszóváltoztatást vagy új kampányt egyszerű szavakkal. Claude Code-ban ehelyett két parancs elég: /plugin marketplace add hermoso-ai/hermoso, majd /plugin install hermoso@hermoso. A Hermoso a Claude-ban oldal tartalmazza a teljes lépéseket.

Apple Search Ads csatlakoztatása ChatGPT-hez

A ChatGPT ugyanígy működik. A ChatGPT-ben nyisd meg a Plugins menüt, majd válaszd az Add › Create MCP App lehetőséget, nevezd el Hermoso-nak, a Server URL mezőbe illeszd be a https://app.hermoso.ai/mcp címet, az Authentication maradjon OAuth, és hagyd jóvá a Hermoso-fiókoddal. Ha a Create MCP App nincs ott, egyszer kapcsold be a Developer mode-ot a Settings › Plugins › Developer mode menüpont alatt. Ha az Apple Ads be van kötve a Hermoso-ban, a ChatGPT le tudja húzni a kulcsszójelentésedet, be tudja írni Google Táblázatba, vagy vázolhat egy kampányt, amelyet te ellenőrizhetsz. A Hermoso a ChatGPT-ben oldal végigvezet a lépéseken.

Cursor, Codex és minden más MCP-kliens

Bármely kliens, amely beszéli a Model Context Protocolt, ugyanazokat az eszközöket éri el ugyanazon a címen. A Cursor a https://app.hermoso.ai/mcp címet az mcp.json fájljából olvassa; a Codex a Hermoso-bővítményt a codex plugin marketplace add hermoso-ai/hermoso paranccsal veszi fel, és ugyanezeket az eszközöket a terminálból hajtja végre. Bármelyik klienst használod, az Apple-hitelesítő adataid nem mennek át a csevegésen. Az ügynök a Hermoso eszközeit hívja, a Hermoso pedig minden kérést aláír Apple felé a birtokában lévő kulccsal. A Apple Ads MCP oldala felsorolja az összes eszközt.

Mit kérdezz, miután csatlakoztattad

• “Húzd le az elmúlt heti Apple Search Ads teljesítményt kulcsszavanként, és mutasd a tíz legmagasabb szerzési költségű (CPA) kulcsszót.”
• “Tedd az elmúlt 30 nap költését, telepítéseit és CPA-ját kampányonként egy új Google Táblázatba, Apple Ads néven.” (Csatlakoztasd előbb a Google Drive-ot.)
• “Mely keresési kifejezések hoztak telepítést az amerikai kampányomban ebben a hónapban, amelyekre még nem licitálok pontos egyezésű kulcsszóként?”
• “Add hozzá a ‘budget planner’ és az ‘expense tracker’ kifejezést pontos egyezésű kulcsszóként a Brand hirdetéscsoportba, a ‘jobs’ szót pedig negatívként.”
• “Milyen kulcsszavakat javasol az Apple az appomhoz, és mekkora részt kapok a megjelenésekből azokon, amelyekre már licitálok?”
• “Építs egy szüneteltetett kampányt az appomhoz az Egyesült Királyságban, napi 50 dolláros kerettel, aztán mutasd meg, mit tárolt el az Apple.”

A jelentés olvasása sosem nyúl a költéshez. Amit az ügynök létrehoz, szüneteltetve jön létre, a költést bekapcsoló kapcsoló pedig a te kifejezett megerősítésedre vár.

Először a dolog, amely a legtöbb embert megállítja

Apple saját útmutatója szerint: “Az Ads UI-ban válaszd ki az Account Settings › API menüpontot. Illeszd be a kulcsot a Public Key mezőbe.”

Ez a mező nem létezik Account Admin szerepkörben. Jelentkezz be adminisztrátorként a saját fiókodba, nyisd meg az Account Settings › API oldalt, és egy Manage API Access feliratú táblázat jelenik meg (harmadik féltől származó szolgáltatók listája egyetlen Remove Access művelettel), kulcsmező pedig sehol nincs az oldalon. Úgy néz ki, mintha hiányozna a funkció, ezért sokan itt megállnak, és arra jutnak, hogy nem érhetik el az API-t.

Pedig elérhető. A Public Key mezőt az látja, aki API-szerepkörrel rendelkezik, a fiók adminisztrátori szerep ehhez nem elég. Apple meghívó-ablaka hat szerepkört kínál, és ebből pontosan kettő API-szerepkör:

• API Account Manager: “teljes olvasási és írási hozzáférés minden kampánycsoporthoz az API-kezeléshez”. Ezt válaszd, ha azt szeretnéd, hogy a Hermoso kampányokat építsen, ne csak jelentsen róluk.
• API Account Read Only: “csak olvasási hozzáférés minden kampánycsoporthoz az API-kezeléshez”. Jelentésekhez elég, mást nem tud.

A másik négy (Account Admin, Account Finance, Account Read Only és Limited Access) egyáltalán nem tud API-hitelesítő adatokat létrehozni. A megoldás tehát egy meghívó, amelyet magadnak küldesz:

1. Nyisd meg az Account Settings › User Management oldalt, és válaszd az Invite Users lehetőséget.
2. Hívj meg egy címet, amelyet te irányítasz (a sajátodat, vagy egy közös címet, például ads-api@yourcompany.com, hogy a hitelesítő adat ne múljon el egyetlen személlyel), az API Account Manager szerepkörrel.
3. Fogadd el a meghívást abból a postafiókból, majd jelentkezz be az Apple Ads-be mint ez a felhasználó.

Most az Account Settings › API oldalon van Public Key mező.

A csatlakoztatás lépésről lépésre

1. Indítsd el a Hermoso-ban. Beállítások › Csatlakozók › Apple Ads › Connect. A Hermoso generál egy EC P-256 aláírókulcsot (ugyanazt a prime256v1 kulcsot, amelyet Apple két openssl parancsa állított volna elő), és csak a nyilvános felét mutatja. Másold ki.
2. Add oda az Apple-nek a nyilvános felet. Mint API-szerepkörös felhasználó, nyisd meg az Account Settings › API oldalt, illeszd be a Public Key mezőbe, és kattints a Save gombra.
3. Másold vissza a három azonosítót. Apple most kiírja a clientId, teamId és keyId azonosítót a Public Key mező fölé. Mind a hármat.
4. Fejezd be a Hermoso-ban. Illeszd be a három azonosítót, és mentsd. A Hermoso tokent vált Apple-lel, és lekéri a szervezeteid listáját, mielőtt bármit tárolna, így az elgépelt azonosító már itt meghiúsul, amíg még látod, mit illesztettél be, és nem majd az első jelentésednél, egy órával később.
5. Válaszd ki a szervezetet, ha a hitelesítő adataid több szervezetet is lefednek. A kapcsolat a kiválasztottra lesz kötve.

Ha valami nem sikerül

Nincs Public Key mező az API oldalon

Account Admin vagy bármelyik négy nem API-szerepkörrel vagy bejelentkezve. Hívd meg magadat API Account Manager szerepkörrel, és jelentkezz be ezzel a felhasználóval (lásd fent). Ez a leggyakoribb oka annak, hogy egy Apple Ads-kapcsolat soha nem jön létre.

Apple elutasítja a hitelesítő adatokat

A három azonosítónak ahhoz a kulcshoz kell tartoznia, amelyet az Apple tart. Másold újra a clientId, teamId és keyId azonosítót közvetlenül a Public Key mező fölül, ne egy régebbi, lecserélt kulcsból. Ha még mindig nem működik, indítsd újra a kapcsolatot a Hermoso-ban: ez új kulcspárt hoz létre, és az új nyilvános felet illeszted be Apple-be.

A beállítási munkamenet lejárt

A Hermoso 24 órán át tartja a generált privát kulcsot, amíg a nyilvános felet beilleszted Apple-be. Utána szándékosan eltűnik. Indítsd újra a kapcsolatot, és illeszd be az új nyilvános kulcsot.

Már generáltam kulcsot openssl-lel

Akkor használd. Csatlakozáskor illeszd be a meglévő EC P-256 privát kulcsodat a Hermoso kulcsa helyett, és az Apple-fiókodban már meglévő nyilvános kulcs tovább működik. EC P-256 (prime256v1) kulcsnak kell lennie. Apple más görbét nem fogad el.

Több Apple Ads-szervezetet kezelek

Mindegyiket külön Hermoso-profilban kösd be. A kapcsolat egyetlen szervezethez tartozik, ettől nem kerülhet egy ügynökség kampánya rossz ügyfél fiókjába.

Amit az Apple Search Ads csatlakozó tud

Építés: 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.

Olvasás: list_apple_ads_campaigns (állapot, kiszolgálási állapot, napi és teljes keret, azok az országok, ahol a kampány fut, és Apple saját indoka, ha egy kampány nem futhat), list_apple_ads_ad_groups (alapértelmezett licit, és hogy be van-e kapcsolva az Apple Search Match), list_apple_ads_keywords (célzás és negatív, egyezéstípussal és licittel), apple_ads_report (megjelenések, koppintások, telepítések, költés, TTR, CPT és CPA kampány-, hirdetéscsoport-, hirdetés-, kulcsszó- vagy keresési kifejezés szinten) és list_apple_ads_orgs.

Mindez hívható Claude-ból, Claude Code-ból, Codexből, Cursorból, Clineból, OpenClaw-ból, Hermesből vagy bármely más MCP-kliensből, és a webes stúdióból is. Ugyanaz a motor fut mindkét úton. Lásd az MCP áttekintést vagy az hirdetési eszközreferenciát.

És még: létrehoz kreatívokat és hirdetéseket (create_apple_ads_creative, create_apple_ads_ad), egy hívással akár 1000 kulcsszót is betölt (bulk_apple_ads_keywords), és Apple saját adatait olvassa: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity és apple_ads_change_history. Mindegyik elérhető ugyanabból a csevegésből.

Adatok exportálása az Apple Search Ads-ből

Ugyanez a kapcsolat jelent. Az apple_ads_report lehúzza a kampány-, hirdetéscsoport-, hirdetés-, kulcsszó- és keresési kifejezés szintű teljesítményt (megjelenések, koppintások, telepítések, költés, koppintási arány, koppintásonkénti költség és szerzésenkénti költség), összesítve vagy óránkénti, napi, heti vagy havi sorozatként, oldalanként legfeljebb 5000 sorral. A jelentés olvasása sosem nyúl a költéshez. Hogy a sorok hová kerülnek tovább, az rád van bízva, a három leggyakoribb helyet lent találod. A teljes útmutató: Adatok exportálása az Apple Search Ads-ből.

Apple Search Ads csatlakoztatása Google Táblázatokhoz

Csatlakoztasd a Google Drive-ot az Apple Ads mellé (egyetlen Google-engedély fedi a Drive-ot, a Táblázatokat és a Dokumentumokat), és kérd meg az ügynököt, hogy tegye a jelentést táblázatba. Meghívja az apple_ads_report eszközt, majd a create_sheet-et új táblázathoz, vagy az append_to_sheet-et, hogy a heti sorok egy meglévőhöz kerüljenek. A Hermoso a Google drive.file hatókörét használja, így csak azokat a fájlokat éri el, amelyeket ő hozott létre, vagy te választottál ki. Lépésről lépésre: Apple Search Ads csatlakoztatása Google Táblázatokhoz.

Apple Search Ads exportálása Looker Studióba

A Hermoso-nak nincs natív Looker Studio-csatlakozója. A Looker Studio a Google Táblázatokat a saját beépített csatlakozójával olvassa, így a fenti táblázat a híd: egyszer add hozzá adatforrásként Google Táblázatok típussal, építsd meg a műszerfalat, és minden heti hozzáfűzés a következő frissítésnél megjelenik. A Power BI és a Tableau ugyanígy olvassa ugyanazt a táblázatot. A Looker Studio lépései.

Apple Search Ads exportálása JSON-ba

Ha nyers sorokat szeretnél, hívd az eszközt a Hermoso REST API-n keresztül API-kulccsal: POST https://app.hermoso.ai/v1/tools/apple_ads_report a jelentés argumentumaival JSON-törzsként, a sorokat pedig a válasz data.rows mezőjéből olvashatod ki. Terminálból a npx -y hermoso call apple_ads_report --json '{...}' --structured ugyanazt az eredményt adja JSON-ként. Teljes példakérés.

Gyakori kérdések

Hogyan csatlakoztatom az Apple Search Ads-et Claude-hoz?

Vedd fel a Hermoso-t egyedi connectorként Claude-ban a https://app.hermoso.ai/mcp címmel, és hagyd jóvá a Hermoso-fiókoddal, majd csatlakoztasd az Apple Ads-et a Hermoso-ban a Beállítások › Csatlakozók menüpont alatt. Claude ezután jelenthet, szerkeszthet és építhet Apple Search Ads-kampányokat a Hermoso Apple Ads-eszközein keresztül.

Olvashatja a ChatGPT az Apple Search Ads adataimat?

Igen. Vedd fel a https://app.hermoso.ai/mcp címet a ChatGPT-ben a Plugins › Add › Create MCP App menüponton, és csatlakoztasd az Apple Ads-et a Hermoso-ban. A ChatGPT ezután le tudja húzni a megjelenéseket, koppintásokat, telepítéseket, költést, TTR-t, CPT-t és CPA-t kampányonként, hirdetéscsoportonként, hirdetésenként, kulcsszavanként vagy keresési kifejezésenként, és a sorokat Google Táblázatba írhatja.

Van Apple Search Ads MCP-szerver?

Van. A Hermoso hostolt MCP-szervere a https://app.hermoso.ai/mcp címen a teljes Apple Ads-eszközkészletet elérhetővé teszi Claude, ChatGPT, Cursor, Codex vagy bármely MCP-kliens számára: jelentések, kampányok, hirdetéscsoportok, kulcsszavak és negatívok, kreatívok és hirdetések, valamint Apple kulcsszó-javaslatai. Minden, amit létrehoz, szüneteltetve jön létre.

Miért nincs Public Key mező az Apple Ads API oldalán?

Mert Account Admin szerepkörben vagy bejelentkezve. Apple csak az API-szerepkörrel rendelkező felhasználónak jeleníti meg ezt a mezőt. Az adminisztrátor helyette egy “Manage API Access” táblázatot lát harmadik féltől származó szolgáltatókkal, és sehol nincs kulcsmező az oldalon. Hívd meg magadat API Account Managerként az Account Settings › User Management menüben, jelentkezz be ezzel a felhasználóval, és a mező megjelenik.

Melyik Apple Ads-szerepkörre van szükségem?

API Account Manager, ha azt szeretnéd, hogy a Hermoso kampányokat, hirdetéscsoportokat és kulcsszavakat építsen. Apple így írja le: “teljes olvasási és írási hozzáférés minden kampánycsoporthoz az API-kezeléshez”. API Account Read Only elég, ha csak jelentéseket szeretnél. Apple másik négy szerepköre (Account Admin, Account Finance, Account Read Only és Limited Access) egyáltalán nem tud API-hitelesítő adatokat létrehozni.

Kell openssl-t futtatnom?

Nem. Apple saját útmutatója két openssl-parancsot ad; a Hermoso maga generálja az EC P-256 kulcspárt, és csak a nyilvános felét mutatja. A privát fél írja alá a kéréseidet, de te soha nem látod, nem illeszted be és nem tárolod. Ha már van kulcsod egy másik eszközből, azt is behozhatod.

Kerül pénzbe az Apple Ads csatlakoztatása, vagy kockáztat költést?

Nem. Az olvasások ingyen hívhatók, és minden objektum, amelyet a Hermoso létrehoz, szüneteltetve jön létre, felülbírálás nélkül. Az objektum engedélyezése az egyetlen kapcsoló, amely élesíti a költést, és ehhez kifejezett megerősítés kell.

Mik a clientId, teamId és keyId?

A három azonosító, amelyet Apple a Public Key mező fölé ír ki, miután elmentetted a kulcsot. Ezek azonosítják az API-felhasználódat Apple előtt; a privát kulcs bizonyítja, hogy te vagy az. Illeszd vissza mind a hármat a Hermoso-ba, és a kapcsolat kész.

Lefedhet egy kapcsolat több Apple Ads-szervezetet?

Egy kapcsolat ahhoz az egy szervezethez van kötve, amelyet a létrehozáskor választasz ki. Apple az orgId-t kicsit úgy kezeli, mint egy kampánycsoportot, így egy bejelentkezés több szervezetet is lefedhet. Az ügynökség, amelynek ügyfelenként van egy szervezete, mindegyiket külön Hermoso-profilban köti be.

Kell 180 naponként rotálnom a kulcsot?

Nem. Apple a kliens-titkot 180 napra korlátozza, ezért írja elő saját útmutatója a rotáció naptárba vételét. A Hermoso tartja a privát kulcsot, és minden tokencseréhez friss, rövid életű titkot ír alá, így nincs a konfigurációs fájlban semmi, ami lejárhatna.

Exportálhatom az Apple Search Ads adatait Google Táblázatba vagy Looker Studióba?

Igen. Csatlakoztasd a Google Drive-ot az Apple Ads mellé, és az ügynököd a jelentést Google Táblázatba írja a create_sheet vagy az append_to_sheet eszközzel. A Hermoso-nak nincs natív Looker Studio-csatlakozója; a Looker Studio a táblázatot a saját Google Táblázat-csatlakozójával olvassa.

Kaphatom az Apple Search Ads adatait JSON-ként?

Igen. Hívd a POST /v1/tools/apple_ads_report végpontot a Hermoso API-n API-kulccsal, és olvasd a data.rows mezőt, vagy futtasd a hermoso call apple_ads_report parancsot a --structured kapcsolóval a CLI-ből.