Herramienta MCP

Leer un resumen del corpus de investigación seleccionado

sosoapi_research_projects_overview

Leer recuentos deterministas de un corpus sellado exacto; los elementos seleccionados no son el tamaño de una audiencia ni de un mercado. Requiere agent:research.

Leer en Markdown

Perfiles y transportes

Perfiles: full · Transportes: stdio, http

Elige core o full para controlar qué herramientas ve tu cliente; no cambia sus permisos. La carga de archivos locales requiere stdio y no está disponible por HTTP. Establece SOSOAPI_OUTPUT_SCHEMAS=1 para incluir esquemas de salida en la detección. Las herramientas devuelven resultados estructurados con o sin esa opción.

Permisos y efectos secundarios

Las anotaciones ayudan a los clientes a describir una herramienta. Cada llamada sigue comprobando la autenticación, el rol, el acceso al recurso y los permisos de capacidades del usuario.

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

/research-api/projects/overview: agent:research · datos exactos de recurso Research autorizados actualmente

Campos de entrada

Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.

Campos de entrada
Campo / rama	Tipo / obligatorio	Restricciones
`$`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`workspace_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`project_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`project_revision`	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`corpus_snapshot_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`

JSON Schema completo

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "project_id": {
      "type": "string",
      "format": "uuid"
    },
    "project_revision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "corpus_snapshot_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "workspace_id",
    "project_id",
    "project_revision",
    "corpus_snapshot_id"
  ],
  "additionalProperties": false
}

Salida estructurada

Este esquema describe structuredContent en un resultado exitoso de herramienta. La respuesta MCP también incluye content y puede establecer isError si falla una llamada. Para publicación, consulta el resultado final de la publicación en vez de considerar una solicitud aceptada o una respuesta de texto como confirmación. La operación API enlazada explica los permisos y las reglas de reintento.

Salida estructurada
Campo / rama	Tipo / obligatorio	Restricciones
`$`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`project_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`project_revision`	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`corpus_snapshot_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`method_version`	`string`Obligatorio en el objeto principal	`const: "literal-mentions/v1"`
`coverage`	`string`Obligatorio en el objeto principal	`enum: ["supplied_set","bounded_sample","partial"]`
`evidence_count`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`unique_items`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`brand_union_count`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`overlap_count`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`brands`	`array`Obligatorio en el objeto principal	`maxItems: 20`
`brands[]`	`object`Opcional / elemento	`additionalProperties: false`
`brands[].id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`brands[].name`	`string`Obligatorio en el objeto principal	`minLength: 1` `maxLength: 100`
`brands[].matched_items`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`brands[].observed_mention_share`	`number \| null`Obligatorio en el objeto principal	—
`brands[].observed_mention_share`anyOf 1	`number`Obligatorio en el objeto principal	`minimum: 0` `maximum: 1`
`brands[].observed_mention_share`anyOf 2	`null`Obligatorio en el objeto principal	—
`brands[].evidence`	`array`Obligatorio en el objeto principal	`maxItems: 500`
`brands[].evidence[]`	`object`Opcional / elemento	`additionalProperties: false`
`brands[].evidence[].evidence_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`brands[].evidence[].revision`	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`languages`	`array`Obligatorio en el objeto principal	`maxItems: 501`
`languages[]`	`object`Opcional / elemento	`additionalProperties: false`
`languages[].language`	`string \| null`Obligatorio en el objeto principal	—
`languages[].language`anyOf 1	`string`Obligatorio en el objeto principal	`minLength: 1` `maxLength: 35`
`languages[].language`anyOf 2	`null`Obligatorio en el objeto principal	—
`languages[].item_count`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`platforms`	`array`Obligatorio en el objeto principal	`maxItems: 8`
`platforms[]`	`object`Opcional / elemento	`additionalProperties: false`
`platforms[].platform`	`string \| null`Obligatorio en el objeto principal	—
`platforms[].platform`anyOf 1	`string`Obligatorio en el objeto principal	`enum: ["threads","instagram","facebook","youtube","x","reddit","web"]`
`platforms[].platform`anyOf 2	`null`Obligatorio en el objeto principal	—
`platforms[].item_count`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`sources`	`array`Obligatorio en el objeto principal	`maxItems: 3`
`sources[]`	`object`Opcional / elemento	`additionalProperties: false`
`sources[].category`	`string`Obligatorio en el objeto principal	`enum: ["your_accounts","public_posts","team_notes"]`
`sources[].item_count`	`integer`Obligatorio en el objeto principal	`minimum: 0` `maximum: 9007199254740991`
`history`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`history.eligible`	`boolean`Obligatorio en el objeto principal	`const: false`
`history.reason`	`string`Obligatorio en el objeto principal	`const: "insufficient_comparable_history"`

JSON Schema completo

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid"
    },
    "project_revision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "corpus_snapshot_id": {
      "type": "string",
      "format": "uuid"
    },
    "method_version": {
      "type": "string",
      "const": "literal-mentions/v1"
    },
    "coverage": {
      "type": "string",
      "enum": [
        "supplied_set",
        "bounded_sample",
        "partial"
      ]
    },
    "evidence_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "unique_items": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "brand_union_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "overlap_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "brands": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "matched_items": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "observed_mention_share": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence": {
            "maxItems": 500,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "evidence_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "revision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "evidence_id",
                "revision"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "id",
          "name",
          "matched_items",
          "observed_mention_share",
          "evidence"
        ],
        "additionalProperties": false
      }
    },
    "languages": {
      "maxItems": 501,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "language": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 35
              },
              {
                "type": "null"
              }
            ]
          },
          "item_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "language",
          "item_count"
        ],
        "additionalProperties": false
      }
    },
    "platforms": {
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "threads",
                  "instagram",
                  "facebook",
                  "youtube",
                  "x",
                  "reddit",
                  "web"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "item_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "platform",
          "item_count"
        ],
        "additionalProperties": false
      }
    },
    "sources": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "enum": [
              "your_accounts",
              "public_posts",
              "team_notes"
            ]
          },
          "item_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "category",
          "item_count"
        ],
        "additionalProperties": false
      }
    },
    "history": {
      "type": "object",
      "properties": {
        "eligible": {
          "type": "boolean",
          "const": false
        },
        "reason": {
          "type": "string",
          "const": "insufficient_comparable_history"
        }
      },
      "required": [
        "eligible",
        "reason"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "project_id",
    "project_revision",
    "corpus_snapshot_id",
    "method_version",
    "coverage",
    "evidence_count",
    "unique_items",
    "brand_union_count",
    "overlap_count",
    "brands",
    "languages",
    "platforms",
    "sources",
    "history"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Ejemplo de llamada a herramienta

Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes API.

{
  "name": "sosoapi_research_projects_overview",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "project_id": "11111111-1111-4111-8111-111111111111",
    "project_revision": 1,
    "corpus_snapshot_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "project_id": "11111111-1111-4111-8111-111111111111",
  "project_revision": 1,
  "corpus_snapshot_id": "11111111-1111-4111-8111-111111111111",
  "method_version": "literal-mentions/v1",
  "coverage": "supplied_set",
  "evidence_count": 0,
  "unique_items": 0,
  "brand_union_count": 0,
  "overlap_count": 0,
  "brands": [],
  "languages": [],
  "platforms": [],
  "sources": [],
  "history": {
    "eligible": false,
    "reason": "insufficient_comparable_history"
  }
}

/research-api/projects/overview

Instala o conecta MCP

Preferencias de privacidad

Funciones necesarias

Analítica opcional de uso

Permitir también la grabación de sesiones en este sitio web público

Leer un resumen del corpus de investigación seleccionado

Perfiles y transportes

Permisos y efectos secundarios

Campos de entrada

Salida estructurada

Ejemplo de llamada a herramienta

structuredContent

Leer un resumen del corpus de investigación seleccionado

Perfiles y transportes

Permisos y efectos secundarios

Campos de entrada

Salida estructurada

Ejemplo de llamada a herramienta

structuredContent

Operaciones API subyacentes