Підключіть Apple Search Ads до Claude або ChatGPT за п’ять хвилин

Коннектор Hermoso для Apple Search Ads підключає ваш обліковий запис Apple Ads до Claude, ChatGPT, Cursor, CLI або звичайного HTTP, щоб агент міг вести ваші пошукові оголошення в App Store. Він будує кампанію, групу оголошень, таргетингові ключові слова та негативні ключові слова, перевіряє, що Apple справді зберегло, і звітує про ефективність аж до пошукового запиту, який хтось ввів перед встановленням. Усе, що він створює, створюється призупиненим, а увімкнення витрат є окремим кроком з явним підтвердженням. Звіти можуть потрапляти в Google Sheet, панель Looker Studio або файл JSON, а сторінка MCP Apple Ads перелічує все, що вміє коннектор.

Підключення займає близько п’яти хвилин. Ви не будете запускати openssl, і жоден пароль Apple не потрапляє до Hermoso.

Підключіть Apple Search Ads до Claude

Щоб підключити Apple Search Ads до Claude, додайте Hermoso до Claude як коннектор, потім підключіть свій обліковий запис Apple Ads всередині Hermoso один раз. У Claude відкрийте Customize › Connectors › Add custom connector, назвіть його Hermoso, вставте https://app.hermoso.ai/mcp і підтвердіть своїм обліковим записом Hermoso. Ключа для вставки в Claude немає. Потім підключіть Apple Ads у Hermoso в меню Налаштування › Коннектори, за кроками нижче на цій сторінці. Відтоді Claude може викликати кожен інструмент Apple Ads, який є в Hermoso: попросіть звіт, зміну ключового слова або нову кампанію звичайними словами. У Claude Code це натомість дві команди: /plugin marketplace add hermoso-ai/hermoso, потім /plugin install hermoso@hermoso. Hermoso в Claude містить повні кроки.

Підключіть Apple Search Ads до ChatGPT

ChatGPT працює так само. У ChatGPT відкрийте Plugins, потім Add › Create MCP App, назвіть Hermoso, вставте https://app.hermoso.ai/mcp як Server URL, залиште Authentication на OAuth і підтвердіть своїм обліковим записом Hermoso. Якщо Create MCP App немає, один раз увімкніть Developer mode в Settings › Plugins › Developer mode. Коли Apple Ads підключено в Hermoso, ChatGPT може витягнути ваш звіт за ключовими словами, записати його в Google Sheet або підготувати для вас кампанію на перевірку. Hermoso в ChatGPT описує це покроково.

Cursor, Codex та будь-який інший клієнт MCP

Будь-який клієнт, що працює з Model Context Protocol, досягає тих самих інструментів за тією самою адресою. Cursor читає https://app.hermoso.ai/mcp з свого mcp.json; Codex приймає плагін Hermoso командою codex plugin marketplace add hermoso-ai/hermoso, яка керує тими самими інструментами з терміналу. Яким би клієнтом ви не користувалися, ваші облікові дані Apple ніколи не проходять через чат. Агент викликає інструменти Hermoso, а Hermoso підписує кожен запит до Apple ключем, який тримає. Сторінка MCP Apple Ads перелічує кожен інструмент.

Що запитувати після підключення

• «Отримай показники Apple Search Ads за ключовими словами за минулий тиждень і покажи десять з найвищою вартістю інсталяції.»
• «Постав витрати, інсталяції та вартість інсталяції за кампаніями за останні 30 днів у нову Google-таблицю під назвою Apple Ads.» (Спершу підключіть Google Drive.)
• «Які пошукові запити принесли інсталяції в моїй кампанії в США цього місяця, а ставку на які я ще не роблю як на точні ключові слова?»
• «Додай ‘budget planner’ і ‘expense tracker’ як точні ключові слова в групі оголошень Brand, а ‘jobs’ як негативне.»
• «Які ключові слова пропонує Apple для мого застосунку і яку частку показів я отримую за ті, на які вже ставлю?»
• «Побудуй призупинену кампанію для мого застосунку у Великій Британії з денним бюджетом 50 доларів, а потім покажи, що зберіг Apple.»

Читання звіту ніколи не торкається витрат. Усе, що будує агент, створюється призупиненим, а перемикач, який вмикає витрати, чекає вашого явного підтвердження.

Спочатку те, що зупиняє більшість людей

Власна інструкція Apple каже: «В інтерфейсі Ads оберіть Account Settings › API. Вставте ключ у поле Public Key.»

Цього поля не існує для адміністратора облікового запису. Увійдіть як адміністратор у свій обліковий запис, відкрийте Account Settings › API, і на сторінці з’являється таблиця з заголовком Manage API Access (список сторонніх постачальників послуг з однією дією Remove Access), а ніде на сторінці немає поля для ключа. Це виглядає як відсутня функція, тому люди зупиняються тут і роблять висновок, що API їм недоступний.

Він доступний. Поле Public Key належить користувачу з роллю API, а бути адміністратором облікового запису такою роллю не є. Діалог запрошення Apple пропонує шість ролей, з яких рівно дві є ролями API:

• API Account Manager: «доступ на читання і запис до всіх груп кампаній для керування API». Саме цю обирайте, якщо хочете, щоб Hermoso будував кампанії, а не лише звітував за ними.
• API Account Read Only: «доступ лише на читання до всіх груп кампаній для керування API». Достатньо для звітності, і нічого більше.

Решта чотирьох (Account Admin, Account Finance, Account Read Only і Limited Access) взагалі не можуть створювати API-облікові дані. Тому виправлення: це запрошення, яке ви надсилаєте самому собі:

1. Відкрийте Account Settings › User Management і оберіть Invite Users.
2. Запросіть адресу, яку ви контролюєте (свою або спільну, як ads-api@yourcompany.com, щоб облікові дані пережили будь-яку окрему людину), з роллю API Account Manager.
3. Прийміть запрошення з цієї скриньки, потім увійдіть в Apple Ads як цей користувач.

Тепер в Account Settings › API з’являється поле Public Key.

Підключення крок за кроком

1. Почніть у Hermoso. Налаштування › Коннектори › Apple Ads › Підключити. Hermoso генерує ключ підпису EC P-256 (той самий ключ prime256v1, який створили б дві команди openssl від Apple) і показує вам лише публічну половину. Скопіюйте її.
2. Передайте публічну половину Apple. Як користувач з роллю API, відкрийте Account Settings › API, вставте її в Public Key і натисніть Save.
3. Скопіюйте три ідентифікатори назад. Apple тепер виводить clientId, teamId і keyId над цим полем. Усі три.
4. Завершіть у Hermoso. Вставте три ідентифікатори і збережіть. Hermoso обмінює токен з Apple і зчитує ваш список організацій до того, як щось зберегти, тож помилковий ідентифікатор не пройде саме тут, поки ви ще бачите, що вставили, а не при першому звіті годину потому.
5. Оберіть організацію, якщо ваші облікові дані охоплюють більше однієї. Підключення закріплюється за тією, яку ви обрали.

Якщо щось іде не так

На сторінці API немає поля Public Key

Ви увійшли як Account Admin або як будь-яка з чотирьох ролей без API. Запросіть себе як API Account Manager і увійдіть як цей користувач (див. вище). Це найпоширеніша причина, через яку підключення Apple Ads ніколи не відбувається.

Apple відхиляє облікові дані

Три ідентифікатори мають належати ключу, який тримає Apple. Скопіюйте clientId, teamId і keyId заново з місця прямо над полем Public Key, а не зі старішого ключа, який ви замінили. Якщо вони все ще не проходять, почніть підключення в Hermoso заново: це створює нову пару ключів, а ви вставляєте нову публічну половину в Apple.

Сеанс налаштування закінчився

Hermoso тримає згенерований приватний ключ 24 години, поки ви йдете вставляти його публічну половину в Apple. Після цього він свідомо видаляється. Почніть підключення заново і вставте новий публічний ключ.

Я вже згенерував ключ через openssl

Тоді використайте його. Вставте свій існуючий приватний ключ EC P-256 під час підключення замість того, який дає Hermoso, і публічний ключ, що вже лежить у вашому обліковому записі Apple, продовжуватиме працювати. Це має бути ключ EC P-256 (prime256v1). Apple не приймає інших кривих.

Я керую кількома організаціями Apple Ads

Підключіть кожну у власному профілі Hermoso. Підключення закріплюється за однією організацією, і саме це не дає кампанії агентства потрапити в обліковий запис не того клієнта.

Що вміє коннектор Apple Search Ads

Будувати: 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.

Читати: list_apple_ads_campaigns (статус, статус показу, денний і загальний бюджет, країни, в яких працює кампанія, і власну причину Apple, коли кампанія не може працювати), list_apple_ads_ad_groups (ставка за замовчуванням і чи увімкнено Search Match від Apple), list_apple_ads_keywords (таргетингові та негативні, з типом відповідності та ставкою), apple_ads_report (покази, тапи, інсталяції, витрати, TTR, CPT і CPA на рівні кампанії, групи оголошень, ключового слова, пошукового запиту або оголошення) і list_apple_ads_orgs.

Усе це доступно з Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes або будь-якого іншого клієнта MCP, а також з веб-студії. Рушій той самий в обох випадках. Див. огляд MCP або довідник інструментів реклами.

І ще: він створює креативи та оголошення (create_apple_ads_creative, create_apple_ads_ad), завантажує до 1 000 ключових слів одним викликом (bulk_apple_ads_keywords) і читає власні дані Apple: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity і apple_ads_change_history. Кожен з них доступний з того самого чату.

Експорт даних з Apple Search Ads

Те саме підключення також звітує. apple_ads_report отримує ефективність на рівнях кампанії, групи оголошень, оголошення, ключового слова та пошукового запиту (покази, тапи, інсталяції, витрати, коефіцієнт тапів, вартість тапу та вартість інсталяції), як підсумки або як серію погодинно, щодня, щотижня чи щомісяця, до 5 000 рядків на сторінку. Читання звіту ніколи не торкається витрат. Куди далі потрапляють рядки, вирішуєте ви, а три найпоширеніші місця описані нижче. Повний посібник: Експорт даних з Apple Search Ads.

Підключіть Apple Search Ads до Google Sheets

Підключіть Google Drive поруч з Apple Ads (одна авторизація Google покриває Drive, Sheets і Docs) і попросіть агента помістити звіт у таблицю. Він викликає apple_ads_report, потім create_sheet для нової таблиці або append_to_sheet, щоб додати рядки цього тижня до наявної. Hermoso використовує область drive.file від Google, тож досягає лише файлів, які створив, або тих, які ви вибрали. Крок за кроком: Підключіть Apple Search Ads до Google Sheets.

Експорт Apple Search Ads до Looker Studio

Hermoso не має нативного коннектора Looker Studio. Looker Studio читає Google Sheets своїм власним коннектором, тож таблиця вище є мостом: додайте її один раз як джерело даних Google Sheets, побудуйте панель, і кожне щотижневе додавання з’явиться після наступного оновлення. Power BI і Tableau читають ту саму таблицю так само. Кроки для Looker Studio.

Експорт Apple Search Ads до JSON

Для сирих рядків викличте інструмент через REST API Hermoso з API-ключем: POST https://app.hermoso.ai/v1/tools/apple_ads_report з аргументами звіту як тілом JSON, і прочитайте рядки з data.rows у відповіді. З терміналу npx -y hermoso call apple_ads_report --json '{...}' --structured виводить той самий результат як JSON. Повний приклад запиту.

Часті запитання

Як підключити Apple Search Ads до Claude?

Додайте Hermoso до Claude як власний коннектор з URL https://app.hermoso.ai/mcp і підтвердіть своїм обліковим записом Hermoso, потім підключіть Apple Ads у Hermoso в меню Налаштування › Коннектори. Тоді Claude може звітувати, редагувати та будувати ваші кампанії Apple Search Ads через інструменти Apple Ads від Hermoso.

Чи може ChatGPT читати мої дані Apple Search Ads?

Так. Додайте https://app.hermoso.ai/mcp у ChatGPT у розділі Plugins › Add › Create MCP App і підключіть Apple Ads у Hermoso. Тоді ChatGPT може отримати покази, тапи, інсталяції, витрати, TTR, CPT і CPA за кампаніями, групами оголошень, оголошеннями, ключовими словами або пошуковими запитами та записати рядки в Google Sheet.

Чи є сервер MCP для Apple Search Ads?

Так. Хмарний MCP-сервер Hermoso за адресою https://app.hermoso.ai/mcp відкриває повний набір інструментів Apple Ads для Claude, ChatGPT, Cursor, Codex або будь-якого клієнта MCP: звітність, кампанії, групи оголошень, ключові слова та негативні ключові слова, креативи й оголошення, а також пропозиції ключових слів від Apple. Усе, що він будує, створюється призупиненим.

Чому на сторінці API Apple Ads немає поля Public Key?

Тому що ви увійшли як Account Admin. Apple показує це поле лише користувачу з роллю API. Адміністратор бачить натомість таблицю “Manage API Access” зі сторонніми постачальниками послуг, без поля для ключа на сторінці. Запросіть себе як API Account Manager у Account Settings › User Management, увійдіть як цей користувач, і поле з’явиться.

Яка роль Apple Ads мені потрібна?

API Account Manager, якщо хочете, щоб Hermoso будував кампанії, групи оголошень і ключові слова. Apple описує її як «доступ на читання і запис до всіх груп кампаній для керування API». API Account Read Only достатньо, якщо потрібна лише звітність. Решта чотирьох ролей, які пропонує Apple (Account Admin, Account Finance, Account Read Only і Limited Access), взагалі не можуть створювати API-облікові дані.

Чи потрібно запускати openssl?

Ні. Власні інструкції Apple дають вам дві команди openssl; Hermoso генерує для вас пару ключів EC P-256 і показує лише публічну половину. Приватна половина підписує ваші запити, і ви її ніколи не бачите, не вставляєте і не зберігаєте. Якщо ключ уже є з іншого інструмента, можна принести його.

Чи коштує підключення Apple Ads або це ризикує витратами?

Ні. Читання можна викликати безкоштовно, а кожен об’єкт, який створює Hermoso, створюється PAUSED без винятків. Увімкнення об’єкта: єдиний перемикач, що запускає реальні витрати, і він потребує явного підтвердження.

Що таке clientId, teamId і keyId?

Це три ідентифікатори, які Apple виводить над полем Public Key після збереження вашого ключа. Вони ідентифікують вашого API-користувача для Apple; приватний ключ доводить, що це ви. Вставте всі три назад у Hermoso, і підключення завершено.

Чи може одне підключення охоплювати кілька організацій Apple Ads?

Одне підключення закріплюється за єдиною організацією, яку ви обираєте під час створення. Apple ставиться до orgId трохи як до групи кампаній, тож один логін може охоплювати кілька. Агентство з клієнтом на кожну організацію підключає кожну у власному профілі Hermoso.

Чи потрібно ротувати ключ кожні 180 днів?

Ні. Apple обмежує клієнтський секрет 180 днями, тому його власна інструкція змушує вас записати собі ротацію. Hermoso тримає приватний ключ і створює новий короткоживучий секрет для кожного обміну токенами, тож у конфігураційному файлі немає нічого, що може прострочитися.

Чи можна експортувати дані Apple Search Ads до Google Sheets або Looker Studio?

Так. Підключіть Google Drive поруч з Apple Ads, і ваш агент запише звіт у Google Sheet через create_sheet або append_to_sheet. Hermoso не має нативного коннектора Looker Studio; Looker Studio читає цю таблицю своїм коннектором Google Sheets.

Чи можна отримати дані Apple Search Ads у JSON?

Так. Викличте POST /v1/tools/apple_ads_report в API Hermoso з API-ключем і прочитайте data.rows, або виконайте hermoso call apple_ads_report з --structured з CLI.