Pangolinfo VOC Insight MCP

npx add-mcp 'https://voc.pangolinfo.com/mcp'

Pangolinfo VOC Insight MCP

Voice of Customer y Social Listening para Agentes de IA.

Conecta un cliente MCP local stdio a Pangolinfo VOC Insight MCP. Este pequeño puente reenvía el descubrimiento de herramientas y las llamadas al servicio alojado existente; no implementa su propio rastreador ni modelo de sentimiento.

中文产品介绍 · Documentación de conexión · Referencia de herramientas · Precios de uso

Qué conecta

El servicio alojado admite investigación de comentarios de marca, tendencias de sentimiento, cuota de voz de la competencia y exploración de publicaciones fuente. Comienza con un informe de marca existente, encuentra las conversaciones detrás de un resultado y luego usa esas fuentes para guiar investigaciones adicionales. Los nombres de las herramientas y los esquemas de argumentos se descubren en tiempo de ejecución, en lugar de estar codificados a un tamaño de catálogo fijo.

Las fuentes predeterminadas documentadas por Pangolinfo incluyen TikTok, Instagram, YouTube, X, Facebook, Pinterest y Trustpilot. Threads y Reddit están disponibles bajo solicitud. Las reseñas de Amazon requieren una incorporación completa de la marca con un ASIN o URL de producto; no forman parte del alcance predeterminado de recopilación social. Las plataformas sociales de China continental no son compatibles.

Instalación y ejecución

Requiere Node.js 22+ y una clave API de Pangolinfo con acceso a VOC.

Descarga este repositorio, entra en su directorio y ejecuta:

npm install
node bridge.js --help

Configura PANGOLINFO_API_KEY a través de tu entorno local o gestor de secretos, luego ejecuta node bridge.js. Mantén las claves fuera del control de versiones. El puente utiliza el endpoint documentado https://voc.pangolinfo.com/mcp con un encabezado Bearer.

Para un cliente que lanza servidores stdio locales, reemplaza la ruta de ejemplo y la clave en su configuración privada:

{
  "mcpServers": {
    "pangolinfo-voc": {
      "command": "node",
      "args": ["/absolute/path/to/voc-insight-mcp/bridge.js"],
      "env": { "PANGOLINFO_API_KEY": "YOUR_PRIVATE_API_KEY" }
    }
  }
}

Para clientes que ya admiten Streamable HTTP remoto, no se requiere puente:

{
  "mcpServers": {
    "pangolinfo-voc": {
      "url": "https://voc.pangolinfo.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_PRIVATE_API_KEY" }
    }
  }
}

Ejemplo de flujo de trabajo de investigación

1. Pide a tu agente que liste las herramientas VOC disponibles e inspeccione los esquemas relevantes.
2. Encuentra una marca existente y lee su sentimiento actual y publicaciones fuente.
3. Compara comentarios entre plataformas y vincula las conclusiones a la evidencia subyacente.
4. Antes de crear un espacio, actualizar la recopilación o generar análisis, revisa la estimación de costos del servicio alojado y autoriza explícitamente la operación en tu cliente.

Ejemplo de prompt: "Usa mi informe de marca existente para identificar preocupaciones de compra recurrentes. Muestra publicaciones fuente de respaldo y separa las observaciones de la interpretación. Pregunta antes de iniciar cualquier nueva recopilación o análisis de pago."

node discover-tools.js demuestra el descubrimiento programático usando el SDK de MCP. Solo lista esquemas y no llama a herramientas de negocio. Este es un ejemplo de MCP, no un SDK de API REST independiente.

Comportamiento y límites

• Reenvía la paginación de tools/list y los argumentos de tools/call, resultados estructurados y errores de herramientas.
• Solo admite operaciones de herramientas; no actúa como proxy de recursos, prompts, suscripciones u OAuth.
• No reintenta automáticamente llamadas de herramientas fallidas, porque una recopilación o análisis con tiempo de espera agotado puede ya haber sido aceptado y cobrado.
• El catálogo alojado incluye operaciones de escritura y de pago. Este puente no es un límite de acceso de solo lectura y no añade un diálogo de aprobación; usa aprobaciones del lado del cliente.
• La disponibilidad de fuentes, permisos de cuenta y precios están controlados por el servicio alojado. Que el código del puente local sea gratuito no hace que la recopilación o el análisis remoto sean gratuitos.
• Las entrevistas de personas, cuando se usan, son análisis simulados, no testimonios reales de clientes.

Validación

npm test

Las pruebas usan transportes MCP en memoria para verificar el reenvío de protocolo, la paginación, el manejo de errores y la ausencia de reintentos automáticos. No contactan producción, gastan créditos ni establecen compatibilidad con cada cliente de IA. Las llamadas VOC autenticadas en vivo no se han verificado para esta versión.

Licencia

MIT se aplica solo al código de este repositorio. El servicio alojado de Pangolinfo, el acceso a datos y la facturación siguen sujetos a sus términos de servicio.