SosoAPI
HE
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
כניסה

החיפוש נטען רק כשמשתמשים בו. עיינו בכל הקטגוריות שלהלן.

כלי MCP

קבלת פרופיל פרויקט

sosoapi_get_project_profile

קריאת פרופיל המותג של פרויקט (סלוגן, קול, קהל יעד, מטרות, פלטת צבעים ועוד); profile הוא null כשאין פרופיל.

קריאה בפורמט Markdown

פרופילים ואמצעי תעבורה

פרופילים: full · אמצעי תעבורה: stdio, http

בחרו core או full כדי לשלוט בכלים שהלקוח רואה; הבחירה אינה משנה את ההרשאות שלו. העלאת קבצים מקומיים דורשת stdio ואינה זמינה דרך HTTP. הגדירו SOSOAPI_OUTPUT_SCHEMAS=1 להכללת סכמות פלט בגילוי הכלים. הכלים מחזירים תוצאות מובנות עם ההגדרה הזו או בלעדיה.

הרשאות והשפעות לוואי

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

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

שדות קלט

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

שדות קלט
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
project_idstringחובה באובייקט האב
  • format: "uuid"
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false
}

פלט מובנה

הסכמה מתארת את structuredContent בתוצאת כלי מוצלחת. תגובת MCP כוללת גם content ועשויה להגדיר isError כשקריאה נכשלת. בפרסום, קראו את התוצאה הסופית של הפוסט במקום לראות בבקשה שהתקבלה או בתגובת טקסט אישור. פעולת ה-API המקושרת מסבירה הרשאות וכללי ניסיון חוזר.

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

פלט מובנה
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
contract_versionstringחובה באובייקט האב
  • const: "project/v1"
profileobject | nullחובה באובייקט האב—
profileanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
profile.project_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
profile.workspace_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
profile.taglineanyOf 1string | nullחובה באובייקט האב—
profile.taglineanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.taglineanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.descriptionanyOf 1string | nullחובה באובייקט האב—
profile.descriptionanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.descriptionanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.voiceanyOf 1string | nullחובה באובייקט האב—
profile.voiceanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.voiceanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.target_audienceanyOf 1string | nullחובה באובייקט האב—
profile.target_audienceanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.target_audienceanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.color_paletteanyOf 1arrayחובה באובייקט האב—
profile.color_palette[]anyOf 1stringרשות / פריט—
profile.goalsanyOf 1arrayחובה באובייקט האב—
profile.goals[]anyOf 1stringרשות / פריט—
profile.no_go_topicsanyOf 1arrayחובה באובייקט האב—
profile.no_go_topics[]anyOf 1stringרשות / פריט—
profile.language_primaryanyOf 1stringחובה באובייקט האב—
profile.positioninganyOf 1string | nullחובה באובייקט האב—
profile.positioninganyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.positioninganyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.uspanyOf 1string | nullחובה באובייקט האב—
profile.uspanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.uspanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.visual_identityanyOf 1object | nullחובה באובייקט האב—
profile.visual_identityanyOf 1 / anyOf 1objectחובה באובייקט האב
  • additionalProperties: {}
profile.visual_identity.*anyOf 1 / anyOf 1any JSON valueרשות / פריט—
profile.visual_identityanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.forbidden_claimsanyOf 1arrayחובה באובייקט האב—
profile.forbidden_claims[]anyOf 1stringרשות / פריט—
profile.north_star_metricanyOf 1string | nullחובה באובייקט האב—
profile.north_star_metricanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.north_star_metricanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.posting_cadenceanyOf 1object | nullחובה באובייקט האב—
profile.posting_cadenceanyOf 1 / anyOf 1objectחובה באובייקט האב
  • additionalProperties: {}
profile.posting_cadence.*anyOf 1 / anyOf 1any JSON valueרשות / פריט—
profile.posting_cadenceanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.app_store_url_iosanyOf 1string | nullחובה באובייקט האב—
profile.app_store_url_iosanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.app_store_url_iosanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.app_store_url_androidanyOf 1string | nullחובה באובייקט האב—
profile.app_store_url_androidanyOf 1 / anyOf 1stringחובה באובייקט האב—
profile.app_store_url_androidanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.app_metadataanyOf 1objectחובה באובייקט האב
  • additionalProperties: {}
profile.app_metadata.*anyOf 1any JSON valueרשות / פריט—
profile.profile_versionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
profile.updated_byanyOf 1string | nullחובה באובייקט האב—
profile.updated_byanyOf 1 / anyOf 1stringחובה באובייקט האב
  • format: "uuid"
profile.updated_byanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.updated_by_kindanyOf 1stringחובה באובייקט האב
  • enum: ["jwt","api_key","delegated_ai","migration"]
profile.updated_by_api_key_idanyOf 1string | nullחובה באובייקט האב—
profile.updated_by_api_key_idanyOf 1 / anyOf 1stringחובה באובייקט האב
  • format: "uuid"
profile.updated_by_api_key_idanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.updated_by_delegated_grant_idanyOf 1string | nullחובה באובייקט האב—
profile.updated_by_delegated_grant_idanyOf 1 / anyOf 1stringחובה באובייקט האב
  • format: "uuid"
profile.updated_by_delegated_grant_idanyOf 1 / anyOf 2nullחובה באובייקט האב—
profile.created_atanyOf 1stringחובה באובייקט האב
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
profile.updated_atanyOf 1stringחובה באובייקט האב
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
profileanyOf 2nullחובה באובייקט האב—
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "project/v1"
    },
    "profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "project_id": {
              "type": "string",
              "format": "uuid"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid"
            },
            "tagline": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "voice": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "target_audience": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "color_palette": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "goals": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "no_go_topics": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "language_primary": {
              "type": "string"
            },
            "positioning": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "usp": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "visual_identity": {
              "anyOf": [
                {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ]
            },
            "forbidden_claims": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "north_star_metric": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "posting_cadence": {
              "anyOf": [
                {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ]
            },
            "app_store_url_ios": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "app_store_url_android": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "app_metadata": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "profile_version": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "updated_by": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updated_by_kind": {
              "type": "string",
              "enum": [
                "jwt",
                "api_key",
                "delegated_ai",
                "migration"
              ]
            },
            "updated_by_api_key_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updated_by_delegated_grant_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            "updated_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            }
          },
          "required": [
            "project_id",
            "workspace_id",
            "tagline",
            "description",
            "voice",
            "target_audience",
            "color_palette",
            "goals",
            "no_go_topics",
            "language_primary",
            "positioning",
            "usp",
            "visual_identity",
            "forbidden_claims",
            "north_star_metric",
            "posting_cadence",
            "app_store_url_ios",
            "app_store_url_android",
            "app_metadata",
            "profile_version",
            "updated_by",
            "updated_by_kind",
            "updated_by_api_key_id",
            "updated_by_delegated_grant_id",
            "created_at",
            "updated_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "contract_version",
    "profile"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

דוגמת קריאה לכלי

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

{
  "name": "sosoapi_get_project_profile",
  "arguments": {
    "project_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "contract_version": "project/v1",
  "profile": null
}
התקנה או חיבור של MCP