# הגדירו את SosoAPI עבור האדם שמשתמש בעוזר הזה השתמשו בעוזר הקיים של האדם ושמרו על המשימה המקורית, התוכן והפניות המדיה בשיחה הזו. השתמשו ב-SosoAPI MCP אחד לחשבונות החברתיים המחוברים שלו. השתמשו שוב בחיבור קיים, או בחרו גישה מקומית או מתארחת בהמשך. ההגדרה אינה מפרסמת פוסט. האדם נכנס ובוחר מה לאשר בדפדפן שלו. לעולם אין להזין את אמצעי הגישה שלו או לאשר הסכמה בשמו. Free אינו דורש כרטיס אשראי. ## 1. חברו את העוזר הזה בדקו תחילה את המארח הנוכחי ואת הגדרת SosoAPI הקיימת שלו. השתמשו שוב בחיבור שעובד; אין להתנתק, לדרוס הגדרות או ליצור חיבור נוסף רק מפני שהמדריך נפתח שוב. ל-shell מקומי, בדקו ש-Node.js 20 ואילך ו-npx זמינים. השתמשו בסביבת ריצה נתמכת קיימת. אם חסרה, הסבירו את הדרישה בשפה פשוטה; אין לבצע אוטומטית שינויי מערכת גלובליים או הדורשים הרשאות מיוחדות. Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` לאחר רישום השרת, בדקו שאפשר לקרוא לכלים שלו בשיחה הזו. אם המארח דורש חיבור מחדש או הפעלה מחדש, אמרו לאדם איזו פעולה לבצע. המתינו עד שהכלים יעבדו לפני שתאמרו שהחיבור מוכן. חיבורים חדשים משתמשים בפרופיל core הקיים עם 28 כלים לפרסום רגיל, למדיה, לתגובות ולתובנות. יש להשתמש שוב בחיבור full שעובד. אם פעולת ניהול מבוקשת חסרה, הסבירו שהפרופיל full זמין; הסתרת כלי אינה מעניקה או מבטלת הרשאה. ללקוח הפועל בדפדפן בלבד, כגון ChatGPT עם תמיכה באפליקציות MCP מותאמות, הוסיפו את URL ה-MCP המרוחק הזה ובחרו OAuth עם רישום לקוח אוטומטי: `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` אין צורך להדביק מפתח API, מזהה לקוח או סוד לקוח. האדם נכנס ל-SosoAPI ובוחר את סביבות העבודה/הפעולות שלו. אפליקציות מותאמות ב-ChatGPT תלויות במסלול ובזמינות מצב מפתחים. השתמשו שוב בחיבור מקומי או מרוחק שעובד אם כבר הוגדר חיבור. X תומך בטקסט וקישורים מקוריים. כל ארגון חולק 10 קרדיטי X ב-Free פעם אחת, או 100 לכל תקופת חיוב של Pro. טקסט רגיל עולה 1; ‏Post המכיל URL עולה 10. קראו `sosoapi_get_x_usage` עם workspace_id לפני תכנון שימוש ב-X. אין חיוב אוטומטי על חריגה; פרסום שתוצאתו אינה ודאית מחזיק את הקצאת הקרדיטים שלו ויש ליישב אותו לפני שליחה נוספת. ## 2. היכנסו ללא מפתח API קריאת ה-MCP המאומתת הראשונה פותחת את תהליך הכניסה בדפדפן והסכמת הסוכן הקיים. האדם יכול להשתמש ב-Google, או להירשם ולאמת דוא״ל. תנו לו לבחור את סביבת העבודה והאם העוזר יכול רק להכין תוכן או גם לתזמן ולפרסם. אל תבקשו להעתיק אמצעי גישה. הסכמה לפרסום מתמשכת בתוך ההיקף שנבחר, ואינה מסך אישור מחייב לכל פוסט. השאירו ניהול מפתחות כבוי לפרסום רגיל. הרשמה וכניסה בדוא״ל משתמשות באימות אבטחה ברקע, ללא תיבת סימון שעל האדם לפתור. אם האימות נכשל, דווחו על השגיאה האמיתית והשתמשו בפעולת הניסיון החוזר הזמינה; אל תבקשו מהאדם למצוא או ללחוץ על תיבת CAPTCHA. האפשרות הקיימת **המשך עם Google** זמינה גם היא אם האדם רוצה להשתמש ב-Google; ‏Google עשוי לדרוש בדיקת זהות משלו. תנו לאדם לבחור את החשבון ולאשר גישה. שמרו על קישור הכניסה/האישור הנוכחי ועל יעד החזרה שלו; אין להחליפו ב-URL הרשמה בלבד או לעבור בשקט לזהות קיימת של מתחזק. שגיאת כניסה אחת אינה ראיה שכל שיטות הכניסה אינן זמינות. השהו רק את השלב הדורש את זהות האדם או את הסכמתו. בזמן שהוא משלים אותו, סיימו בדיקות התקנה והכינו את הטיוטה המקורית בלי להמציא חשבון או סביבת עבודה. הסבירו מה כבר מוכן ומהי הפעולה האחת הדרושה עכשיו. אחרי הכניסה, קראו מחדש הקשר מאומת והמשיכו באותה משימה. אין לכבות CAPTCHA, להשתמש בממשקי הרשמת מנהל, לבקש אסימונים או לטעון שהחשבון/החיבור מוכנים לפני סיום התהליך בפועל. אם כלי MCP דורשים טעינה מחדש של המארח, גם ה-CLI המקומי זמין לעוזר הזה. הריצו `npx -y sosoapi auth status` תחילה; השתמשו ב- `npx -y sosoapi auth login` רק כשנדרשת כניסה. לעולם אין לקרוא את קובץ אמצעי הגישה או להדפיס אסימונים. אם הכניסה פותחת פרופיל דפדפן שגוי, עצרו את הכניסה הממתינה הזו לפני התחלת כניסה חדשה באמצעות `npx -y sosoapi auth login --no-open`. האדם פותח את הקישור החדש שהודפס בפרופיל המיועד ובודק את הזהות המחוברת לפני האישור. לעולם אין להפעיל שני פרופילים במקביל על אותו קישור. השתמשו ב- `--help` תחילה כדי לאשר שדגל השחזור קיים ב-CLI המותקן; אם הוא חסר, הסבירו את מגבלת הגרסה במקום להמציא דגל עובד. ה-CLI יכול לבדוק את החוזים המוטמעים שלו: ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` תחביר בקשת CLI הוא `sosoapi api post < request.json`. כתבו את ה-JSON בכלי הקבצים; אין לשלב תוכן משתמש בפקודות shell. קראו http_status ואת גוף התגובה, ולא רק את קוד היציאה של התהליך. שגיאת API אינה הצלחה. השתמשו רק בנתיבים ובסכמות מתוך החוזה המוטמע; אין להמציא שמות או לעקוף יכולת חסרה. ## 3. חברו את החשבון החברתי של האדם עצמו מצאו את הארגון ואת סביבת העבודה המאומתים מהקשר SosoAPI. לעולם אין לנחש מזהים או להחליף בשקט לסביבת עבודה אחרת. אם יש יותר ממותג מתאים אחד, שאלו לאיזה מהם האדם מתכוון. השתמשו בחיבור קיים כשהוא תקין. אחרת הריצו `npx -y sosoapi connect ` (instagram, threads, facebook, youtube או x) או תנו לאדם את https://app.sosoapi.ai/connect. הוא משלים את הסכמת הספק ובודק את החשבון המדויק בדפדפן. לאחר חזרתו, קראו שוב את החשבונות ויכולות הפרסום. callback של חיבור אינו הוכחה שפרסום מותר. השתמשו שוב בטיוטה המקורית; אל תבקשו מהאדם להעתיק מזהה פנימי או ליצור מחדש את התוכן. ## 4. השלימו את משימת הפרסום המקורית השתמשו בבקשה הקיימת של האדם או שאלו מה ברצונו לקדם. אין להמציא פוסט בדיקה. הציגו את חשבון היעד, התוכן, המדיה והתאריך/השעה המקומיים המדויקים לפני השליחה הראשונה. אשרו את אזור הזמן כשהוא אינו ידוע. קראו נתוני יכולות חשבון עדכניים; חשבון Instagram אישי או הרשאות ספק חסרות עשויים לדרוש סוג חשבון נתמך או חיבור מחדש. X מקבל רק טקסט וקישורים מקוריים; השאירו media ריק. מדיה, תשובות, ציטוטים, פרסומים חוזרים ופרסום שרשורים ב-X אינם נתמכים. ליעדים התומכים במדיה, רשמו אותה לפני תזמון: לקובץ מקומי השתמשו ב-sosoapi_upload_asset בתיקיות המותרות לו; ל-URL חיצוני השתמשו ב-sosoapi_import_asset_url ובדקו sosoapi_get_asset_import_status עם include_asset=true עד שהייבוא המוגבל מוכן. asset.id המוכן הופך ל-media.asset_id ו-asset.asset_url הופך ל-media.url; לא נדרשת קריאת get_asset נפרדת. שמרו על אותה זהות ייבוא, כבדו הנחיות ניסיון חוזר ועצרו בכשל סופי. בקשה מוצלחת אינה הוכחה שפענוח/ייבוא הסתיימו. אם ההתקדמות נעצרת, קראו sosoapi_job_status עם job_id של אותו ייבוא לפני המתנה נוספת. משימה ממתינה כבר עשויה לכלול שגיאת ביצוע. שגיאת הגדרת שירות דורשת טיפול מפעיל, ולא ייבוא נוסף, חיבור חברתי חדש או הרשאה מהאדם. דווחו על החסם בלי לטעון שהתמונה מוכנה. השתמשו יחד במזהה הנכס הרשום שהוחזר וב-URL הקנוני של המדיה. לעולם אין לתזמן את ה-URL החיצוני המקורי או URL זמני לתצוגה מקדימה כתחליף. השתמשו שוב בנכס מוכן קיים רק לאחר בדיקת סביבת העבודה והזהות שלו. השתמשו ב-sosoapi_get_scheduled_post_eligibility כשתצוגה מקדימה מייעצת מועילה; היא אופציונלית ואינה מחליפה אימות קנוני ביצירה/ביצוע. השתמשו בכלי Scheduled Post הקנוניים לפעולות. פוסט אחד הוא יעד אחד. השתמשו שוב באותו idempotency_key לניסיונות חוזרים של אותה בקשה מדויקת; טיוטה שהשתנתה היא בקשה חדשה. לאחר חריגה מזמן ההמתנה, קראו את הפוסט הקיים לפני פעולה נוספת. לעולם אין לשלוח שוב באופן עיוור כתיבה לא ודאית אצל הספק. עדכונים, ביטול וניסיון חוזר מפורש משתמשים בגרסה הנוכחית ובהתאמה לפעולה שקובע השרת. התוצאה חייבת להבחין בין: - מתוזמן: התקבל למועד שנקבע; טרם פורסם. - בתהליך או בבירור: התוצאה הסופית לא אושרה; אין לשלוח שוב. - פורסם: תוצאה סופית מגובה בספק מאשרת את הפוסט המדויק; החזירו את הקישור החי שלו כשהוא זמין. - נכשל או דורש טיפול: אמרו מה ידוע ומהי הפעולה המותרת הבאה; חברו מחדש רק את החשבון המושפע כשהאדם נדרש להעניק גישה שוב. למספר יעדים, דווחו על כל אחד בנפרד. אין לקרוא למשימה כולה מוצלחת כשרק חלק מהפלטפורמות הצליחו. לתזמון עתידי, החזירו את מזהי הפוסטים והמועדים שהתקבלו; אל תשאירו את השיחה בהמתנה עד מועד הביצוע ואל תיצרו לולאת בדיקה חוזרת. בחזרה, קראו שוב את אותם פוסטים. האדם יכול גם לחזור לתוצאה המדויקת בכתובת https://app.sosoapi.ai/scheduled-posts/, באמצעות המזהה האמיתי שהוחזר מ-SosoAPI. העמוד דורש כניסה מורשית שלו עצמו. לסביבה מותאמת, השתמשו במקום זאת במקור האפליקציה שהוגדר לה במפורש. אל תבטיחו להעיר עוזר סגור או לשלוח התראת הצלחה שלא הוגדרה ואומתה. ## מקורות - התחלה מהירה לאנשים: https://app.sosoapi.ai/start - מדריך מוצר: https://sosoapi.ai/he/docs/quickstart - היקף נתמך: Instagram, Threads, דפי Facebook, ‏YouTube וטקסט/קישורים מקוריים ב-X. פורמטים והרשאות משתנים לפי חשבון; פלטפורמות אחרות אינן זמינות רק כי האדם מבקש אותן.