Σύνδεση του Apple Search Ads με Claude ή ChatGPT σε πέντε λεπτά

Ο σύνδεσμος Hermoso για το Apple Search Ads συνδέει τον λογαριασμό σας Apple Ads με τα Claude, ChatGPT, Cursor, το CLI ή απλό HTTP, ώστε ένας πράκτορας να διαχειρίζεται τις διαφημίσεις αναζήτησης του App Store για λογαριασμό σας. Δημιουργεί την καμπάνια, την ομάδα διαφημίσεων, τις λέξεις-κλειδιά στόχευσης και τα αρνητικά κριτήρια, διαβάζει πίσω ό,τι αποθήκευσε πραγματικά η Apple και αναφέρει την απόδοση μέχρι τον όρο που πληκτρολόγησε κάποιος πριν εγκαταστήσει την εφαρμογή. Ό,τι δημιουργείται, δημιουργείται σε παύση, και η ενεργοποίηση της δαπάνης είναι ξεχωριστό βήμα που επιβεβαιώνετε ρητά. Οι αναφορές μπορούν να καταλήξουν σε ένα Google Sheet, σε πίνακα Looker Studio ή σε αρχείο JSON, και η σελίδα του Apple Ads MCP απαριθμεί όλα όσα μπορεί να κάνει ο σύνδεσμος.

Η σύνδεση θέλει περίπου πέντε λεπτά. Δεν θα τρέξετε openssl, και κανένας κωδικός Apple δεν φτάνει στο Hermoso.

Σύνδεση του Apple Search Ads με Claude

Για να συνδέσετε το Apple Search Ads με Claude, προσθέστε το Hermoso ως connector στο 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 παίρνει το plugin του Hermoso με codex plugin marketplace add hermoso-ai/hermoso, και οδηγεί τα ίδια εργαλεία από το τερματικό. Όποιον πελάτη κι αν χρησιμοποιείτε, τα διαπιστευτήρια Apple δεν περνούν ποτέ από τη συνομιλία. Ο πράκτορας καλεί τα εργαλεία του Hermoso, και το Hermoso υπογράφει κάθε αίτημα προς την Apple με το κλειδί που κρατά. Η σελίδα του Apple Ads MCP απαριθμεί κάθε εργαλείο.

Τι να ζητήσετε μόλις συνδεθεί

• “Τράβηξε την απόδοση του Apple Search Ads της περασμένης εβδομάδας ανά λέξη-κλειδί και δείξε μου τις δέκα με το υψηλότερο κόστος ανά απόκτηση.”
• “Βάλε τη δαπάνη, τις εγκαταστάσεις και το CPA των τελευταίων 30 ημερών ανά καμπάνια σε ένα νέο Google Sheet με όνομα Apple Ads.” (Συνδέστε πρώτα το Google Drive.)
• “Ποιοι όροι αναζήτησης έφεραν εγκαταστάσεις στην καμπάνια μου στις ΗΠΑ αυτόν τον μήνα και δεν έχω ακόμη στοχεύσει ως ακριβείς λέξεις-κλειδιά;”
• “Πρόσθεσε το ‘budget planner’ και το ‘expense tracker’ ως ακριβείς λέξεις-κλειδιά στην ομάδα διαφημίσεων Brand, και το ‘jobs’ ως αρνητικό.”
• “Ποιες λέξεις-κλειδιά προτείνει η Apple για την εφαρμογή μου, και τι ποσοστό εμφανίσεων παίρνω στις λέξεις που ήδη στοχεύω;”
• “Φτιάξε μια καμπάνια σε παύση για την εφαρμογή μου στο Ηνωμένο Βασίλειο με ημερήσιο προϋπολογισμό 50 δολάρια, και μετά δείξε μου τι αποθήκευσε η Apple.”

Η ανάγνωση μιας αναφοράς δεν αγγίζει ποτέ τη δαπάνη. Ό,τι φτιάχνει ο πράκτορας δημιουργείται σε παύση, και ο διακόπτης που ανοίγει τη δαπάνη περιμένει τη ρητή επιβεβαίωσή σας.

Πρώτα, το εμπόδιο που σταματά τους περισσότερους

Οι ίδιες οι οδηγίες της Apple λένε: “Από το Ads UI, επιλέξτε Account Settings › API. Επικολλήστε το κλειδί στο πεδίο Public Key.”

Αυτό το πεδίο δεν υπάρχει για έναν Account Admin. Συνδεθείτε ως διαχειριστής στον δικό σας λογαριασμό, ανοίξτε το 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. Αποδεχτείτε την πρόσκληση από αυτό το inbox, και μετά συνδεθείτε στο Apple Ads ως αυτός ο χρήστης.

Τώρα το Account Settings › API έχει πεδίο Public Key.

Η σύνδεση, βήμα προς βήμα

1. Ξεκινήστε από το Hermoso. Ρυθμίσεις › Σύνδεσμοι › Apple Ads › Connect. Το 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. Επιλέξτε τον οργανισμό, αν τα διαπιστευτήριά σας καλύπτουν περισσότερους από έναν. Η σύνδεση δένεται με αυτόν που επιλέγετε.

Αν κάτι πάει στραβά

Δεν υπάρχει πεδίο Public Key στη σελίδα API

Είστε συνδεδεμένοι ως 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, και από το web studio. Είναι η ίδια μηχανή και στις δύο περιπτώσεις. Δείτε την επισκόπηση 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 χρησιμοποιεί το scope drive.file της Google, άρα φτάνει μόνο σε αρχεία που δημιούργησε ή που εσείς επιλέξατε. Βήμα προς βήμα: Σύνδεση του Apple Search Ads με Google Sheets.

Εξαγωγή του Apple Search Ads στο Looker Studio

Το Hermoso δεν έχει δικό του connector για το Looker Studio. Το Looker Studio διαβάζει τα Google Sheets με τον δικό του connector, οπότε το φύλλο που αναφέραμε είναι η γέφυρα: το προσθέτετε μία φορά ως πηγή δεδομένων 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 ως προσαρμοσμένο connector με τη διεύθυνση 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. Ό,τι φτιάχνει δημιουργείται σε παύση.

Γιατί δεν υπάρχει πεδίο Public Key στη σελίδα API του Apple Ads;

Επειδή είστε συνδεδεμένοι ως 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 περιορίζει ένα client secret σε 180 ημέρες, γι' αυτό οι δικές της οδηγίες σάς ζητούν να το σημειώσετε στο ημερολόγιό σας. Το Hermoso κρατά το ιδιωτικό κλειδί και εκδίδει νέο, βραχύβιο secret για κάθε ανταλλαγή διακριτικού, οπότε δεν υπάρχει τίποτα σε αρχείο ρυθμίσεων που να λήγει.

Μπορώ να εξάγω δεδομένα του Apple Search Ads σε Google Sheets ή Looker Studio;

Ναι. Συνδέστε το Google Drive δίπλα στο Apple Ads στο Hermoso, και ο πράκτορας γράφει την αναφορά σε Google Sheet με το create_sheet ή το append_to_sheet. Το Hermoso δεν έχει εγγενή connector για το Looker Studio· το Looker Studio διαβάζει εκείνο το φύλλο με τον δικό του connector Google Sheets.

Μπορώ να πάρω δεδομένα του Apple Search Ads σε JSON;

Ναι. Καλέστε το POST /v1/tools/apple_ads_report στο API του Hermoso με κλειδί API και διαβάστε το data.rows από την απάντηση, ή τρέξτε το hermoso call apple_ads_report --json '{...}' --structured από το CLI.