Pangolinfo VOC Insight MCP

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

Pangolinfo VOC Insight MCP

Voice of Customer e Social Listening para Agentes de IA.

Conecte um cliente MCP stdio local ao Pangolinfo VOC Insight MCP. Esta pequena ponte encaminha a descoberta de ferramentas e chamadas para o serviço hospedado existente; ela não implementa seu próprio raspador ou modelo de sentimento.

Introdução em chinês · Documentação de conexão · Referência de ferramentas · Preços de uso

O que ela conecta

O serviço hospedado oferece suporte a pesquisa de feedback de marca, tendências de sentimento, participação de voz dos concorrentes e exploração de postagens de origem. Comece com um relatório de marca existente, encontre as conversas por trás de um resultado e use essas fontes para orientar pesquisas adicionais. Nomes de ferramentas e esquemas de argumentos são descobertos em tempo de execução, em vez de serem codificados em um catálogo de tamanho fixo.

As fontes padrão documentadas pela Pangolinfo incluem TikTok, Instagram, YouTube, X, Facebook, Pinterest e Trustpilot. Threads e Reddit estão disponíveis mediante solicitação. Avaliações da Amazon exigem integração completa da marca com um ASIN ou URL de produto; elas não fazem parte do escopo padrão de coleta social. Plataformas sociais da China continental não são suportadas.

Instalação e execução

Requer Node.js 22+ e uma chave de API Pangolinfo com acesso a VOC.

Baixe este repositório, entre em seu diretório e execute:

npm install
node bridge.js --help

Defina PANGOLINFO_API_KEY por meio do seu ambiente local ou gerenciador de segredos e, em seguida, execute node bridge.js. Mantenha as chaves fora do controle de versão. A ponte usa o endpoint documentado https://voc.pangolinfo.com/mcp com um cabeçalho Bearer.

Para um cliente que inicia servidores stdio locais, substitua o caminho de exemplo e a chave em sua configuração 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 já suportam Streamable HTTP remoto, nenhuma ponte é necessária:

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

Exemplo de fluxo de trabalho de pesquisa

1. Peça ao seu agente para listar as ferramentas VOC disponíveis e inspecionar os esquemas relevantes.
2. Encontre uma marca existente e leia seu sentimento atual e postagens de origem.
3. Compare o feedback entre plataformas e vincule as conclusões às evidências subjacentes.
4. Antes de criar um espaço, atualizar a coleta ou gerar análise, revise a estimativa de custo do serviço hospedado e autorize explicitamente a operação em seu cliente.

Exemplo de prompt: "Use meu relatório de marca existente para identificar preocupações recorrentes de compra. Mostre postagens de origem de apoio e separe observações de interpretação. Pergunte antes de iniciar qualquer nova coleta ou análise paga."

node discover-tools.js demonstra descoberta programática usando o SDK MCP. Ele lista apenas esquemas e não chama ferramentas de negócios. Este é um exemplo de MCP, não um SDK de API REST autônomo.

Comportamento e limites

• Encaminha paginação tools/list e argumentos tools/call, resultados estruturados e erros de ferramenta.
• Suporta apenas operações de ferramentas; não faz proxy de recursos, prompts, assinaturas ou OAuth.
• Não tenta novamente automaticamente chamadas de ferramentas com falha, porque uma coleta ou análise com tempo esgotado pode já ter sido aceita e cobrada.
• O catálogo hospedado inclui operações de escrita e pagas. Esta ponte não é um limite de acesso somente leitura e não adiciona uma caixa de diálogo de aprovação; use aprovações no lado do cliente.
• Disponibilidade de fontes, permissões de conta e preços são controlados pelo serviço hospedado. O código da ponte local ser gratuito não torna a coleta ou análise remota gratuita.
• Entrevistas de persona, quando usadas, são análises simuladas, não depoimentos reais de clientes.

Validação

npm test

Os testes usam transportes MCP em memória para verificar encaminhamento de protocolo, paginação, tratamento de erros e ausência de novas tentativas automáticas. Eles não entram em contato com produção, gastam créditos ou estabelecem compatibilidade com todos os clientes de IA. Chamadas VOC autenticadas ao vivo não foram verificadas para esta versão.

Licença

MIT se aplica apenas ao código neste repositório. O serviço hospedado da Pangolinfo, acesso a dados e cobrança permanecem sujeitos aos seus termos de serviço.