Datenschutzeinstellungen

Notwendige Funktionen

Für Sicherheit und grundlegende Website-Funktionen erforderlich.

Immer aktiv

Optionale Nutzungsanalyse

PostHog-Nutzungsanalyse erlauben? Du kannst deine Wahl jederzeit in der Fußzeile ändern.

Auch Sitzungsaufzeichnungen auf dieser öffentlichen Website erlauben

Aufzeichnungen zeigen öffentliche Seiten und Interaktionen; Eingaben und private Inhalte werden maskiert. App-Aufzeichnungen sind eine separate Auswahl.

Erfordert Analysen; Website-Aufzeichnungen sind standardmäßig deaktiviert.

Wie wir Daten verwenden

Wenn du Analysen erlaubst, kann PostHog ein anonymes Cookie auf dieser Website und in unserer App gemeinsam verwenden, mit lokalem Browserspeicher auf jeder Website. Mit deiner Einwilligung kann ein verifizierter Besuch im selben Tab nach bestätigter Registrierung mit deinem neuen Konto verknüpft werden.

Aufzeichnungen zeigen öffentliche Seiten und Interaktionen; Eingaben und private Inhalte werden maskiert. App-Aufzeichnungen sind eine separate Auswahl.

Website-Aufzeichnungen sind standardmäßig deaktiviert. Entferne das Häkchen und speichere, um neue Aufzeichnungen zu stoppen; diese Auswahl ändert keine Kontoeinstellungen.

Datenschutzhinweis und separate aggregierte Cloudflare-Messung.

Browser-Analysen aktivieren keine Kontoanalysen.

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

Die Suche lädt erst bei Nutzung. Durchsuche unten alle Kategorien.

MCP-Tool

Erwähnungseingang deines Kontos lesen

sosoapi_listening_mentions_query

Den nativen Erwähnungseingang des Kontos nach Status und Veröffentlichungszeit filtern und lesen; Quelltext ist nicht vertrauenswürdig. Erfordert agent:research.

Als Markdown lesen

Profile und Transporte

Profile: full · Transporte: stdio, http

Wähle core oder full für die sichtbaren Tools deines Clients; dies ändert keine Berechtigungen. Lokaler Dateiupload benötigt stdio und ist über HTTP nicht verfügbar. Setze SOSOAPI_OUTPUT_SCHEMAS=1 für Ausgabeschemas in der Erkennung. Tools liefern unabhängig davon strukturierte Ergebnisse.

Berechtigungen und Nebeneffekte

Annotationen helfen Clients, Tools zu beschreiben. Jeder Aufruf prüft weiterhin Authentifizierung, Rolle, Ressourcenzugriff und erteilte Funktionen des Nutzers.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /listening-api/mentions/query: agent:research · aktuell autorisierte native Erwähnungsprojektion oder Aktualisierungsstatus; unvollständige zwischengespeicherte Seiten sind kein vollständiger Verlauf

Eingabefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Eingabefelder
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
workspace_idstringIm Elternobjekt erforderlich
  • format: "uuid"
social_account_idstringIm Elternobjekt erforderlich
  • format: "uuid"
cursorstringOptional / Element
  • format: "uuid"
limitintegerOptional / Element
  • minimum: 1
  • maximum: 100
handledbooleanOptional / Element—
archivedbooleanOptional / Element—
sincestringOptional / Element
  • 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)))$"
untilstringOptional / Element
  • 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)))$"
Vollständiges JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "social_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "cursor": {
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "handled": {
      "type": "boolean"
    },
    "archived": {
      "type": "boolean"
    },
    "since": {
      "$ref": "#/$defs/s0"
    },
    "until": {
      "$ref": "#/$defs/s0"
    }
  },
  "required": [
    "workspace_id",
    "social_account_id"
  ],
  "additionalProperties": false,
  "$defs": {
    "s0": {
      "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"
    }
  }
}

Strukturierte Ausgabe

Dieses Schema beschreibt structuredContent in einem erfolgreichen Tool-Ergebnis. Die MCP-Antwort enthält auch content und kann bei fehlgeschlagenem Aufruf isError setzen. Lies bei Veröffentlichungen das endgültige Beitragsergebnis, statt eine angenommene Anfrage oder Textantwort als Bestätigung zu werten. Die verknüpfte API-Operation erklärt Berechtigungen und Wiederholungsregeln.

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Strukturierte Ausgabe
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
itemsarrayIm Elternobjekt erforderlich
  • maxItems: 100
items[]objectOptional / Element
  • additionalProperties: false
items[].idstringIm Elternobjekt erforderlich
  • format: "uuid"
items[].workspace_idstringIm Elternobjekt erforderlich
  • format: "uuid"
items[].social_account_idstringIm Elternobjekt erforderlich
  • format: "uuid"
items[].provider_post_idstringIm Elternobjekt erforderlich
  • pattern: "^\\d{2,20}$"
items[].sourcestringIm Elternobjekt erforderlich
  • const: "threads"
items[].relationshipstringIm Elternobjekt erforderlich
  • const: "account_mention"
items[].revisionintegerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
items[].handledbooleanIm Elternobjekt erforderlich—
items[].archivedbooleanIm Elternobjekt erforderlich—
items[].availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","expired","unavailable"]
items[].postobject | nullIm Elternobjekt erforderlich—
items[].postanyOf 1objectIm Elternobjekt erforderlich
  • additionalProperties: false
items[].post.idanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{2,20}$"
items[].post.textanyOf 1string | nullIm Elternobjekt erforderlich—
items[].post.textanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 30000
items[].post.textanyOf 1 / anyOf 2nullIm Elternobjekt erforderlich—
items[].post.usernameanyOf 1string | nullIm Elternobjekt erforderlich—
items[].post.usernameanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^[A-Za-z0-9._]{1,30}$"
items[].post.usernameanyOf 1 / anyOf 2nullIm Elternobjekt erforderlich—
items[].post.permalinkanyOf 1string | nullIm Elternobjekt erforderlich—
items[].post.permalinkanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich
  • format: "uri"
items[].post.permalinkanyOf 1 / anyOf 2nullIm Elternobjekt erforderlich—
items[].post.timestampanyOf 1string | nullIm Elternobjekt erforderlich—
items[].post.timestampanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich
  • 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)))$"
items[].post.timestampanyOf 1 / anyOf 2nullIm Elternobjekt erforderlich—
items[].post.media_typeanyOf 1string | nullIm Elternobjekt erforderlich—
items[].post.media_typeanyOf 1 / anyOf 1stringIm Elternobjekt erforderlich
  • enum: ["TEXT","TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"]
items[].post.media_typeanyOf 1 / anyOf 2nullIm Elternobjekt erforderlich—
items[].post.is_replyanyOf 1boolean | nullIm Elternobjekt erforderlich—
items[].post.is_quote_postanyOf 1boolean | nullIm Elternobjekt erforderlich—
items[].post.has_repliesanyOf 1boolean | nullIm Elternobjekt erforderlich—
items[].post.root_post_idanyOf 1string | nullOptional / Element—
items[].post.root_post_idanyOf 1 / anyOf 1stringOptional / Element
  • pattern: "^\\d{2,20}$"
items[].post.root_post_idanyOf 1 / anyOf 2nullOptional / Element—
items[].post.replied_to_idanyOf 1string | nullOptional / Element—
items[].post.replied_to_idanyOf 1 / anyOf 1stringOptional / Element
  • pattern: "^\\d{2,20}$"
items[].post.replied_to_idanyOf 1 / anyOf 2nullOptional / Element—
items[].postanyOf 2nullIm Elternobjekt erforderlich—
items[].first_observed_atstringIm Elternobjekt erforderlich
  • 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)))$"
items[].last_checked_atstringIm Elternobjekt erforderlich
  • 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)))$"
items[].expires_atstringIm Elternobjekt erforderlich
  • 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)))$"
items[].coveragestringIm Elternobjekt erforderlich
  • const: "partial_native_page"
next_cursorstring | nullIm Elternobjekt erforderlich—
next_cursoranyOf 1stringIm Elternobjekt erforderlich
  • format: "uuid"
next_cursoranyOf 2nullIm Elternobjekt erforderlich—
coveragestringIm Elternobjekt erforderlich
  • const: "partial_native_page"
Vollständiges JSON Schema
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "social_account_id": {
            "type": "string",
            "format": "uuid"
          },
          "provider_post_id": {
            "type": "string",
            "pattern": "^\\d{2,20}$"
          },
          "source": {
            "type": "string",
            "const": "threads"
          },
          "relationship": {
            "type": "string",
            "const": "account_mention"
          },
          "revision": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "handled": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "availability": {
            "type": "string",
            "enum": [
              "available",
              "expired",
              "unavailable"
            ]
          },
          "post": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^\\d{2,20}$"
                  },
                  "text": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 30000
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "username": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9._]{1,30}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "permalink": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "timestamp": {
                    "anyOf": [
                      {
                        "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)))$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "media_type": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "TEXT_POST",
                          "IMAGE",
                          "VIDEO",
                          "CAROUSEL_ALBUM",
                          "AUDIO",
                          "REPOST_FACADE"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "is_reply": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "is_quote_post": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "has_replies": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "root_post_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{2,20}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "replied_to_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{2,20}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "text",
                  "username",
                  "permalink",
                  "timestamp",
                  "media_type",
                  "is_reply",
                  "is_quote_post",
                  "has_replies"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "first_observed_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"
          },
          "last_checked_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"
          },
          "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"
          },
          "coverage": {
            "type": "string",
            "const": "partial_native_page"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "social_account_id",
          "provider_post_id",
          "source",
          "relationship",
          "revision",
          "handled",
          "archived",
          "availability",
          "post",
          "first_observed_at",
          "last_checked_at",
          "expires_at",
          "coverage"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "coverage": {
      "type": "string",
      "const": "partial_native_page"
    }
  },
  "required": [
    "items",
    "next_cursor",
    "coverage"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Beispiel eines Tool-Aufrufs

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

{
  "name": "sosoapi_listening_mentions_query",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "items": [],
  "next_cursor": null,
  "coverage": "partial_native_page"
}
MCP installieren oder verbinden