Apple Search Ads को Claude या ChatGPT से पांच मिनट में कनेक्ट करें

Hermoso का Apple Search Ads कनेक्टर आपके Apple Ads अकाउंट को Claude, ChatGPT, Cursor, CLI या सादा HTTP से जोड़ता है, ताकि एजेंट आपके App Store सर्च विज्ञापन चला सके। वह कैंपेन, ad group, टारगेटिंग keywords और negatives बनाता है, Apple में जो वाकई सेव हुआ है उसे दोबारा पढ़कर जाँचता है, और परफ़ॉर्मेंस को उस search term तक रिपोर्ट करता है जो किसी ने इंस्टॉल से पहले टाइप किया था। जो भी बनता है वह paused बनता है, और spend चालू करना एक अलग, साफ़ तौर पर पुष्ट किया गया कदम है। रिपोर्ट Google Sheet, Looker Studio डैशबोर्ड या JSON फ़ाइल में जा सकती हैं, और Apple Ads MCP पेज पर लिखा है कि यह कनेक्टर क्या-क्या कर सकता है।

कनेक्ट करने में लगभग पांच मिनट लगते हैं। आपको openssl नहीं चलाना पड़ेगा, और कोई Apple पासवर्ड Hermoso तक नहीं जाता।

Apple Search Ads को Claude से कैसे कनेक्ट करें

Apple Search Ads को Claude से जोड़ने के लिए Hermoso को Claude में एक कनेक्टर के रूप में जोड़ें, फिर Hermoso में अपना Apple Ads अकाउंट एक बार कनेक्ट करें। Claude में Customize › Connectors › Add custom connector खोलें, नाम Hermoso रखें, https://app.hermoso.ai/mcp पेस्ट करें और अपने Hermoso अकाउंट से मंज़ूरी दें। Claude में कोई कुंजी पेस्ट नहीं करनी होती। फिर Hermoso में सेटिंग्स › Connectors के अंतर्गत Apple Ads कनेक्ट करें, इस पेज पर आगे दिए चरणों के अनुसार। उसके बाद Claude Hermoso के हर Apple Ads टूल को कॉल कर सकता है: रिपोर्ट, कीवर्ड बदलाव या नया कैंपेन, सब सादे शब्दों में माँगें। Claude Code में इसके लिए दो कमांड हैं: /plugin marketplace add hermoso-ai/hermoso, फिर /plugin install hermoso@hermoso। पूरे चरणों के लिए Claude में Hermoso देखें।

Apple Search Ads को ChatGPT से कैसे कनेक्ट करें

ChatGPT भी इसी तरह काम करता है। ChatGPT में Plugins खोलें, फिर Add › Create MCP App चुनें, नाम Hermoso रखें, Server URL के रूप में https://app.hermoso.ai/mcp पेस्ट करें, Authentication को OAuth पर रहने दें और अपने Hermoso अकाउंट से मंज़ूरी दें। अगर Create MCP App नहीं दिखता, तो Settings › Plugins › Developer mode के अंतर्गत एक बार Developer mode चालू करें। Hermoso में Apple Ads कनेक्ट होने पर ChatGPT आपकी keyword रिपोर्ट खींच सकता है, उसे Google Sheet में लिख सकता है, या आपकी जाँच के लिए कैंपेन का ड्राफ़्ट बना सकता है। ChatGPT में Hermoso इसे समझाता है।

Cursor, Codex और कोई भी दूसरा MCP क्लाइंट

जो भी क्लाइंट Model Context Protocol बोलता है, वह उसी पते पर वही टूल पाता है। Cursor https://app.hermoso.ai/mcp को अपनी mcp.json से पढ़ता है; Codex के लिए codex plugin marketplace add hermoso-ai/hermoso से Hermoso प्लगइन जुड़ता है, जो टर्मिनल से वही टूल चलाता है। आप जो भी क्लाइंट इस्तेमाल करें, आपके Apple क्रेडेंशियल चैट से होकर नहीं गुज़रते। एजेंट Hermoso के टूल कॉल करता है, और Hermoso हर अनुरोध को उस कुंजी से साइन करके Apple को भेजता है जो उसके पास है। Apple Ads MCP पेज हर टूल की सूची देता है।

कनेक्ट होने के बाद क्या पूछें

• “पिछले हफ़्ते का Apple Search Ads परफ़ॉर्मेंस कीवर्ड के हिसाब से निकालो और मुझे वे दस दिखाओ जिनकी cost per acquisition सबसे ज़्यादा है।”
• “पिछले 30 दिनों का spend, installs और CPA कैंपेन के हिसाब से एक नई Google Sheet में डालो, जिसका नाम Apple Ads हो।” (पहले Google Drive कनेक्ट करें।)
• “इस महीने मेरे US कैंपेन में कौन-से search terms से installs आए जिन पर मैंने अभी तक exact keywords के रूप में बिड नहीं लगाई है?”
• “Brand ad group में ‘budget planner’ और ‘expense tracker’ को exact match keywords के रूप में जोड़ो, और ‘jobs’ को negative।”
• “Apple मेरे ऐप के लिए कौन-से keywords सुझाता है, और जिन पर मैं पहले से बिड लगाता हूँ उनमें मेरे impressions का कितना हिस्सा मिल रहा है?”
• “UK में मेरे ऐप के लिए 50 डॉलर रोज़ के बजट वाला एक paused कैंपेन बनाओ, फिर दिखाओ कि Apple ने क्या सेव किया।”

रिपोर्ट पढ़ने से spend कभी नहीं छूता। एजेंट जो भी बनाता है वह paused बनता है, और spend चालू करने वाला स्विच आपकी साफ़ पुष्टि का इंतज़ार करता है।

पहले वह चीज़, जो ज़्यादातर लोगों को रोक देती है

Apple के अपने निर्देश कहते हैं: “Ads UI से Account Settings › API चुनें। कुंजी को Public Key फ़ील्ड में पेस्ट करें।”

वह फ़ील्ड Account Admin को दिखता ही नहीं। अपने अकाउंट पर admin के रूप में साइन इन करें, Account Settings › API खोलें, और जो दिखता है वह एक टेबल है जिसका हेडर Manage API Access है (third-party सेवा प्रदाताओं की सूची, जिसमें एक ही कार्रवाई है, Remove Access), और पूरे पेज पर कहीं कोई कुंजी फ़ील्ड नहीं। यह बिल्कुल किसी गायब फ़ीचर जैसा लगता है, इसीलिए लोग यहीं रुक जाते हैं और मान लेते हैं कि उनके लिए API उपलब्ध ही नहीं।

API उपलब्ध है। Public Key फ़ील्ड उस उपयोगकर्ता का है जिसके पास API रोल है, और अकाउंट का admin होना कोई API रोल नहीं है। Apple के invite डायलॉग में छह रोल हैं, जिनमें से ठीक दो API रोल हैं:

• API Account Manager: “read and write access to all campaign groups for API management”। अगर आप चाहते हैं कि Hermoso सिर्फ़ रिपोर्ट नहीं, कैंपेन भी बनाए, तो यही चुनें।
• API Account Read Only: “read only access to all campaign groups for API management”। रिपोर्टिंग के लिए काफ़ी है, और उससे आगे कुछ नहीं।

बाकी चार (Account Admin, Account Finance, Account Read Only और Limited Access) API credentials बिल्कुल नहीं बना सकते। तो हल यह है कि खुद को एक invite भेजें:

1. Account Settings › User Management खोलें और Invite Users चुनें।
2. ऐसा पता invite करें जो आपके नियंत्रण में हो (आपका अपना, या कोई साझा पता जैसे ads-api@yourcompany.com, ताकि credential किसी एक व्यक्ति से आगे भी चले) और रोल API Account Manager रखें।
3. उस inbox से invitation स्वीकार करें, फिर Apple Ads में साइन इन करें उस उपयोगकर्ता के रूप में।

अब Account Settings › API पर एक Public Key फ़ील्ड मौजूद है।

कनेक्शन, चरण-दर-चरण

1. Hermoso में शुरू करें। सेटिंग्स › Connectors › Apple Ads › Connect। Hermoso एक EC P-256 साइनिंग कुंजी बनाता है (वही prime256v1 कुंजी जो Apple के दो openssl कमांड बनाते) और आपको सिर्फ़ public हिस्सा दिखाता है। उसे कॉपी करें।
2. public हिस्सा Apple को दें। API रोल वाले उपयोगकर्ता के रूप में Account Settings › API खोलें, उसे Public Key में पेस्ट करें और Save करें।
3. तीनों ids वापस कॉपी करें। अब Apple उस फ़ील्ड के ऊपर clientId, teamId और keyId छापता है। तीनों।
4. Hermoso में पूरा करें। तीनों ids पेस्ट करें और सेव करें। Hermoso Apple के साथ टोकन का आदान-प्रदान करता है और कुछ भी स्टोर करने से पहले आपकी organization सूची पढ़ता है, इसलिए गलत टाइप की गई id वहीं फ़ेल हो जाती है, जब आप अभी भी देख सकते हैं कि आपने क्या पेस्ट किया, न कि एक घंटे बाद पहली रिपोर्ट पर।
5. organization चुनें, अगर आपके क्रेडेंशियल एक से ज़्यादा organization कवर करते हैं। कनेक्शन उसी एक से जुड़ता है जो आप चुनते हैं।

कुछ गलत हो जाए तो

API पेज पर Public Key फ़ील्ड नहीं है

आप Account Admin के रूप में साइन इन हैं, या चार गैर-API रोल में से किसी एक के रूप में। खुद को API Account Manager के रूप में invite करें और उस उपयोगकर्ता के रूप में साइन इन करें (ऊपर देखें)। Apple Ads कनेक्शन कभी न बन पाने का यह सबसे आम कारण है।

Apple क्रेडेंशियल ठुकरा देता है

तीनों ids उसी कुंजी के होने चाहिए जिसे Apple रखे हुए है। clientId, teamId और keyId को Public Key फ़ील्ड के ठीक ऊपर से दोबारा कॉपी करें, किसी पुरानी कुंजी से नहीं जिसे आपने बदल दिया था। अगर फिर भी फ़ेल हों, तो Hermoso में कनेक्शन नए सिरे से शुरू करें: उससे एक नया key pair बनता है, और नया public हिस्सा Apple में पेस्ट करें।

सेटअप सत्र समाप्त हो गया

जब आप Apple में उसका public हिस्सा पेस्ट करने जाते हैं, तब Hermoso बनी हुई निजी कुंजी 24 घंटे तक रखता है। उसके बाद वह जानबूझकर हटा दी जाती है। कनेक्शन फिर शुरू करें और नई public key पेस्ट करें।

मैंने openssl से पहले ही कुंजी बना ली थी

तो उसी का इस्तेमाल करें। कनेक्ट करते समय Hermoso की कुंजी के बजाय अपनी मौजूदा EC P-256 निजी कुंजी पेस्ट करें, और आपके Apple अकाउंट में पहले से रखी public key काम करती रहेगी। यह EC P-256 (prime256v1) होनी चाहिए। Apple कोई दूसरा curve स्वीकार नहीं करता।

मैं कई Apple Ads organizations सँभालता हूँ

हर organization को उसके अपने Hermoso profile में कनेक्ट करें। कनेक्शन एक ही organization से बँधा होता है, और यही रोकता है कि किसी एजेंसी का कैंपेन किसी दूसरे क्लाइंट के अकाउंट में न पहुँचे।

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 (status, serving status, रोज़ और कुल बजट, वे देश जहाँ कैंपेन चलता है, और जब कोई कैंपेन न चल सके तो Apple का अपना बताया कारण), list_apple_ads_ad_groups (default bid, और Apple का Search Match चालू है या नहीं), list_apple_ads_keywords (targeting और negative, match type और bid के साथ), apple_ads_report (impressions, taps, installs, spend, TTR, CPT और CPA, campaign, ad group, ad, keyword या search-term लेवल पर) और list_apple_ads_orgs।

यह सब Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes या किसी भी दूसरे MCP क्लाइंट से, और वेब स्टूडियो से भी चलता है। दोनों तरीकों से इंजन एक ही है। MCP overview या ads tool reference देखें।

और भी: यह creatives और ads बनाता है (create_apple_ads_creative, create_apple_ads_ad), एक कॉल में 1,000 तक keywords लोड करता है (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 campaign, ad group, ad, keyword और search-term परफ़ॉर्मेंस (impressions, taps, installs, spend, tap-through rate, cost per tap और cost per acquisition) खींचता है, कुल के रूप में या hourly, daily, weekly या monthly सीरीज़ में, एक पेज में 5,000 पंक्तियों तक। रिपोर्ट पढ़ने से spend कभी नहीं छूता। पंक्तियाँ कहाँ जाएँ, यह आप तय करते हैं, और सबसे आम तीन जगहें नीचे हैं। पूरी गाइड Apple Search Ads से डेटा एक्सपोर्ट करें पर है।

Apple Search Ads को Google Sheets से कनेक्ट करें

Apple Ads के साथ Google Drive कनेक्ट करें (एक Google अनुमति Drive, Sheets और Docs तीनों को कवर करती है) और अपने एजेंट से रिपोर्ट को शीट में डालने को कहें। वह apple_ads_report कॉल करता है, फिर नई spreadsheet के लिए create_sheet, या मौजूदा शीट में इस हफ़्ते की पंक्तियाँ जोड़ने के लिए append_to_sheet। Hermoso drive.file scope इस्तेमाल करता है, इसलिए वह सिर्फ़ उन फ़ाइलों तक पहुँचता है जो उसने बनाईं या आपने चुनीं। चरण-दर-चरण: 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 में एक्सपोर्ट करें

raw पंक्तियों के लिए, API कुंजी के साथ Hermoso REST API पर टूल कॉल करें: POST https://app.hermoso.ai/v1/tools/apple_ads_report रिपोर्ट arguments को JSON बॉडी के रूप में भेजकर, और जवाब में data.rows से पंक्तियाँ पढ़ें। टर्मिनल से, npx -y hermoso call apple_ads_report --json '{...}' --structured वही नतीजा JSON में प्रिंट करता है। एक पूरा उदाहरण अनुरोध।

अक्सर पूछे जाने वाले प्रश्न

Apple Search Ads को Claude से कैसे कनेक्ट करें?

Claude में https://app.hermoso.ai/mcp URL के साथ Hermoso को कस्टम कनेक्टर के रूप में जोड़ें और अपने Hermoso अकाउंट से मंज़ूरी दें, फिर Hermoso में Settings › Connectors के अंतर्गत Apple Ads कनेक्ट करें। फिर Claude Hermoso के Apple Ads टूल्स से आपके Apple Search Ads कैंपेन की रिपोर्ट ले सकता है, उनमें बदलाव कर सकता है और उन्हें बना सकता है।

क्या ChatGPT मेरा Apple Search Ads डेटा पढ़ सकता है?

हाँ। ChatGPT में Plugins › Add › Create MCP App के अंतर्गत https://app.hermoso.ai/mcp जोड़ें, और Hermoso में Apple Ads कनेक्ट करें। फिर ChatGPT impressions, taps, installs, spend, TTR, CPT और CPA को campaign, ad group, ad, keyword या search term के हिसाब से खींच सकता है, और पंक्तियाँ Google Sheet में लिख सकता है।

क्या Apple Search Ads का MCP सर्वर है?

हाँ। Hermoso का hosted MCP सर्वर https://app.hermoso.ai/mcp पर पूरा Apple Ads टूलसेट Claude, ChatGPT, Cursor, Codex या किसी भी MCP क्लाइंट को देता है: रिपोर्टिंग, कैंपेन, ad groups, keywords और negatives, creatives और ads, और Apple के keyword सुझाव। जो भी वह बनाता है वह paused बनता है।

Apple Ads API पेज पर Public Key फ़ील्ड क्यों नहीं है?

क्योंकि आप Account Admin के रूप में साइन इन हैं। Apple वह फ़ील्ड सिर्फ़ उस उपयोगकर्ता को दिखाता है जिसके पास API रोल है। admin को उसकी जगह “Manage API Access” टेबल दिखती है, जिसमें third-party सेवा प्रदाता होते हैं, और पूरे पेज पर कोई कुंजी फ़ील्ड नहीं होता। Account Settings › User Management के अंतर्गत खुद को API Account Manager के रूप में invite करें, उस उपयोगकर्ता के रूप में साइन इन करें, और फ़ील्ड वहाँ होगा।

मुझे कौन-सा Apple Ads रोल चाहिए?

API Account Manager, अगर आप चाहते हैं कि Hermoso कैंपेन, ad groups और keywords बनाए। Apple इसे “read and write access to all campaign groups for API management” बताता है। API Account Read Only तब काफ़ी है जब आपको सिर्फ़ रिपोर्टिंग चाहिए। Apple के बाकी चार रोल (Account Admin, Account Finance, Account Read Only और Limited Access) API credentials बिल्कुल नहीं बना सकते।

क्या मुझे openssl चलाना होगा?

नहीं। Apple के अपने निर्देश आपको openssl के दो कमांड देते हैं; Hermoso EC P-256 key pair खुद बनाता है और आपको सिर्फ़ public हिस्सा दिखाता है। निजी हिस्सा वही है जो आपके अनुरोधों पर साइन करता है, और आप उसे कभी देखते, पेस्ट करते या स्टोर नहीं करते। अगर आपके पास किसी और टूल से बनी कुंजी है, तो आप वही ला सकते हैं।

क्या Apple Ads कनेक्ट करने का कोई खर्च है या spend का जोखिम?

नहीं। पढ़ने वाली कॉल मुफ़्त हैं, और Hermoso जो भी object बनाता है वह PAUSED बनता है, बिना किसी override के। किसी object को चालू करना ही असली spend चालू करने वाला एकमात्र स्विच है, और उसके लिए साफ़ पुष्टि चाहिए।

clientId, teamId और keyId क्या हैं?

तीन identifiers, जो Apple आपकी कुंजी सेव करने के बाद Public Key फ़ील्ड के ऊपर छापता है। वे Apple को बताते हैं कि आपका API उपयोगकर्ता कौन है; निजी कुंजी साबित करती है कि आप ही हैं। तीनों को Hermoso में वापस पेस्ट करें और कनेक्शन पूरा हो जाता है।

क्या एक कनेक्शन कई Apple Ads organizations को कवर कर सकता है?

एक कनेक्शन उस एक organization से बँधा होता है जिसे आप बनाते समय चुनते हैं। Apple orgId को कैंपेन ग्रुप जैसा मानता है, इसलिए एक login कई को कवर कर सकता है। जिस एजेंसी के हर organization में एक क्लाइंट है, वह हर एक को अपने Hermoso profile में कनेक्ट करती है।

क्या मुझे हर 180 दिन में कुंजी rotate करनी होगी?

नहीं। Apple client secret को 180 दिन तक सीमित रखता है, इसीलिए उसके अपने निर्देश rotation की याद रखने को कहते हैं। Hermoso निजी कुंजी रखता है और हर token exchange के लिए नया, छोटी अवधि का secret बनाता है, इसलिए किसी config फ़ाइल में कुछ नहीं पड़ा जो expire हो।

क्या मैं Apple Search Ads डेटा को Google Sheets या Looker Studio में एक्सपोर्ट कर सकता हूँ?

हाँ। Apple Ads के साथ Google Drive कनेक्ट करें और आपका एजेंट रिपोर्ट को create_sheet या append_to_sheet से Google Sheet में लिखता है। Hermoso में Looker Studio का नेटिव कनेक्टर नहीं है; Looker Studio उस शीट को अपने Google Sheets कनेक्टर से पढ़ता है।

क्या मैं Apple Search Ads डेटा JSON में ले सकता हूँ?

हाँ। API कुंजी के साथ Hermoso API पर POST /v1/tools/apple_ads_report कॉल करें और data.rows पढ़ें, या CLI से --structured के साथ hermoso call apple_ads_report चलाएँ।