Připojte Apple Search Ads ke Claude nebo ChatGPT za pět minut

Konektor Hermoso pro Apple Search Ads propojí váš účet Apple Ads s Claude, ChatGPT, Cursorem, CLI nebo prostým HTTP, takže vám agent může spravovat vyhledávací reklamy v App Store. Vytvoří kampaň, skupinu reklam, cílová klíčová slova a negativní klíčová slova, přečte zpět, co Apple skutečně uložil, a zahrne výkon až po hledaný výraz, který někdo zadal dřív, než si aplikaci nainstaloval. Všechno, co vytvoří, vznikne pozastavené a zapnutí výdajů je samostatný krok, který výslovně potvrdíte. Reporty mohou skončit v Google Sheets, na dashboardu Looker Studio nebo v souboru JSON. Na stránce Apple Ads MCP je přehled všeho, co konektor umí.

Připojení trvá asi pět minut. Nebudete spouštět openssl a žádné heslo k Applu se do Hermoso nedostane.

Připojte Apple Search Ads ke Claude

Chcete-li připojit Apple Search Ads ke Claude, přidejte Hermoso v Claude jako konektor a poté jednou připojte svůj účet Apple Ads v Hermoso. V Claude otevřete Customize › Connectors › Add custom connector, pojmenujte jej Hermoso, vložte https://app.hermoso.ai/mcp a schvalte jej svým účtem Hermoso. Do Claude nemusíte vkládat žádný klíč. Potom připojte Apple Ads v Hermoso v nabídce Nastavení › Konektory podle kroků níže na této stránce. Od té chvíle může Claude volat všechny nástroje Apple Ads, které Hermoso má: požádejte o report, změnu klíčového slova nebo novou kampaň obyčejnými slovy. V Claude Code stačí dva příkazy: /plugin marketplace add hermoso-ai/hermoso a potom /plugin install hermoso@hermoso. Hermoso v Claude obsahuje úplný postup.

Připojte Apple Search Ads k ChatGPT

S ChatGPT je to stejné. V ChatGPT otevřete Plugins, pak Add › Create MCP App, pojmenujte jej Hermoso, jako Server URL vložte https://app.hermoso.ai/mcp, ponechte Authentication na OAuth a schvalte to svým účtem Hermoso. Pokud Create MCP App chybí, jednorázově zapněte Developer mode v nabídce Settings › Plugins › Developer mode. Když máte Apple Ads připojené v Hermoso, ChatGPT vám může stáhnout přehled klíčových slov, zapsat jej do Google Sheets nebo připravit kampaň ke kontrole. Hermoso v ChatGPT to krok za krokem popisuje.

Cursor, Codex a každý další klient MCP

Každý klient, který mluví protokolem Model Context Protocol, dosáhne na stejné nástroje na stejné adrese. Cursor čte https://app.hermoso.ai/mcp ze svého souboru mcp.json; Codex přidá plugin Hermoso příkazem codex plugin marketplace add hermoso-ai/hermoso, který ovládá tytéž nástroje z terminálu. Ať používáte kteréhokoli klienta, vaše přihlašovací údaje k Applu nikdy neprocházejí chatem. Agent volá nástroje Hermoso a Hermoso podepisuje každý požadavek směrem k Applu klíčem, který má uložený. Stránka Apple Ads MCP vypisuje každý nástroj.

Na co se zeptat po připojení

• “Ukaž výkon Apple Search Ads za minulý týden podle klíčových slov a těch deset s nejvyšší cenou za akvizici.”
• “Zapiš výdaje, instalace a CPA za posledních 30 dní po kampaních do nového Google Sheet s názvem Apple Ads.” (Nejdřív připojte Google Drive.)
• “Které hledané výrazy tento měsíc přivedly instalace do mé americké kampaně a ještě na ně necílím jako na přesná klíčová slova?”
• “Přidej ‘budget planner’ a ‘expense tracker’ jako klíčová slova s přesnou shodou do skupiny reklam Brand a ‘jobs’ jako negativní klíčové slovo.”
• “Jaká klíčová slova Apple navrhuje pro moji aplikaci a jaký podíl zobrazení mám u těch, na která už cílím?”
• “Vytvoř pozastavenou kampaň pro moji aplikaci ve Velké Británii s denním rozpočtem 50 dolarů a pak mi ukaž, co Apple uložil.”

Čtení reportu se nikdy nedotkne výdajů. Cokoli agent vytvoří, vznikne pozastavené a přepínač, který zapíná výdaje, čeká na váš výslovný souhlas.

Nejdřív věc, na které se většina lidí zasekne

Apple sám píše: „V uživatelském rozhraní Ads zvolte Account Settings › API. Vložte klíč do pole Public Key.“

Pole Public Key pro správce účtu neexistuje. Přihlaste se jako správce na svůj účet, otevřete Account Settings › API a zobrazí se tabulka nadepsaná Manage API Access (seznam poskytovatelů třetích stran s jedinou akcí Remove Access) a na stránce nikde žádné pole pro klíč. Vypadá to přesně jako chybějící funkce, a proto lidé skončí a usoudí, že API pro ně není dostupné.

Je dostupné. Pole Public Key patří uživateli s rolí API, a být správcem účtu žádnou takovou roli není. Apple v dialogu pro pozvání nabízí šest rolí, z nichž přesně dvě jsou role API:

• API Account Manager: „read and write access to all campaign groups for API management“ (čtení a zápis do všech skupin kampaní pro správu přes API). Vyberte tuto roli, pokud chcete, aby Hermoso kampaně nejen reportovalo, ale i vytvářelo.
• API Account Read Only: „read only access to all campaign groups for API management“ (pouze čtení všech skupin kampaní pro správu přes API). Stačí na reporting a nic dalšího.

Zbylé čtyři (Account Admin, Account Finance, Account Read Only a Limited Access) nemohou vytvářet API přihlašovací údaje vůbec. Oprava tedy spočívá v pozvánce, kterou pošlete sami sobě:

1. Otevřete Account Settings › User Management a zvolte Invite Users.
2. Pozvěte adresu, kterou máte pod kontrolou (vaši vlastní, nebo sdílenou, například ads-api@yourcompany.com, aby přihlašovací údaje přežily jednoho člověka), s rolí API Account Manager.
3. Přijměte pozvánku z té schránky a pak se do Apple Ads přihlaste jako tento uživatel.

Nyní má Account Settings › API pole Public Key.

Připojení krok za krokem

1. Spusťte to v Hermoso. Nastavení › Konektory › Apple Ads › Připojit. Hermoso vygeneruje podpisový klíč EC P-256 (stejný klíč prime256v1, jaký by vytvořily dva příkazy openssl od Applu) a ukáže vám jen veřejnou polovinu. Zkopírujte ji.
2. Dejte veřejnou polovinu Applu. Jako uživatel s rolí API otevřete Account Settings › API, vložte ji do pole Public Key a uložte.
3. Zkopírujte zpět tři identifikátory. Apple nyní vypíše nad tímto polem clientId, teamId a keyId. Všechny tři.
4. Dokončete to v Hermoso. Vložte tři identifikátory a uložte. Hermoso si s Applem vymění token a načte váš seznam organizací předtím, než cokoli uloží, takže špatně opsané ID selže hned, kdy ještě vidíte, co jste vložili, a ne až u prvního reportu o hodinu později.
5. Vyberte organizaci, pokud vaše přihlašovací údaje pokrývají víc než jednu. Připojení se váže na tu, kterou zvolíte.

Když se něco pokazí

Na stránce API není pole Public Key

Jste přihlášeni jako Account Admin, nebo jako kdokoli z oněch čtyř rolí bez API. Pozvěte se jako API Account Manager a přihlaste se jako tento uživatel (viz výše). Toto je nejčastější důvod, proč se připojení Apple Ads nikdy nepovede.

Apple přihlašovací údaje odmítá

Tři identifikátory musejí patřit ke klíči, který Apple drží. Znovu zkopírujte clientId, teamId a keyId přímo nad polem Public Key, ne ze starého klíče, který jste nahradili. Pokud stále selhávají, spusťte připojení v Hermoso znovu: vytvoří nový pár klíčů a vy vložíte novou veřejnou polovinu do Applu.

Relace nastavení vypršela

Hermoso drží vygenerovaný privátní klíč 24 hodin, zatímco jdete vložit jeho veřejnou polovinu do Applu. Po této době je záměrně pryč. Spusťte připojení znovu a vložte nový veřejný klíč.

Klíč jsem už vygeneroval pomocí openssl

Pak ho použijte. Při připojení vložte svůj existující privátní klíč EC P-256 místo toho, který nabízí Hermoso, a veřejný klíč, který už je ve vašem účtu Apple, bude dál fungovat. Musí jít o EC P-256 (prime256v1). Apple jinou křivku nepřijímá.

Spravuji více organizací Apple Ads

Připojte každou z nich v samostatném profilu Hermoso. Připojení je vázané na jednu organizaci, a právě to brání tomu, aby se kampaň agentury dostala na účet špatného klienta.

Co umí konektor Apple Search Ads

Vytvářet: 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.

Číst: list_apple_ads_campaigns (stav, stav doručování, denní a celkový rozpočet, země, ve kterých kampaň běží, a Applem uvedený důvod, pokud nemůže běžet), list_apple_ads_ad_groups (výchozí nabídka a zda je zapnuté Search Match od Applu), list_apple_ads_keywords (cílová a negativní klíčová slova s typem shody a nabídkou), apple_ads_report (zobrazení, klepnutí, instalace, výdaje, TTR, CPT a CPA na úrovni kampaně, skupiny reklam, klíčového slova, hledaného výrazu nebo reklamy) a list_apple_ads_orgs.

To vše lze volat z Claude, Claude Code, Codexu, Cursoru, Cline, OpenClaw, Hermes nebo jakéhokoli jiného klienta MCP i z webového studia. Je to tentýž engine v každém případě. Viz přehled MCP nebo referenci nástrojů pro reklamy.

A navíc: vytváří kreativy a reklamy (create_apple_ads_creative, create_apple_ads_ad), nahraje až 1 000 klíčových slov jedním voláním (bulk_apple_ads_keywords) a čte Applova vlastní data: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity a apple_ads_change_history. Každý z nich lze zavolat ze stejného chatu.

Export dat z Apple Search Ads

Stejné připojení slouží i k reportům. apple_ads_report stáhne výkon kampaní, skupin reklam, reklam, klíčových slov a hledaných výrazů (zobrazení, klepnutí, instalace, výdaje, míru prokliku, cenu za klepnutí a cenu za akvizici), a to buď jako součty, nebo jako časovou řadu po hodinách, dnech, týdnech nebo měsících, až 5 000 řádků na stránku. Čtení reportu se nikdy nedotkne výdajů. Kam řádky půjdou dál, rozhodnete vy. Tři nejčastější místa jsou uvedena níže. Úplný návod najdete na stránce Export dat z Apple Search Ads.

Připojte Apple Search Ads k Google Sheets

Připojte vedle Apple Ads Google Drive (jedno oprávnění Google pokrývá Drive, Sheets i Docs) a požádejte agenta, aby report zapsal do tabulky. Zavolá apple_ads_report, pak create_sheet pro novou tabulku nebo append_to_sheet, který přidá tento týden řádky do existující. Hermoso používá rozsah Google drive.file, takže dosáhne jen na soubory, které vytvořilo, nebo které jste vybrali. Postup krok za krokem: Připojte Apple Search Ads k Google Sheets.

Export Apple Search Ads do Looker Studio

Hermoso nemá vlastní konektor pro Looker Studio. Looker Studio čte Google Sheets svým vlastním konektorem, takže výše zmíněná tabulka je mostem. Přidejte ji jednou jako zdroj dat Google Sheets, sestavte dashboard a každé týdenní připsání se zobrazí při nejbližším obnovení dat. Power BI a Tableau čtou stejnou tabulku stejně. Kroky pro Looker Studio.

Export Apple Search Ads do JSON

Pro surové řádky zavolejte nástroj přes REST API Hermoso s klíčem API: POST https://app.hermoso.ai/v1/tools/apple_ads_report s argumenty reportu jako tělem JSON a řádky přečtěte z data.rows v odpovědi. Z terminálu příkaz npx -y hermoso call apple_ads_report --json '{...}' --structured vypíše totéž jako JSON. Úplný příklad požadavku.

Často kladené otázky

Jak připojím Apple Search Ads ke Claude?

Přidejte Hermoso v Claude jako vlastní konektor s adresou https://app.hermoso.ai/mcp a schvalte jej svým účtem Hermoso. Potom připojte Apple Ads v Hermoso v nabídce Nastavení › Konektory. Claude pak může reportovat, upravovat a vytvářet vaše kampaně Apple Search Ads přes nástroje Apple Ads v Hermoso.

Může ChatGPT číst má data z Apple Search Ads?

Ano. Přidejte https://app.hermoso.ai/mcp do ChatGPT v nabídce Plugins › Add › Create MCP App a připojte Apple Ads v Hermoso. ChatGPT pak může stáhnout zobrazení, klepnutí, instalace, výdaje, TTR, CPT a CPA podle kampaně, skupiny reklam, reklamy, klíčového slova nebo hledaného výrazu a zapsat řádky do Google Sheets.

Existuje server Apple Search Ads MCP?

Ano. Hostovaný server MCP Hermoso na adrese https://app.hermoso.ai/mcp zpřístupňuje celou sadu nástrojů Apple Ads pro Claude, ChatGPT, Cursor, Codex nebo jakéhokoli klienta MCP: reporting, kampaně, skupiny reklam, klíčová slova a negativní klíčová slova, kreativy a reklamy a návrhy klíčových slov od Applu. Všechno, co vytvoří, vznikne pozastavené.

Proč na stránce API pro Apple Ads není pole Public Key?

Protože jste přihlášeni jako Account Admin. Apple toto pole zobrazí jen uživateli s rolí API. Správce místo toho vidí tabulku „Manage API Access“ s poskytovateli třetích stran a nikde na stránce žádné pole pro klíč. Pozvěte se jako API Account Manager v nabídce Account Settings › User Management, přihlaste se jako tento uživatel a pole se objeví.

Kterou roli Apple Ads potřebuji?

API Account Manager, pokud chcete, aby Hermoso vytvářelo kampaně, skupiny reklam a klíčová slova. Apple ji popisuje jako „read and write access to all campaign groups for API management“. API Account Read Only stačí, pokud chcete jen reporting. Zbylé čtyři role, které Apple nabízí (Account Admin, Account Finance, Account Read Only a Limited Access), nemohou vytvářet API přihlašovací údaje vůbec.

Musím spouštět openssl?

Ne. Návod od Applu vám dá dva příkazy openssl; Hermoso vygeneruje pár klíčů EC P-256 za vás a ukáže vám jen veřejnou polovinu. Privátní polovinu, která podepisuje vaše požadavky, nikdy neuvidíte, nevložíte ji ani neuložíte. Pokud už máte klíč z jiného nástroje, můžete ho přinést.

Stojí připojení Apple Ads něco nebo riskuje výdaje?

Ne. Čtení je zdarma a každý objekt, který Hermoso vytvoří, vznikne PAUSED bez možnosti přepsání. Zapnutí objektu je jediný přepínač, který aktivuje skutečné výdaje, a vyžaduje výslovné potvrzení.

Co jsou clientId, teamId a keyId?

Tři identifikátory, které Apple vypíše nad polem Public Key, jakmile uložíte svůj klíč. Určují vašeho uživatele API pro Apple; privátní klíč dokazuje, že jste to vy. Vložte všechny tři zpět do Hermoso a připojení je hotové.

Může jedno připojení pokrýt více organizací Apple Ads?

Jedno připojení se váže na jedinou organizaci, kterou zvolíte při jeho vytvoření. Apple s orgId zachází spíše jako se skupinou kampaní, takže jedno přihlášení může pokrýt více organizací. Agentura s jedním klientem na organizaci připojí každou v samostatném profilu Hermoso.

Musím klíč rotovat každých 180 dní?

Ne. Apple omezuje klientské tajemství na 180 dní, proto vám jeho vlastní návod přikazuje si rotaci zapsat do diáře. Hermoso drží privátní klíč a pro každou výměnu tokenu vydá nové krátkodobé tajemství, takže v konfiguračním souboru nic nezastarává.

Mohu exportovat data Apple Search Ads do Google Sheets nebo Looker Studio?

Ano. Připojte vedle Apple Ads Google Drive a váš agent zapíše report do Google Sheets pomocí create_sheet nebo append_to_sheet. Hermoso nemá vlastní konektor pro Looker Studio; Looker Studio čte tuto tabulku svým vlastním konektorem pro Google Sheets.

Mohu získat data Apple Search Ads jako JSON?

Ano. Zavolejte POST /v1/tools/apple_ads_report na API Hermoso s klíčem API a přečtěte data.rows, nebo z CLI spusťte hermoso call apple_ads_report s parametrem --structured.