Skip to main content
Glama

ig_top_posts

Read-only

[DEMO SINTÉTICA] Posts de Instagram con mejor performance, ordenados por engagement, alcance, likes, guardados o comentarios. Incluye caption, fecha, métricas y permalink. Usar para "mejores posts", "qué contenido funcionó", "posts más vistos".

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sortNoOrdenar por: engagement (default), reach, likes, saved, comments
limitNoCantidad de posts a retornar (default: 10, max: 50)
date_rangeNoPeríodo a consultar. Ejemplos: "últimos 30 días", "enero 2025", "2025-01-01 a 2025-01-31", "este mes", "mes pasado". Por defecto: últimos 30 días.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYesHasta 50 posts, ordenados según sort. Lista vacía si no hay posts con alcance positivo.
demoNoSolo aparece en demo; todos sus datos son ficticios.
noticeNoAviso obligatorio de datos sintéticos cuando demo es true.
sample_periodNoPeríodo fijo de los ejemplos sintéticos; no cambia al solicitar otro rango.
requested_periodNoRango solicitado a la demo; no es el período real de sus ejemplos.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "description": "Estadísticas de la cuenta autenticada en data. Si demo es true, son ejemplos sintéticos; sample_period es su período y requested_period solo el rango solicitado.",
      +  "properties": {
      +    "data": {
      +      "description": "Hasta 50 posts, ordenados según sort. Lista vacía si no hay posts con alcance positivo.",
      +      "items": {
      +        "additionalProperties": false,
      +        "description": "Publicación con sus métricas.",
      +        "properties": {
      +          "caption": {
      +            "description": "Texto de la publicación; null si no existe.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "comments_count": {
      +            "description": "Comentarios del post. null indica ausencia del valor en la fuente.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "engagementRate": {
      +            "description": "Interacciones del post divididas por su alcance. Porcentaje: 5 significa 5%, no 0,05.",
      +            "type": "number"
      +          },
      +          "ig_media_id": {
      +            "description": "ID del post en Instagram.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "like_count": {
      +            "description": "Likes del post. null indica ausencia del valor en la fuente.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "media_type": {
      +            "description": "Tipo de publicación informado por Instagram.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "permalink": {
      +            "description": "Enlace a la publicación.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "reach": {
      +            "description": "Alcance del post; solo se incluyen posts con alcance positivo.",
      +            "type": "number"
      +          },
      +          "saved": {
      +            "description": "Guardados del post.",
      +            "type": "number"
      +          },
      +          "shares": {
      +            "description": "Compartidos del post.",
      +            "type": "number"
      +          },
      +          "timestamp": {
      +            "description": "Fecha y hora de publicación según la fuente.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "ig_media_id",
      +          "media_type",
      +          "caption",
      +          "timestamp",
      +          "permalink",
      +          "like_count",
      +          "comments_count",
      +          "reach",
      +          "saved",
      +          "shares",
      +          "engagementRate"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "demo": {
      +      "const": true,
      +      "description": "Solo aparece en demo; todos sus datos son ficticios.",
      +      "type": "boolean"
      +    },
      +    "notice": {
      +      "description": "Aviso obligatorio de datos sintéticos cuando demo es true.",
      +      "type": "string"
      +    },
      +    "requested_period": {
      +      "additionalProperties": false,
      +      "description": "Rango solicitado a la demo; no es el período real de sus ejemplos.",
      +      "properties": {
      +        "from": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "from",
      +        "to"
      +      ],
      +      "type": "object"
      +    },
      +    "sample_period": {
      +      "additionalProperties": false,
      +      "description": "Período fijo de los ejemplos sintéticos; no cambia al solicitar otro rango.",
      +      "properties": {
      +        "from": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "from",
      +        "to"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "data"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.