Sambung Apple Search Ads ke Claude atau ChatGPT dalam lima minit

Penyambung Apple Search Ads Hermoso menghubungkan akaun Apple Ads anda ke Claude, ChatGPT, Cursor, CLI atau HTTP biasa, supaya ejen boleh menjalankan iklan carian App Store anda untuk anda. Ia membina kempen, kumpulan iklan, kata kunci sasaran dan negatif, membaca semula apa yang Apple sebenarnya simpan, dan melaporkan prestasi sehingga ke istilah carian yang ditaip seseorang sebelum memasang. Setiap yang dicipta dicipta dalam keadaan dijeda, dan mengaktifkan perbelanjaan ialah langkah berasingan yang disahkan secara eksplisit. Laporan boleh masuk ke Google Sheet, dashboard Looker Studio atau fail JSON, dan halaman MCP Apple Ads menyenaraikan semua yang boleh dilakukan penyambung ini.

Menyambung mengambil masa kira-kira lima minit. Anda tidak perlu menjalankan openssl, dan tiada kata laluan Apple yang sampai ke Hermoso.

Sambung Apple Search Ads ke Claude

Untuk menyambung Apple Search Ads ke Claude, tambahkan Hermoso ke Claude sebagai penyambung, kemudian sambungkan akaun Apple Ads anda dalam Hermoso sekali. Dalam Claude, buka Customize › Connectors › Add custom connector, namakannya Hermoso, tampal https://app.hermoso.ai/mcp dan luluskannya dengan akaun Hermoso anda. Tiada kunci untuk ditampal ke dalam Claude. Kemudian sambungkan Apple Ads dalam Hermoso di bawah Setelan › Penyambung, menggunakan langkah di bahagian bawah halaman ini. Dari titik itu Claude boleh memanggil setiap alat Apple Ads yang Hermoso ada: minta laporan, perubahan kata kunci atau kempen baharu dengan kata-kata biasa. Dalam Claude Code ia dua arahan sebaliknya: /plugin marketplace add hermoso-ai/hermoso, kemudian /plugin install hermoso@hermoso. Hermoso dalam Claude mempunyai langkah lengkap.

Sambung Apple Search Ads ke ChatGPT

ChatGPT berfungsi dengan cara yang sama. Dalam ChatGPT, buka Plugins, kemudian Add › Create MCP App, namakannya Hermoso, tampal https://app.hermoso.ai/mcp sebagai Server URL, kekalkan Authentication pada OAuth dan luluskan dengan akaun Hermoso anda. Jika Create MCP App tiada, hidupkan Developer mode sekali di bawah Settings › Plugins › Developer mode. Dengan Apple Ads disambungkan dalam Hermoso, ChatGPT boleh menarik laporan kata kunci anda, menulisnya ke Google Sheet atau merangka kempen untuk anda semak. Hermoso dalam ChatGPT membimbing langkahnya.

Cursor, Codex dan mana-mana klien MCP lain

Mana-mana klien yang bertutur Model Context Protocol mencapai alat yang sama di alamat yang sama. Cursor membaca https://app.hermoso.ai/mcp daripada mcp.json-nya; Codex menerima plugin Hermoso dengan codex plugin marketplace add hermoso-ai/hermoso, yang memacu alat yang sama dari terminal. Walau apa pun klien yang anda guna, kelayakan Apple anda tidak pernah melalui sembang. Ejen memanggil alat Hermoso, dan Hermoso menandatangani setiap permintaan ke Apple dengan kunci yang dipegangnya. Halaman MCP Apple Ads menyenaraikan setiap alat.

Apa yang hendak ditanya selepas disambungkan

• “Tarik prestasi Apple Search Ads minggu lepas mengikut kata kunci dan tunjukkan saya sepuluh yang mempunyai kos setiap pemerolehan tertinggi.”
• “Letakkan perbelanjaan, pemasangan dan CPA 30 hari terakhir mengikut kempen ke dalam Google Sheet baharu bernama Apple Ads.” (Sambungkan Google Drive dahulu.)
• “Istilah carian mana yang membawa pemasangan dalam kempen AS saya bulan ini yang saya belum bid sebagai kata kunci padanan tepat?”
• “Tambah ‘budget planner’ dan ‘expense tracker’ sebagai kata kunci padanan tepat dalam kumpulan iklan Brand, dan ‘jobs’ sebagai negatif.”
• “Apakah kata kunci yang Apple cadangkan untuk aplikasi saya, dan berapa bahagian tayangan yang saya dapat pada yang sudah saya bid?”
• “Bina kempen dijeda untuk aplikasi saya di UK dengan belanjawan harian 50 dolar AS, kemudian tunjukkan apa yang Apple simpan.”

Membaca laporan tidak sekali-kali menyentuh perbelanjaan. Apa sahaja yang ejen bina dicipta dalam keadaan dijeda, dan suis yang menghidupkan perbelanjaan menunggu pengesahan eksplisit anda.

Pertama, perkara yang menghentikan kebanyakan orang

Arahan Apple sendiri berbunyi: “Dari Ads UI, pilih Account Settings › API. Tampal kunci ke dalam medan Public Key.”

Medan itu tidak wujud untuk Pentadbir Akaun. Log masuk sebagai pentadbir pada akaun anda sendiri, buka Account Settings › API, dan yang dipaparkan ialah jadual bertajuk Manage API Access (senarai pembekal perkhidmatan pihak ketiga dengan satu tindakan Remove Access) dan tiada medan kunci di mana-mana pun pada halaman itu. Ia kelihatan seperti ciri yang tiada, dan sebab itulah orang berhenti di sini dan membuat kesimpulan bahawa API tidak tersedia untuk mereka.

Ia tersedia. Medan Public Key tergolong kepada pengguna yang memegang peranan API, dan menjadi pentadbir akaun bukan salah satunya. Dialog jemputan Apple menawarkan enam peranan, dan tepat dua daripadanya ialah peranan API:

• API Account Manager: “akses baca dan tulis kepada semua kumpulan kempen untuk pengurusan API”. Ini yang patut dipilih jika anda mahu Hermoso membina kempen, bukan sekadar melaporkannya.
• API Account Read Only: “akses baca sahaja kepada semua kumpulan kempen untuk pengurusan API”. Cukup untuk pelaporan, dan tiada apa lagi.

Empat yang lain (Account Admin, Account Finance, Account Read Only dan Limited Access) tidak boleh mencipta kelayakan API langsung. Jadi penyelesaiannya ialah jemputan yang anda hantar kepada diri sendiri:

1. Buka Account Settings › User Management dan pilih Invite Users.
2. Jemput alamat yang anda kawal (milik anda, atau alamat dikongsi seperti ads-api@yourcompany.com supaya kelayakan itu bertahan walaupun orang itu pergi) dengan peranan API Account Manager.
3. Terima jemputan daripada peti mel itu, kemudian log masuk ke Apple Ads sebagai pengguna itu.

Sekarang Account Settings › API mempunyai medan Public Key.

Sambungan, langkah demi langkah

1. Mulakannya dalam Hermoso. Setelan › Penyambung › Apple Ads › Sambung. Hermoso menjana kunci tandatangan EC P-256 (kunci prime256v1 yang sama yang akan dihasilkan oleh dua arahan openssl Apple) dan hanya menunjukkan bahagian awamnya. Salin.
2. Berikan bahagian awam kepada Apple. Sebagai pengguna peranan API, buka Account Settings › API, tampal ke dalam Public Key, dan Simpan.
3. Salin tiga id kembali. Apple kini mencetak clientId, teamId dan keyId di atas medan itu. Ketiga-tiganya.
4. Selesaikannya dalam Hermoso. Tampal tiga id dan simpan. Hermoso menukar token dengan Apple dan membaca senarai organisasi anda sebelum menyimpan apa-apa, jadi id yang salah taip gagal di situ, semasa anda masih boleh melihat apa yang anda tampal, bukan pada laporan pertama anda sejam kemudian.
5. Pilih organisasi, jika kelayakan anda meliputi lebih daripada satu. Sambungan dipaut kepada yang anda pilih.

Jika ada yang tidak kena

Tiada medan Public Key pada halaman API

Anda log masuk sebagai Account Admin, atau sebagai mana-mana daripada empat peranan bukan API. Jemput diri sendiri sebagai API Account Manager dan log masuk sebagai pengguna itu (lihat di atas). Ini sebab paling biasa sambungan Apple Ads tidak pernah dibuat.

Apple menolak kelayakan

Tiga id mesti tergolong kepada kunci yang dipegang Apple. Salin semula clientId, teamId dan keyId dari atas medan Public Key, bukan daripada kunci lama yang anda gantikan. Jika masih gagal, mulakan semula sambungan dalam Hermoso: ia menjana pasangan kunci baharu, dan anda menampal bahagian awam yang baharu ke dalam Apple.

Sesi persediaan tamat tempoh

Hermoso menyimpan kunci persendirian yang dijana selama 24 jam semasa anda pergi menampal bahagian awamnya ke Apple. Selepas itu ia hilang, dengan sengaja. Mulakan semula sambungan dan tampal kunci awam yang baharu.

Saya sudah menjana kunci dengan openssl

Kalau begitu, gunakannya. Tampal kunci persendirian EC P-256 yang sedia ada semasa menyambung dan bukannya mengambil kunci Hermoso, dan kunci awam yang sudah ada dalam akaun Apple anda terus berfungsi. Ia mestilah kunci EC P-256 (prime256v1). Apple tidak menerima lengkung lain.

Saya menguruskan beberapa organisasi Apple Ads

Sambungkan setiap satu dalam profil Hermoso sendiri. Sambungan dipaut kepada satu organisasi, dan itulah yang menghalang kempen agensi daripada mendarat dalam akaun klien yang salah.

Apa yang boleh dilakukan oleh penyambung Apple Search Ads

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

Baca: list_apple_ads_campaigns (status, status penyajian, belanjawan harian dan jumlah, negara tempat kempen berjalan, dan sebab yang dinyatakan Apple sendiri apabila sesuatu tidak boleh berjalan), list_apple_ads_ad_groups (bid lalai, dan sama ada Search Match Apple dihidupkan), list_apple_ads_keywords (sasaran dan negatif, dengan jenis padanan dan bid), apple_ads_report (tayangan, ketikan, pemasangan, perbelanjaan, TTR, CPT dan CPA pada peringkat kempen, kumpulan iklan, kata kunci, istilah carian atau iklan) dan list_apple_ads_orgs.

Kesemuanya boleh dipanggil daripada Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes atau mana-mana klien MCP lain, dan daripada studio web. Enjinnya sama, tidak kira dari mana. Lihat gambaran keseluruhan MCP atau rujukan alat iklan.

Dan lagi: ia membina kreatif dan iklan (create_apple_ads_creative, create_apple_ads_ad), memuatkan sehingga 1,000 kata kunci dalam satu panggilan (bulk_apple_ads_keywords), dan membaca data Apple sendiri: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity dan apple_ads_change_history. Setiap satu daripadanya boleh dipanggil dari sembang yang sama.

Eksport data daripada Apple Search Ads

Sambungan yang sama juga melaporkan. apple_ads_report menarik prestasi campaign, ad group, ad, kata kunci dan istilah carian (tayangan, ketikan, pemasangan, perbelanjaan, kadar klik-lalu, kos setiap ketikan dan kos setiap pemerolehan), sebagai jumlah atau sebagai siri setiap jam, harian, mingguan atau bulanan, sehingga 5,000 baris setiap halaman. Membaca laporan tidak sekali-kali menyentuh perbelanjaan. Ke mana baris itu pergi seterusnya terserah kepada anda, dan tiga tempat yang paling biasa dinyatakan di bawah. Panduan lengkap ialah Eksport data daripada Apple Search Ads.

Sambung Apple Search Ads ke Google Sheets

Sambungkan Google Drive di sebelah Apple Ads (satu kebenaran Google meliputi Drive, Sheets dan Docs) dan minta ejen anda memasukkan laporan ke dalam helaian. Ia memanggil apple_ads_report, kemudian create_sheet untuk helaian baharu atau append_to_sheet untuk menambah baris minggu ini ke helaian sedia ada. Hermoso menggunakan skop drive.file Google, jadi ia hanya mencapai fail yang dicipta olehnya atau yang anda pilih. Langkah demi langkah: Sambung Apple Search Ads ke Google Sheets.

Eksport Apple Search Ads ke Looker Studio

Hermoso tidak mempunyai penyambung Looker Studio asli. Looker Studio membaca Google Sheets dengan penyambungnya sendiri, jadi helaian di atas ialah jambatannya: tambahkannya sekali sebagai sumber data Google Sheets, bina dashboard, dan setiap penambahan mingguan muncul pada refresh seterusnya. Power BI dan Tableau membaca helaian yang sama dengan cara yang sama. Langkah Looker Studio.

Eksport Apple Search Ads ke JSON

Untuk baris mentah, panggil alat itu melalui API REST Hermoso dengan kunci API: POST https://app.hermoso.ai/v1/tools/apple_ads_report dengan argumen laporan sebagai badan JSON, dan baca baris daripada data.rows dalam jawapan. Dari terminal, npx -y hermoso call apple_ads_report --json '{...}' --structured mencetak hasil yang sama sebagai JSON. Contoh permintaan lengkap.

Soalan lazim

Bagaimana saya menyambung Apple Search Ads ke Claude?

Tambahkan Hermoso ke Claude sebagai penyambung tersuai dengan URL https://app.hermoso.ai/mcp dan luluskan dengan akaun Hermoso anda, kemudian sambungkan Apple Ads dalam Hermoso di bawah Setelan › Penyambung. Claude kemudian boleh membuat laporan, menyunting dan membina kempen Apple Search Ads anda melalui alat Apple Ads Hermoso.

Bolehkah ChatGPT membaca data Apple Search Ads saya?

Boleh. Tambahkan https://app.hermoso.ai/mcp dalam ChatGPT di bawah Plugins › Add › Create MCP App, dan sambungkan Apple Ads dalam Hermoso. ChatGPT kemudian boleh menarik tayangan, ketikan, pemasangan, perbelanjaan, TTR, CPT dan CPA mengikut kempen, kumpulan iklan, iklan, kata kunci atau istilah carian, dan menulis baris itu ke dalam Google Sheet.

Adakah terdapat pelayan MCP Apple Search Ads?

Ada. Pelayan MCP yang dihoskan Hermoso di https://app.hermoso.ai/mcp mendedahkan set alat Apple Ads yang lengkap kepada Claude, ChatGPT, Cursor, Codex atau mana-mana klien MCP: pelaporan, kempen, kumpulan iklan, kata kunci dan negatif, kreatif dan iklan, serta cadangan kata kunci Apple. Apa sahaja yang dibinanya dicipta dalam keadaan dijeda.

Kenapa tiada medan Public Key pada halaman API Apple Ads?

Kerana anda log masuk sebagai Account Admin. Apple hanya memaparkan medan itu untuk pengguna yang memegang peranan API. Pentadbir melihat jadual “Manage API Access” bagi pembekal perkhidmatan pihak ketiga, dengan tiada medan kunci di mana-mana pada halaman itu. Jemput diri sendiri sebagai API Account Manager di bawah Account Settings › User Management, log masuk sebagai pengguna itu, dan medan itu akan muncul.

Peranan Apple Ads yang mana saya perlukan?

API Account Manager jika anda mahu Hermoso membina kempen, kumpulan iklan dan kata kunci. Apple menerangkannya sebagai “akses baca dan tulis kepada semua kumpulan kempen untuk pengurusan API”. API Account Read Only sudah cukup jika anda hanya mahu pelaporan. Empat peranan lain yang Apple tawarkan (Account Admin, Account Finance, Account Read Only dan Limited Access) tidak boleh mencipta kelayakan API langsung.

Perlukah saya menjalankan openssl?

Tidak. Arahan Apple sendiri memberi anda dua arahan openssl; Hermoso menjana pasangan kunci EC P-256 untuk anda dan hanya menunjukkan bahagian awamnya. Bahagian persendirian ialah yang menandatangani permintaan anda, dan anda tidak pernah melihat, menampal atau menyimpannya. Jika anda sudah ada kunci daripada alat lain, anda boleh membawanya sebagai ganti.

Adakah menyambung Apple Ads menelan kos atau berisiko perbelanjaan?

Tidak. Bacaan boleh dipanggil dengan percuma, dan setiap objek yang Hermoso cipta dicipta dalam keadaan DIJEDA tanpa pengatasan. Mengaktifkan objek ialah satu-satunya suis yang menghidupkan perbelanjaan sebenar, dan ia memerlukan pengesahan eksplisit.

Apakah clientId, teamId dan keyId?

Tiga pengecam yang Apple cetak di atas medan Public Key sebaik sahaja anda menyimpan kunci anda. Ia mengenal pasti pengguna API anda kepada Apple; kunci persendirian membuktikan bahawa anda orangnya. Tampal ketiga-tiganya kembali ke Hermoso dan sambungan selesai.

Bolehkah satu sambungan meliputi beberapa organisasi Apple Ads?

Satu sambungan dipaut kepada satu organisasi yang anda pilih semasa membuatnya. Apple menganggap orgId seperti kumpulan kempen, jadi satu log masuk boleh meliputi beberapa organisasi. Agensi dengan satu klien bagi setiap org menyambungkan setiap satu dalam profil Hermoso sendiri.

Perlukah saya menukar kunci setiap 180 hari?

Tidak. Apple mengehadkan rahsia klien kepada 180 hari, sebab itulah arahan Apple sendiri meminta anda menjadualkan pusingan semula. Hermoso memegang kunci persendirian dan menjana rahsia baharu yang berusia pendek untuk setiap pertukaran token, jadi tiada apa yang tersimpan dalam fail konfigurasi untuk tamat tempoh.

Bolehkah saya mengeksport data Apple Search Ads ke Google Sheets atau Looker Studio?

Boleh. Sambungkan Google Drive di sebelah Apple Ads dan ejen anda menulis laporan ke dalam Google Sheet dengan create_sheet atau append_to_sheet. Hermoso tidak mempunyai penyambung Looker Studio asli; Looker Studio membaca helaian itu dengan penyambung Google Sheets sendiri.

Bolehkah saya mendapatkan data Apple Search Ads sebagai JSON?

Boleh. Panggil POST /v1/tools/apple_ads_report pada API Hermoso dengan kunci API dan baca data.rows, atau jalankan hermoso call apple_ads_report dengan --structured daripada CLI.