SociaListSociaList

לסוכני AI

הריצו קמפיינים עם משפיענים באופן תוכנתי.

SociaList חושפת שרת Model Context Protocol (MCP) שמאפשר לסוכני AI לנהל עסקים, לטייט ולהפעיל התאמה לקמפיינים, ולנהל משא ומתן עם יוצרים בשם בעלי עסקים קטנים.

קראו את המפרט

חדשים כאן? התחילו מכאן.

סוכן AI הוא תוכנה — כמו Claude, ChatGPT עם כלים, או עוזר מותאם אישית — שיכולה לבצע פעולות עבורכם במקום רק לשוחח. SociaList מאפשרת לסוכן שלכם להריץ קמפיינים עם משפיענים בשמכם: הוא יכול ליצור את פרופיל העסק שלכם, לטייט קמפיינים, למצוא יוצרים ולהגיב להצעות שלהם. אתם נשארים בשליטה על הדברים שעולים כסף — מימון קמפיין והוצאתו לאוויר עדיין דורשים קליק שלכם. שאר הדף הזה הוא ההגדרה הטכנית שהסוכן שלכם (או המפתח שלו) צריך כדי להתחבר.

רוצים הסבר פשוט בעברית? עיינו בסעיף סוכני AI בשאלות הנפוצות.

מה SociaList עושה

SociaList מחברת עסקים קטנים עם יוצרים מקומיים ב-YouTube, Instagram ו-TikTok לקמפיינים מבוססי ביצועים. עסקים קובעים תקציב ויעד חשיפה; הפלטפורמה מתאימה אותם ליוצרים, מתווכת בהסכם, ומשלמת באופן יחסי לצפיות בפועל בחלון ביצוע של 7 ימים.

איך סוכנים מתחברים

שרת ה-MCP משתמש ב-OAuth 2.1 עם PKCE ורישום לקוחות דינמי (DCR). כל לקוח MCP תואם (Claude Desktop, Anthropic Agent SDK, MCP Inspector או משלכם) יכול לגלות, להירשם ולהיכנס בלי הגדרה ידנית.

נקודת קצה של MCP

https://api.thesocialistapp.com/mcp

תעבורה

Streamable HTTP (JSON-RPC + SSE)

מטא-דאטה של המשאב

https://api.thesocialistapp.com/.well-known/oauth-protected-resource

מטא-דאטה של שרת ההרשאות

https://api.thesocialistapp.com/.well-known/oauth-authorization-server

הזרימה

  1. 1

    גילוי

    משכו את /.well-known/oauth-protected-resource כדי ללמוד על שרת ההרשאות, ההיקפים הנתמכים ודרישות אסימון ה-Bearer.

  2. 2

    רישום

    שלחו POST ל-/oauth/register עם שם הלקוח וכתובות ה-redirect כדי לקבל client_id (RFC 7591 רישום לקוחות דינמי; ללא client secret — לקוח ציבורי).

  3. 3

    הרשאה

    הפנו את המשתמש ל-/oauth/authorize עם PKCE (S256). המשתמש מתחבר ומאשר את ההיקפים המבוקשים במסך ההסכמה. רק חשבונות בעלי עסקים יכולים להעניק גישה לסוכנים.

  4. 4

    החלפה

    שלחו את הקוד שהוחזר יחד עם ה-code_verifier ב-POST ל-/oauth/token כדי לקבל אסימון גישה (שעה) ואסימון רענון (30 ימים). אסימוני רענון מסתובבים בכל שימוש.

  5. 5

    קריאה לכלים

    שלחו בקשות JSON-RPC ל-/mcp עם Authorization: Bearer <access_token>. השרת מחזיר את tools/list הסטנדרטי ומפעיל tools/call מול סט הכלים הרשום.

היקפי הרשאה

סוכנים מבקשים רק את ההיקפים המינימליים שהם צריכים. האסימונים אטומים ומאוחסנים בגיבוב.

sbo:read

רשימה ובדיקה של עסקים, קמפיינים, הזמנות, שרשורי הודעות, ספריית המשפיענים והגדרות מטבע ומיקום.

sbo:write

יצירה ועדכון של עסקים וקמפיינים בטיוטה, התחלת התאמה, מענה להצעות ושליחת הודעות בשם בעל העסק.

כלים זמינים

הכלים נרשמים במפורש — נקודות קצה חדשות בשרת לא נחשפות אוטומטית. פעולות שמערבות העברת כסף (מימון והוצאת קמפיין לאוויר) הוצאו בכוונה עד שיותקן שער של אישור אנושי.

קריאה (sbo:read)

list_businesses

עסקים בבעלות בעל העסק המעניק את ההרשאה.

get_business

פרטי עסק מלאים עם נתונים מצטברים.

list_campaigns

קמפיינים, אופציונלית מסוננים לפי עסק וסטטוס.

get_campaign

פרטי קמפיין מלאים.

list_campaign_invites

כל ההזמנות וההצעות לקמפיין.

get_inbox

הצעות והזמנות מכל הקמפיינים, אופציונלית מסוננות לפי סטטוס.

get_invite_messages

שרשור הודעות בין בעל העסק והיוצר על הזמנה.

browse_influencers

ספריית משפיענים מעומודת עם סינון לפי נישה, מיקום ופלטפורמה.

list_approved_locations

מדינות נתמכות עם מטבע, locale וטווחי תקציב.

get_currency_config

מטבע, גבולות תקציב ומכפיל חשיפה למדינה.

list_cold_pitches

BusinessPitches נכנסות מכל העסקים של בעל העסק (יזומות על ידי יוצרים, לפני קמפיין).

get_cold_pitch

הצעת יוצר קרה אחת עם כרטיס היוצר ושרשור השיחה המלא.

list_notifications

פיד התראות בתוך האפליקציה עם דפדוף מבוסס cursor וסינון לפי לא-נקראו וקטגוריה.

get_unread_notification_count

מספר ההתראות שלא נקראו — שאילתת תג זולה.

כתיבה (sbo:write)

create_business

יצירת פרופיל עסק.

update_business

עדכון שדות עסק.

delete_business

מחיקת עסק (נדחית אם יש לו קמפיינים פעילים).

create_draft_campaign

יצירת קמפיין במצב DRAFT. תומך גם ב-from_pitch_id להמרת BusinessPitch קרה לקמפיין בקריאה אחת. מוגבל ל-10 ביום למשתמש.

update_campaign

עדכון שדות הקמפיין (תלוי בסטטוס).

delete_campaign

מחיקת קמפיין במצב DRAFT.

start_matching

מעבר DRAFT → MATCHING והרצת מנוע ההתאמה.

revert_campaign_to_draft

החזרה מ-MATCHING ל-DRAFT, תוך שמירה על הזמנות קיימות.

accept_pitch

אישור הצעה ויצירת CampaignAgreement (מחייב).

decline_pitch

דחיית הצעה (ניתנת לשחזור באמצעות resend_invite).

send_pitch_reply

מענה בשרשור ההצעה ללא שינוי סטטוס ההזמנה.

resend_invite

שליחה מחדש של הזמנה שנדחתה עם תפוגה חדשה.

send_business_message

שליחת הודעה חופשית בשרשור ההזמנה.

reply_to_cold_pitch

מענה בשרשור של BusinessPitch קרה; המענה הראשון מעביר מ-PENDING ל-REPLIED.

decline_cold_pitch

סגירה שקטה של הצעה קרה (היוצר לא מקבל התראה, על פי עיצוב המוצר).

mark_notifications_read

סימון התראות ספציפיות בתוך האפליקציה כנקראו.

mark_all_notifications_read

סימון בבת אחת של כל ההתראות שלא נקראו כנקראו.

מגבלות ובקרות

  • יצירת קמפיינים

    10 קמפיינים בטיוטה למשתמש ביום (UTC).

  • תוקף האסימונים

    אסימוני גישה תקפים לשעה; אסימוני רענון ל-30 ימים עם סיבוב בכל רענון.

  • PKCE חובה

    S256 בלבד. קודי הרשאה הם חד-פעמיים; שימוש חוזר מבטל את כל שרשרת האסימונים.

  • בעלי עסקים בלבד

    רק חשבונות בעלי עסקים יכולים להעניק גישה לסוכנים. פעולות מצד היוצרים עדיין לא נחשפות דרך MCP.

  • ללא העברת כסף

    מימון, הוצאת קמפיינים לאוויר ותשלומים דורשים אישור אנושי ואינם ניתנים לקריאה על ידי סוכנים.

התחלה מהירה

רוב לקוחות ה-MCP צריכים רק את כתובת נקודת הקצה — הם מטפלים בגילוי ובאוטוריזציה אוטומטית. הדוגמה למטה מציגה את קריאות ה-HTTP הגולמיות ללקוחות שנכתבים מאפס.

1. Register a client
curl -X POST https://api.thesocialistapp.com/oauth/register \
  -H 'Content-Type: application/json' \
  -d '{
    "client_name": "My Agent",
    "redirect_uris": ["http://localhost:6274/oauth/callback"]
  }'
2. Exchange code for tokens
curl -X POST https://api.thesocialistapp.com/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "authorization_code",
    "code": "<code from /oauth/authorize>",
    "code_verifier": "<your PKCE verifier>",
    "redirect_uri": "http://localhost:6274/oauth/callback",
    "client_id": "<client_id from registration>"
  }'
3. Call a tool
curl -X POST https://api.thesocialistapp.com/mcp \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "list_businesses", "arguments": {} }
  }'

צריכים חשבון?

סוכנים פועלים בשם משתמש בעל עסק. הירשמו כבעל עסק, השלימו את האונבורדינג, ולאחר מכן חברו את הסוכן שלכם.