Referencia de campos MCP

Usa esta referencia para construir una solicitud MCP. Los campos obligatorios están marcados como Obligatorio. Los campos opcionales se pueden omitir a menos que una fuente agregue una condición.

De un vistazoCopy Anchor Link

Qué estás viendoCopy Anchor Link

La herramienta execute ejecuta un programa. sift.call(id, input) recibe directamente la entrada de la operación. Por ejemplo, sift.call("query.analytics.<source>", query) recibe la consulta. No agregues campos de paginación REST a una operación MCP.

Campos principales de herramientasCopy Anchor Link

Operaciones de búsquedaCopy Anchor Link

Las colas, agentes, temas, etiquetas y otras entidades de configuración son operaciones de catálogo. Descúbrelas con sift.spec() en execute. No son valores adicionales de search.source.

Entrada de búsqueda comúnCopy Anchor Link

Estos campos describen la selección de registros común. Las excepciones específicas de cada fuente siguen a continuación.

Campos del árbol de filtrosCopy Anchor Link

Usa sift.spec para la unión completa de hojas. Un campo compatible con actions puede fallar en otra fuente. Los campos, operadores o valores desconocidos no deben ampliar tu consulta silenciosamente.

Campos específicos de actionsCopy Anchor Link

Actions tiene un predeterminado de 50 filas por llamada y devuelve como máximo 500. Una lista de casos se ordena por easyId, createdAt desc o updatedAt desc.

query.search.action_records lista una fila por registro. Acepta los mismos filter, dateRange, time, dateField, idsOnly, includeModerationSummary, cursor y limit. También acepta estos campos y cualquier orden que liste el esquema:

query.search.actions rechaza grain, project e includeBrandAuthored, y el rechazo nombra query.search.action_records.

Campos de contexto y mensajesCopy Anchor Link

Messages ordena por createdAt o id. Reviews ordena por createdAt. Comments ordena por createdAt. Lifecycle events solo admite createdAt desc. Users, comments y lifecycle events no admiten ventanas de franja horaria.

Campos de personasCopy Anchor Link

scope se retiró. Las identidades por plataforma son query.search.user_identities (solo un filtro keyword y paginación). Una página ordenada de IDs de perfil es query.search.user_ids (solo un filtro de personas y paginación). Busca a una persona por nombre, handle o correo con una hoja keyword en filter. Envía los límites de volumen como una hoja volume30d. La ventana de comunidad es windowKind y dateRange del nivel superior. Un rango de fechas solo no convierte un snapshot de People en una población de usuarios activos.

Campos de ListeningCopy Anchor Link

Listening requiere autenticación personal y la funcionalidad de Listening de la organización. Su from de scope es inclusivo y to es exclusivo. El análisis clasificado puede detenerse en un límite acotado. Lee los metadatos de ventana y scope devueltos. No reportes un conjunto acotado como todos los posts coincidentes.

Fechas, zona horaria y ordenamientoCopy Anchor Link

Usa una ventana absoluta o relativa. Las ventanas de consulta resueltas usan un límite UTC to exclusivo. Los límites de solo fecha representan días de calendario en la zona horaria seleccionada. Lee los límites resueltos en los metadatos del resultado. El endpoint REST de lista de actions tiene reglas de fecha diferentes; consulta su referencia.

Campos de entrada de analíticaCopy Anchor Link

Pasa esta consulta directamente a sift.call("query.analytics.<source>", query).

Campos de línea medidaCopy Anchor Link

Cada objeto de agrupación tiene field obligatorio y customFieldKey opcional. La compatibilidad de métricas y dimensiones depende de la fuente. Lee la guía de analítica y el contrato exacto de la operación antes de adivinar IDs.

Opciones de analíticaCopy Anchor Link

Encontrar campos y valoresCopy Anchor Link

Lee los campos y las métricas de una fuente de datos con sift.spec("query.analytics.<source>"). Devuelve la declaración TypeScript de la consulta, con una línea de comentario por campo de filtro: su nombre, sus operadores y la fuente de lista que tiene sus valores.

Lista los valores de un campo con esa fuente de lista: sift.call("query.search.<list>", input). Las listas son tags, tag_groups, channels, queues, teammates, servers, goals, saved_searches, themes, statuses, platforms, competitors, discord_roles, qa_forms, user_groups, gainsight_values, custom_fields y custom_field_options. Las personas vienen de query.search.users: busque a una persona con una hoja keyword, { filter: { filterType: "keyword", operator: "contains", value: ["<palabras>"] } }.

Cada fila tiene id y name. Pon id en una hoja de filtro; un nombre se rechaza. La etiqueta de un campo personalizado es su nombre de campo: lista los campos con query.search.custom_fields { source } y las opciones de un campo con query.search.custom_field_options { field }.

Campos de búsqueda de creadoresCopy Anchor Link

Usa la búsqueda externa de creadores solo cuando el usuario lo solicite. Llama a social.profile.get con sift.call. No es una búsqueda almacenada de Sift.

expandedIdentity.provider es linktree, linkme, komi, pillar, linkbio o beacons. Sus campos obligatorios son provider, sourceUrl, verticals (array de strings) y destinations (array). Los strings opcionales son username, displayName, bio, avatarUrl y email. Cada destino tiene platform y url string obligatorios, y title string opcional. Los datos faltantes permanecen faltantes.

Campos de herramientas de app y respuestaCopy Anchor Link

Usa estas herramientas solo cuando el servidor conectado las anuncie. Las vistas de app requieren OAuth personal. La app integrada sigue siendo un prototipo de desarrollo; el texto y los enlaces nativos pueden funcionar sin una vista integrada.

expectedUpdatedAt vincula la evidencia a la revisión guardada del dashboard. expectedRevision vincula un borrador al contexto de respuesta actual. Usa los valores devueltos por la lectura anterior. clientMutationId es una clave de reintento. Reutilízala solo para el mismo borrador. serverId selecciona la cuenta de envío. isPublicReply selecciona el modo público o privado. requestId vincula una respuesta inmutable; un borrador modificado requiere un nuevo UUID.

Campos de EventsCopy Anchor Link

Events requiere un cliente moderno, una capacidad de Events anunciada y OAuth personal. Usa events/list para descubrir el evento action.message_received compatible y su esquema de payload. Cubre mensajes futuros entrantes de Instagram y Messenger en una action. Excluye el backfill y las respuestas de la marca.

El callback debe usar HTTPS y pasar la verificación. El secret usa whsec_ con 24–64 bytes de clave codificados en base64. Guárdalo en un almacén de secrets. La suscripción tiene una vida útil finita; conserva su expiración devuelta.

Los campos del payload son eventId (UUID), name, timestamp (fecha-hora ISO), data.actionId, data.recordId, data.url y cursor (null). Verifica los encabezados de webhook firmados antes de procesar. Lee la action para obtener evidencia actual; un evento no es permiso para enviar.

Campos de resultado y descubrimiento de esquemaCopy Anchor Link

Dentro de execute, sift.call devuelve el resultado de la operación. Si la operación falla, lanza un Error cuyo mensaje indica el code, el message y los campos con error. Un resultado que requiere aprobación no contiene una escritura completada.

// La declaración TypeScript de la operación: sus tipos de entrada y de salida.
return await sift.spec("query.analytics.actions")

sift.spec(id) devuelve una operación como declaración TypeScript: declare function call(id, input: XInput): Promise<XOutput>, con la descripción de cada campo como comentario. La entrada y la salida son tipos con nombre en el mismo texto. Un tipo que se repite, como el árbol de filtros, se escribe una vez y se usa por su nombre. La declaración se genera del mismo esquema con el que valida el servidor, así que sigue al día cuando el servidor cambia. Los clientes HTTP leen el mismo contrato como JSON Schema en OpenAPI.

sift.spec() sin id devuelve el índice del catálogo: id, productFamily, aliases opcional, summary, description, domain, effect, access, ui, url, discovery, examples opcional, inputSchema y outputSchema. Fíltralo en código y devuelve solo lo que necesitas.

Salida de búsquedaCopy Anchor Link

Lee items y nextCursor. Un cursor null termina la lista. La búsqueda no devuelve un total. Los metadatos de fuente varían; inspecciona el esquema de salida. Una primera página vacía incluye emptyReason. Las filas de action pueden incluir id, actionId, threadId, userId, username, author, engagement, platform, operationStatus, channelId, channel, summary, description, matchedText, easyId, easyIdNumber, link y url.

Usa actionId para un caso, link para su página en Sift y url para evidencia pública de la fuente. Los campos pueden ser null o estar ausentes. Las proyecciones agregan columnas específicas de la fuente; no asumas que todas las filas contienen todos los campos.

Salida de analíticaCopy Anchor Link

Lee los valores por meta.lines[].key, no por un nombre de columna adivinado. Las herramientas de app devuelven su vista en structuredContent. Conserva la URL nativa y los campos de vista versionados. Usa el esquema de salida conectado para una proyección completa de la app; no trates un resultado de app como un envelope de búsqueda.

ConsejosCopy Anchor Link

• Lee los esquemas antes de nuevas operaciones. No inferas campos a partir de nombres de herramientas.
• Usa IDs reales devueltos. Las etiquetas y nombres de usuario no reemplazan todos los campos de ID.
• Conserva el scope de paginación y los enlaces de evidencia devueltos.
• Mantén las credenciales fuera de code y otros argumentos de herramientas.

Consulta el Diccionario de campos de registros para entender pmid, prid, otras claves cortas y los campos anidados de los resultados.

RelacionadoCopy Anchor Link