Połącz Apple Search Ads z Claude lub ChatGPT w pięć minut

Łącznik Hermoso Apple Search Ads podpina Twoje konto Apple Ads do Claude, ChatGPT, Cursora, CLI lub zwykłego HTTP, dzięki czemu agent może prowadzić za Ciebie reklamy wyszukiwania w App Store. Buduje kampanię, grupę reklam, słowa kluczowe do kierowania i wykluczenia, odczytuje z powrotem to, co Apple faktycznie zapisało, i raportuje wyniki aż do wyszukiwanej frazy, którą ktoś wpisał przed instalacją. Wszystko, co tworzy, powstaje wstrzymane, a włączenie wydatków to osobny krok, wymagający wyraźnego potwierdzenia. Raporty mogą trafić do arkusza Google, pulpitu Looker Studio albo pliku JSON, a strona łącznika Apple Ads MCP wymienia wszystko, co łącznik potrafi.

Połączenie zajmuje około pięciu minut. Nie będziesz uruchamiać openssl, a hasło do Apple nigdy nie trafia do Hermoso.

Połącz Apple Search Ads z Claude

Żeby połączyć Apple Search Ads z Claude, dodaj Hermoso do Claude jako łącznik, a potem połącz swoje konto Apple Ads w Hermoso raz. W Claude otwórz Customize › Connectors › Add custom connector, nazwij go Hermoso, wklej https://app.hermoso.ai/mcp i zatwierdź swoim kontem Hermoso. Nie ma żadnego klucza do wklejenia w Claude. Następnie połącz Apple Ads w Hermoso w Ustawienia › Łączniki, według kroków niżej na tej stronie. Od tego momentu Claude może wywołać każde narzędzie Apple Ads, jakie ma Hermoso: poproś zwykłymi słowami o raport, zmianę słowa kluczowego albo nową kampanię. W Claude Code wystarczą dwa polecenia: /plugin marketplace add hermoso-ai/hermoso, a potem /plugin install hermoso@hermoso. Hermoso w Claude zawiera pełne kroki.

Połącz Apple Search Ads z ChatGPT

ChatGPT działa tak samo. W ChatGPT otwórz Plugins, a potem Add › Create MCP App, nazwij go Hermoso, wklej https://app.hermoso.ai/mcp jako Server URL, zostaw Authentication na OAuth i zatwierdź swoim kontem Hermoso. Jeśli nie widzisz Create MCP App, włącz raz Developer mode w Settings › Plugins › Developer mode. Gdy Apple Ads jest połączone w Hermoso, ChatGPT może pobrać raport słów kluczowych, zapisać go w arkuszu Google albo przygotować kampanię do sprawdzenia przez Ciebie. Hermoso w ChatGPT pokazuje to krok po kroku.

Cursor, Codex i każdy inny klient MCP

Każdy klient, który mówi protokołem Model Context Protocol, dociera do tych samych narzędzi pod tym samym adresem. Cursor czyta https://app.hermoso.ai/mcp z pliku mcp.json; Codex przyjmuje wtyczkę Hermoso poleceniem codex plugin marketplace add hermoso-ai/hermoso, które uruchamia te same narzędzia z terminala. Niezależnie od klienta Twoje dane logowania do Apple nigdy nie przechodzą przez czat. Agent wywołuje narzędzia Hermoso, a Hermoso podpisuje każde zapytanie do Apple kluczem, który sam przechowuje. Strona Apple Ads MCP wymienia każde narzędzie.

O co pytać po połączeniu

• “Pokaż wyniki Apple Search Ads z zeszłego tygodnia według słowa kluczowego i wypisz dziesięć o najwyższym kosztem pozyskania.”
• “Wpisz wydatki, instalacje i CPA z ostatnich 30 dni według kampanii do nowego arkusza Google o nazwie Apple Ads.” (Najpierw połącz Dysk Google.)
• “Które frazy wyszukiwania przyniosły instalacje w mojej kampanii w USA w tym miesiącu, a na których jeszcze nie licytuję jako na dokładnych słowach kluczowych?”
• “Dodaj ‘budget planner’ i ‘expense tracker’ jako słowa kluczowe o dopasowaniu dokładnym w grupie reklam Brand, a ‘jobs’ jako wykluczenie.”
• “Jakie słowa kluczowe Apple sugeruje dla mojej aplikacji i jaki udział w wyświetleniach mam w tych, na które już licytuję?”
• “Zbuduj wstrzymaną kampanię dla mojej aplikacji w Wielkiej Brytanii z dziennym budżetem 50 dolarów, a potem pokaż, co Apple zapisało.”

Czytanie raportu nigdy nie dotyka wydatków. Wszystko, co zbuduje agent, powstaje wstrzymane, a przełącznik włączający wydatki czeka na Twoje wyraźne potwierdzenie.

Najpierw to, na czym utyka większość osób

Instrukcje Apple mówią: „W interfejsie reklam wybierz Account Settings › API. Wklej klucz w pole Public Key.”

To pole nie istnieje dla administratora konta. Zaloguj się jako administrator na swoim koncie, otwórz Account Settings › API, a zamiast pola na klucz zobaczysz tabelę Manage API Access (listę zewnętrznych dostawców usług z jedną akcją Remove Access) i nigdzie na stronie żadnego pola na klucz. Wygląda to jak brakująca funkcja, dlatego ludzie się zatrzymują i uznają, że API jest dla nich niedostępne.

Jest dostępne. Pole Public Key należy do użytkownika z rolą API, a bycie administratorem konta do takich ról nie należy. Okno zaproszenia Apple oferuje sześć ról, z czego dokładnie dwie to role API:

• API Account Manager: “dostęp do odczytu i zapisu do wszystkich grup kampanii na potrzeby zarządzania API”. Wybierz tę, jeśli chcesz, żeby Hermoso budowało kampanie, a nie tylko raportowało.
• API Account Read Only: “dostęp tylko do odczytu do wszystkich grup kampanii na potrzeby zarządzania API”. Wystarczy do raportów i do niczego więcej.

Pozostałe cztery (Account Admin, Account Finance, Account Read Only i Limited Access) w ogóle nie mogą tworzyć danych uwierzytelniających API. Rozwiązaniem jest więc zaproszenie wysłane do siebie:

1. Otwórz Account Settings › User Management i wybierz Invite Users.
2. Zaproś adres, który kontrolujesz (własny albo wspólny, np. ads-api@yourcompany.com, żeby dane uwierzytelniające przetrwały odejście jednej osoby), z rolą API Account Manager.
3. Zaakceptuj zaproszenie z tej skrzynki, a potem zaloguj się do Apple Ads jako ten użytkownik.

Teraz w Account Settings › API jest pole Public Key.

Połączenie krok po kroku

1. Zacznij w Hermoso. Ustawienia › Łączniki › Apple Ads › Połącz. Hermoso generuje klucz podpisujący EC P-256 (ten sam klucz prime256v1, który dałyby dwa polecenia openssl Apple) i pokazuje Ci tylko połowę publiczną. Skopiuj ją.
2. Przekaż połowę publiczną Apple. Jako użytkownik z rolą API otwórz Account Settings › API, wklej ją w pole Public Key i zapisz.
3. Skopiuj z powrotem trzy identyfikatory. Apple wyświetla teraz clientId, teamId i keyId nad tym polem. Wszystkie trzy.
4. Dokończ w Hermoso. Wklej trzy identyfikatory i zapisz. Hermoso wymienia token z Apple i odczytuje listę Twoich organizacji zanim cokolwiek zapisze, więc źle przepisany identyfikator zawiedzie od razu, gdy wciąż widzisz, co wkleiłeś, a nie przy pierwszym raporcie godzinę później.
5. Wybierz organizację, jeśli Twoje dane obejmują więcej niż jedną. Połączenie jest przypięte do wybranej.

Gdy coś pójdzie nie tak

Na stronie API nie ma pola Public Key

Jesteś zalogowany jako Account Admin albo w jednej z czterech ról innych niż API. Zaproś siebie jako API Account Manager i zaloguj się jako ten użytkownik (patrz wyżej). To najczęstszy powód, dla którego połączenie Apple Ads nigdy nie dochodzi do skutku.

Apple odrzuca dane uwierzytelniające

Te trzy identyfikatory muszą należeć do klucza, który Apple ma zapisany. Skopiuj ponownie clientId, teamId i keyId z miejsca tuż nad polem Public Key, a nie ze starego klucza, który wymieniłeś. Jeśli nadal nie działa, zacznij połączenie w Hermoso od nowa: to wygeneruje nową parę kluczy, a Ty wklejasz nową połowę publiczną do Apple.

Sesja konfiguracji wygasła

Hermoso przechowuje wygenerowany klucz prywatny przez 24 godziny, podczas gdy Ty idziesz wkleić jego połowę publiczną do Apple. Po tym czasie jest on celowo usuwany. Zacznij połączenie od nowa i wklej nowy klucz publiczny.

Wygenerowałem już klucz w openssl

W takim razie go użyj. Przy łączeniu wklej swój istniejący klucz prywatny EC P-256 zamiast klucza Hermoso, a klucz publiczny już zapisany na Twoim koncie Apple dalej będzie działał. Musi to być klucz EC P-256 (prime256v1). Apple nie akceptuje żadnej innej krzywej.

Zarządzam kilkoma organizacjami Apple Ads

Połącz każdą z nich w osobnym profilu Hermoso. Połączenie jest przypięte do jednej organizacji, dzięki czemu kampania agencji nie trafi na konto niewłaściwego klienta.

Co może łącznik Apple Search Ads

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

Odczyt: list_apple_ads_campaigns (status, stan wyświetlania, dzienny i całkowity budżet, kraje, w których działa kampania, oraz powód podany przez Apple, gdy nie może działać), list_apple_ads_ad_groups (domyślna stawka i to, czy włączone jest Search Match Apple), list_apple_ads_keywords (kierowanie i wykluczenia, z typem dopasowania i stawką), apple_ads_report (wyświetlenia, kliknięcia, instalacje, wydatki, TTR, CPT i CPA na poziomie kampanii, grupy reklam, słowa kluczowego, frazy wyszukiwania lub reklamy) oraz list_apple_ads_orgs.

Wszystko to można wywołać z Claude, Claude Code, Codex, Cursora, Cline, OpenClaw, Hermes albo dowolnego innego klienta MCP, a także z aplikacji webowej. Silnik jest ten sam. Zobacz przegląd MCP lub dokumentację narzędzi reklamowych.

I więcej: narzędzia tworzą kreacje i reklamy (create_apple_ads_creative, create_apple_ads_ad), wgrywają do 1000 słów kluczowych jednym wywołaniem (bulk_apple_ads_keywords) i odczytują dane samego Apple: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity i apple_ads_change_history. Każde z nich można wywołać z tego samego czatu.

Eksport danych z Apple Search Ads

To samo połączenie służy do raportowania. apple_ads_report pobiera wyniki kampanii, grup reklam, reklam, słów kluczowych i fraz wyszukiwania (wyświetlenia, kliknięcia, instalacje, wydatki, współczynnik kliknięć, koszt kliknięcia i koszt pozyskania), jako sumy albo jako szereg godzinowy, dzienny, tygodniowy lub miesięczny, do 5000 wierszy na stronę. Czytanie raportu nigdy nie dotyka wydatków. Dokąd trafiają wiersze dalej, decydujesz Ty, a trzy najczęstsze miejsca są poniżej. Pełny przewodnik: Eksport danych z Apple Search Ads.

Połącz Apple Search Ads z Arkuszami Google

Połącz Dysk Google obok Apple Ads (jedna autoryzacja Google obejmuje Dysk, Arkusze i Dokumenty), a potem poproś agenta, żeby wpisał raport do arkusza. Wywołuje on apple_ads_report, a następnie create_sheet dla nowego arkusza albo append_to_sheet, żeby dopisać wiersze z tego tygodnia do istniejącego. Hermoso używa zakresu Google drive.file, więc sięga tylko do plików, które sam utworzył albo które wybrałeś. Krok po kroku: Połącz Apple Search Ads z Arkuszami Google.

Eksport Apple Search Ads do Looker Studio

Hermoso nie ma natywnego łącznika Looker Studio. Looker Studio czyta Arkusze Google własnym łącznikiem, więc arkusz powyżej jest mostem: dodaj go raz jako źródło danych Arkuszy Google, zbuduj pulpit, a każde cotygodniowe dopisanie pojawi się przy następnym odświeżeniu. Power BI i Tableau czytają ten sam arkusz w ten sam sposób. Kroki dla Looker Studio.

Eksport Apple Search Ads do JSON

Po surowe wiersze wywołaj narzędzie przez REST API Hermoso kluczem API: POST https://app.hermoso.ai/v1/tools/apple_ads_report z argumentami raportu jako treścią JSON, a wiersze odczytaj z data.rows w odpowiedzi. Z terminala npx -y hermoso call apple_ads_report --json '{...}' --structured wypisuje ten sam wynik jako JSON. Pełny przykład zapytania.

Najczęściej zadawane pytania

Jak połączyć Apple Search Ads z Claude?

Dodaj Hermoso do Claude jako własny łącznik z adresem https://app.hermoso.ai/mcp i zatwierdź swoim kontem Hermoso, a potem połącz Apple Ads w Hermoso w Ustawienia › Łączniki. Claude może wtedy tworzyć raporty, edytować i budować kampanie Apple Search Ads przez narzędzia Apple Ads w Hermoso.

Czy ChatGPT może czytać moje dane Apple Search Ads?

Tak. Dodaj https://app.hermoso.ai/mcp w ChatGPT w Plugins › Add › Create MCP App i połącz Apple Ads w Hermoso. ChatGPT może wtedy pobrać wyświetlenia, kliknięcia, instalacje, wydatki, TTR, CPT i CPA według kampanii, grupy reklam, reklamy, słowa kluczowego lub frazy wyszukiwania oraz wpisać wiersze do arkusza Google.

Czy istnieje serwer MCP dla Apple Search Ads?

Tak. Hostowany serwer MCP Hermoso pod adresem https://app.hermoso.ai/mcp udostępnia pełen zestaw narzędzi Apple Ads dla Claude, ChatGPT, Cursora, Codex lub dowolnego klienta MCP: raportowanie, kampanie, grupy reklam, słowa kluczowe i wykluczenia, kreacje i reklamy oraz sugestie słów kluczowych Apple. Wszystko, co zbuduje, powstaje wstrzymane.

Dlaczego na stronie API Apple Ads nie ma pola Public Key?

Bo jesteś zalogowany jako Account Admin. Apple pokazuje to pole tylko użytkownikowi z rolą API. Administrator widzi zamiast tego tabelę “Manage API Access” z zewnętrznymi dostawcami usług, bez pola na klucz nigdzie na stronie. Zaproś siebie jako API Account Manager w Account Settings › User Management, zaloguj się jako ten użytkownik, a pole się pojawi.

Jakiej roli Apple Ads potrzebuję?

API Account Manager, jeśli chcesz, żeby Hermoso budowało kampanie, grupy reklam i słowa kluczowe. Apple opisuje ją jako “dostęp do odczytu i zapisu do wszystkich grup kampanii na potrzeby zarządzania API”. API Account Read Only wystarczy, jeśli chcesz tylko raportów. Pozostałe cztery role, które oferuje Apple (Account Admin, Account Finance, Account Read Only i Limited Access), w ogóle nie mogą tworzyć danych uwierzytelniających API.

Czy muszę uruchamiać openssl?

Nie. Instrukcje Apple dają Ci dwa polecenia openssl; Hermoso generuje za Ciebie parę kluczy EC P-256 i pokazuje tylko połowę publiczną. Połowa prywatna podpisuje Twoje zapytania, a Ty nigdy jej nie widzisz, nie wklejasz ani nie przechowujesz. Jeśli masz już klucz z innego narzędzia, możesz go przynieść zamiast tego.

Czy połączenie Apple Ads kosztuje coś albo ryzykuje wydatki?

Nie. Odczyty można wywoływać bez opłat, a każdy obiekt, który Hermoso tworzy, powstaje WSTRZYMANY, bez możliwości obejścia. Włączenie obiektu to jedyny przełącznik uruchamiający prawdziwe wydatki i wymaga wyraźnego potwierdzenia.

Czym są clientId, teamId i keyId?

Trzy identyfikatory, które Apple wyświetla nad polem Public Key po zapisaniu klucza. Identyfikują Twojego użytkownika API wobec Apple; klucz prywatny dowodzi, że to Ty. Wklej wszystkie trzy z powrotem w Hermoso i połączenie jest gotowe.

Czy jedno połączenie może obejmować kilka organizacji Apple Ads?

Jedno połączenie jest przypięte do jednej organizacji, którą wybierasz przy jego tworzeniu. Apple traktuje orgId trochę jak grupę kampanii, więc jedno logowanie może obejmować kilka. Agencja z klientem na każdą organizację łączy każdą w osobnym profilu Hermoso.

Czy muszę rotować klucz co 180 dni?

Nie. Apple ogranicza sekret klienta do 180 dni, dlatego jego własne instrukcje każą zapisać rotację w kalendarzu. Hermoso przechowuje klucz prywatny i za każdym razem, przy wymianie tokena, generuje świeży, krótkotrwały sekret, więc nic nie leży w pliku konfiguracyjnym, co mogłoby wygasnąć.

Czy mogę wyeksportować dane Apple Search Ads do Arkuszy Google lub Looker Studio?

Tak. Połącz Dysk Google obok Apple Ads, a agent zapisze raport do arkusza Google poleceniem create_sheet lub append_to_sheet. Hermoso nie ma natywnego łącznika Looker Studio; Looker Studio czyta ten arkusz własnym łącznikiem Arkuszy Google.

Czy mogę pobrać dane Apple Search Ads jako JSON?

Tak. Wywołaj POST /v1/tools/apple_ads_report w API Hermoso kluczem API i odczytaj data.rows z odpowiedzi, albo uruchom hermoso call apple_ads_report z --structured z poziomu CLI.