Подключите Apple Search Ads к Claude или ChatGPT за пять минут

Коннектор Hermoso для Apple Search Ads связывает ваш аккаунт Apple Ads с Claude, ChatGPT, Cursor, CLI или обычным HTTP, чтобы агент мог вести ваши поисковые объявления в App Store. Он создаёт кампанию, группу объявлений, ключевые слова для таргетинга и минус-слова, читает обратно то, что Apple действительно сохранила, и отчитывается об эффективности вплоть до поискового запроса, который кто-то ввёл до установки. Всё создаётся на паузе. Включение расходов: отдельный шаг, требующий явного подтверждения. Отчёты могут попадать в Google Таблицу, дашборд 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 Таблицу или подготовить кампанию на ваш просмотр. 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 за прошлую неделю по ключевым словам и выведи десять с самой высокой CPA.”
• “Положи расходы, установки и CPA по кампаниям за последние 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, а быть администратором аккаунта: не роль 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 получает эффективность кампании, группы объявлений, объявления, ключевого слова и поискового запроса (показы, тапы, установки, расходы, доля тапов (TTR), стоимость тапа (CPT) и стоимость установки (CPA)), как итоги или как ряд по часам, дням, неделям или месяцам, до 5 000 строк на страницу. Чтение отчёта никогда не трогает расходы. Куда строки попадут дальше, решаете вы; три самых частых места описаны ниже. Полное руководство: Экспорт данных из Apple Search Ads.

Подключите Apple Search Ads к Google Таблицам

Затем подключите Google Drive рядом с Apple Ads (одна авторизация Google покрывает Drive, Таблицы и Документы) и попросите агента положить отчёт в таблицу. Он вызывает apple_ads_report, затем create_sheet для новой таблицы или append_to_sheet, чтобы добавить строки этой недели в существующую. Hermoso использует область доступа Google drive.file, поэтому он видит только файлы, которые создал сам, или те, что вы выбрали. Пошагово: Подключите Apple Search Ads к Google Таблицам.

Экспорт Apple Search Ads в Looker Studio

У Hermoso нет собственного коннектора Looker Studio. Looker Studio читает Google Таблицы своим коннектором, поэтому таблица выше служит мостом: один раз добавьте её как источник данных 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 как собственный коннектор с адресом 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 Таблицу.

Есть ли 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, создаётся на паузе без исключений. Включение объекта: единственный переключатель, который запускает реальные расходы, и он требует явного подтверждения.

Что такое clientId, teamId и keyId?

Три идентификатора, которые Apple выводит над полем Public Key после сохранения ключа. Они определяют ваш пользователь API для Apple; закрытый ключ доказывает, что это вы. Вставьте все три в Hermoso, и подключение готово.

Может ли одно подключение охватывать несколько организаций Apple Ads?

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

Нужно ли менять ключ каждые 180 дней?

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

Можно ли экспортировать данные Apple Search Ads в Google Таблицы или Looker Studio?

Да. Подключите Google Drive рядом с Apple Ads, и агент запишет отчёт в Google Таблицу через 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.