חברו את 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 ל-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 במפתח שברשותו. עמוד Apple Ads ב-MCP מפרט כל כלי.

מה לבקש אחרי שהחיבור פעיל

• “הציגו את הביצועים של 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, והיות מנהל החשבון אינו תפקיד כזה. בתיבת ההזמנה של 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 › 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 (סטטוס, מצב הגשה, תקציב יומי וכולל, המדינות שבהן הקמפיין רץ, והסיבה שאפל עצמה מציינת כשקמפיין לא יכול לרוץ), 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 כמחבר מותאם אישית עם הכתובת 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 יוצר נוצר במצב 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.