העדפות פרטיות

תכונות חיוניות

נדרשות לאבטחה ולפעולות הבסיסיות של האתר.

פעילות תמיד

אבחון Landing והקלטת הפעלות עם הסתרת תוכן

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

ניתוח שימוש אופציונלי

לאפשר ניתוח שימוש באמצעות PostHog? אפשר לשנות את הבחירה בכל עת בתחתית האתר.

לאפשר גם הקלטת הפעלות באתר הציבורי הזה

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

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

ניתוח השימוש בדפדפן אינו מפעיל ניתוח שימוש בחשבון.

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

כלי MCP

קריאת פוסטים וכיתובים למחקר מחשבון מחובר

sosoapi_research_evidence_retrieve-native

קריאת פוסטים וכיתובים למחקר מחשבון מחובר. מכסה פוסטים וכיתובים נבחרים מחשבון מחובר, שעשויים להיות לא ציבוריים, בעמוד מקורי מוגבל אחד ולא בהיסטוריה המלאה. האחזור לעולם אינו מפעיל את Google Gemini או קורא הודעות פרטיות. יצירה באמצעות מודל עם ההקשר שנבחר היא פעולה קיימת נפרדת הדורשת הסכמה משלה. נדרשות הסכמה מפורשת ל-Research ול-Listening וגישה נוכחית ל-Workspace. טקסט המקור המוחזר אינו מהימן. הרשאות המקור הנוכחיות, תקופת השמירה ותקציבי התחום עדיין חלים. נתיב זה לעולם אינו מפרסם תוכן.

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

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

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

# This operation requires a CLI build containing the updated Research contract.
# Use HTTP or hosted MCP if your CLI build does not include it.
# 此操作需要包含更新版 Research contract 的 CLI build。
# 如 CLI build 未包含此 contract,請使用 HTTP 或 hosted MCP。

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

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

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

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /research-api/evidence/retrieve-native: agent:research · קבלה שנשמרה לעמוד מקורי מוגבל וראיות עדכניות מחשבון מחובר; עמוד יחיד אינו ההיסטוריה המלאה

שדות קלט

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

שדות קלט
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
workspace_idstringחובה באובייקט האב
  • format: "uuid"
mutation_idstringחובה באובייקט האב
  • format: "uuid"
social_account_idstringחובה באובייקט האב
  • format: "uuid"
limitintegerרשות / פריט
  • minimum: 1
  • maximum: 20
authorization_expires_atstringרשות / פריט
  • 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)))$"
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    },
    "social_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "authorization_expires_at": {
      "type": "string",
      "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)))$",
      "format": "date-time"
    }
  },
  "required": [
    "workspace_id",
    "mutation_id",
    "social_account_id"
  ],
  "additionalProperties": false
}

פלט מובנה

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

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

פלט מובנה
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
retrievalobject | nullחובה באובייקט האב—
retrievalanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
retrieval.idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
retrieval.workspace_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
retrieval.mutation_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
retrieval.social_account_idanyOf 1string | nullחובה באובייקט האב—
retrieval.social_account_idanyOf 1 / anyOf 1stringחובה באובייקט האב
  • format: "uuid"
retrieval.social_account_idanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.platformanyOf 1stringחובה באובייקט האב
  • enum: ["facebook","instagram","threads"]
retrieval.stateanyOf 1stringחובה באובייקט האב
  • enum: ["pending","running","completed","unavailable","unconfirmed","cancelled","expired"]
retrieval.reasonanyOf 1string | nullחובה באובייקט האב—
retrieval.reasonanyOf 1 / anyOf 1stringחובה באובייקט האב
  • enum: ["connection_unavailable","connection_changed","provider_denied","provider_rate_limited","provider_unavailable","provider_response_invalid","empty_page","metadata_only","content_expired","deadline_exceeded","cancelled"]
retrieval.reasonanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.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)))$"
retrieval.settled_atanyOf 1string | nullחובה באובייקט האב—
retrieval.settled_atanyOf 1 / anyOf 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)))$"
retrieval.settled_atanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.valid_untilanyOf 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)))$"
retrieval.coverageanyOf 1stringחובה באובייקט האב
  • const: "bounded_native_page"
retrieval.completeanyOf 1booleanחובה באובייקט האב
  • const: false
retrieval.provider_getsanyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 1
retrieval.evidenceanyOf 1arrayחובה באובייקט האב
  • maxItems: 20
retrieval.evidence[]anyOf 1objectרשות / פריט
  • additionalProperties: false
retrieval.evidence[].idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
retrieval.evidence[].workspace_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
retrieval.evidence[].revisionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
retrieval.evidence[].titleanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].titleanyOf 1 / anyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 200
retrieval.evidence[].titleanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].textanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].textanyOf 1 / anyOf 1stringחובה באובייקט האב
  • maxLength: 30000
retrieval.evidence[].textanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].source_categoryanyOf 1stringחובה באובייקט האב
  • enum: ["your_accounts","public_posts","team_notes"]
retrieval.evidence[].platformanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].platformanyOf 1 / anyOf 1stringחובה באובייקט האב
  • enum: ["threads","instagram","facebook","youtube","x","reddit","web"]
retrieval.evidence[].platformanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].source_urlanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].source_urlanyOf 1 / anyOf 1stringחובה באובייקט האב
  • format: "uri"
  • maxLength: 2048
retrieval.evidence[].source_urlanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].authoranyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].authoranyOf 1 / anyOf 1stringחובה באובייקט האב
  • maxLength: 200
retrieval.evidence[].authoranyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].languageanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].languageanyOf 1 / anyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 35
retrieval.evidence[].languageanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].published_atanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].published_atanyOf 1 / anyOf 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)))$"
retrieval.evidence[].published_atanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].retrieved_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)))$"
retrieval.evidence[].valid_untilanyOf 1string | nullחובה באובייקט האב—
retrieval.evidence[].valid_untilanyOf 1 / anyOf 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)))$"
retrieval.evidence[].valid_untilanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].availabilityanyOf 1stringחובה באובייקט האב
  • enum: ["available","removed","unavailable"]
retrieval.evidence[].metricsanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
retrieval.evidence[].metrics.likesanyOf 1integer | nullחובה באובייקט האב—
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 9007199254740991
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].metrics.repliesanyOf 1integer | nullחובה באובייקט האב—
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 9007199254740991
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].metrics.repostsanyOf 1integer | nullחובה באובייקט האב—
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 9007199254740991
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrieval.evidence[].metrics.viewsanyOf 1integer | nullחובה באובייקט האב—
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 9007199254740991
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 2nullחובה באובייקט האב—
retrievalanyOf 2nullחובה באובייקט האב—
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "retrieval": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid"
            },
            "mutation_id": {
              "type": "string",
              "format": "uuid"
            },
            "social_account_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "platform": {
              "type": "string",
              "enum": [
                "facebook",
                "instagram",
                "threads"
              ]
            },
            "state": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "completed",
                "unavailable",
                "unconfirmed",
                "cancelled",
                "expired"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "connection_unavailable",
                    "connection_changed",
                    "provider_denied",
                    "provider_rate_limited",
                    "provider_unavailable",
                    "provider_response_invalid",
                    "empty_page",
                    "metadata_only",
                    "content_expired",
                    "deadline_exceeded",
                    "cancelled"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "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)))$",
              "format": "date-time"
            },
            "settled_at": {
              "anyOf": [
                {
                  "type": "string",
                  "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)))$",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ]
            },
            "valid_until": {
              "type": "string",
              "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)))$",
              "format": "date-time"
            },
            "coverage": {
              "type": "string",
              "const": "bounded_native_page"
            },
            "complete": {
              "type": "boolean",
              "const": false
            },
            "provider_gets": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1
            },
            "evidence": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "workspace_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "revision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "title": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "text": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 30000
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "source_category": {
                    "type": "string",
                    "enum": [
                      "your_accounts",
                      "public_posts",
                      "team_notes"
                    ]
                  },
                  "platform": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "threads",
                          "instagram",
                          "facebook",
                          "youtube",
                          "x",
                          "reddit",
                          "web"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "source_url": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 2048,
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "author": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "language": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 35
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "published_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "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)))$",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "retrieved_at": {
                    "type": "string",
                    "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)))$",
                    "format": "date-time"
                  },
                  "valid_until": {
                    "anyOf": [
                      {
                        "type": "string",
                        "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)))$",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "removed",
                      "unavailable"
                    ]
                  },
                  "metrics": {
                    "type": "object",
                    "properties": {
                      "likes": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "replies": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "reposts": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "views": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "likes",
                      "replies",
                      "reposts",
                      "views"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "id",
                  "workspace_id",
                  "revision",
                  "title",
                  "text",
                  "source_category",
                  "platform",
                  "source_url",
                  "author",
                  "language",
                  "published_at",
                  "retrieved_at",
                  "valid_until",
                  "availability",
                  "metrics"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "id",
            "workspace_id",
            "mutation_id",
            "social_account_id",
            "platform",
            "state",
            "reason",
            "created_at",
            "settled_at",
            "valid_until",
            "coverage",
            "complete",
            "provider_gets",
            "evidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "retrieval"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

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

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

{
  "name": "sosoapi_research_evidence_retrieve-native",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000006",
    "social_account_id": "22222222-2222-4222-8222-222222222222",
    "limit": 10
  }
}

structuredContent

{
  "retrieval": {
    "id": "30000000-0000-4000-8000-000000000007",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000006",
    "social_account_id": "22222222-2222-4222-8222-222222222222",
    "platform": "instagram",
    "state": "unavailable",
    "reason": "connection_unavailable",
    "created_at": "2099-01-15T09:00:00Z",
    "settled_at": "2099-01-15T09:00:01Z",
    "valid_until": "2099-01-16T09:00:00Z",
    "coverage": "bounded_native_page",
    "complete": false,
    "provider_gets": 0,
    "evidence": []
  }
}
התקנה או חיבור של MCP