Social Listening Brief: conversas públicas com amostra e contexto

ANÁLISE EDITORIAL

Social Listening Brief é uma Skill para transformar conversas públicas sobre marca, produto, categoria e concorrentes em um briefing com contexto, limites de amostra e próximos passos. Em vez de reduzir milhares de comentários a um rótulo de sentimento, ela pede que o agente preserve links, separe sinais repetidos de casos isolados e mostre o que foi pesquisado, o que apareceu e o que não pôde ser confirmado.

O fluxo depende de duas Skills auxiliares e de coleta externa. A unidade comment-mining organiza comentários e respostas. A unidade scrapecreators-api descreve como consultar dados públicos por GooseWorks MCP, CLI ou chave própria da ScrapeCreators. Isso amplia o alcance, mas também introduz custos, credenciais, termos de terceiros, dados pessoais e risco de conclusões maiores que a amostra.

O que esta Skill faz de verdade

A Skill começa com uma decisão concreta, como preparar uma resposta de suporte, revisar posicionamento, priorizar uma FAQ ou investigar uma objeção. Em seguida, forma grupos de consulta para marca, produtos, concorrentes, categoria, problemas e campanhas. O documento não manda pesquisar todas as redes indiscriminadamente. Ele orienta escolher as plataformas relevantes para a audiência e o mercado.

Depois da coleta, o fluxo deduplica reposts, distingue conteúdo próprio, menções espontâneas, criadores, perguntas, reclamações e spam. As conversas são agrupadas por tema, emoção, etapa de compra e intenção. O SKILL.md fixado alerta que sarcasmo derrota classificadores ingênuos e que ausência em uma amostra pública não prova inexistência de uma conversa.

O resultado é um briefing para decisão, não uma pesquisa representativa de mercado. Ele pode mostrar contagens da própria amostra, exemplos vinculados, perguntas frequentes, elogios, reclamações, sinais de criadores, riscos e oportunidades. Não deve converter esse recorte em percentual de toda a base de clientes.

Para quem serve

Serve a equipes de conteúdo, comunidade, atendimento, produto, pesquisa, marketing e comunicação que precisam entender conversas públicas sem perder a origem. Também é útil para pequenos negócios que recebem sinais dispersos em vídeos, posts e comentários e querem preparar uma pauta ou uma hipótese antes de investir em pesquisa mais ampla.

Não é a ferramenta certa para vigilância de pessoas, enriquecimento de perfis individuais, inferência de saúde, orientação política, origem étnica, religião, renda ou outros atributos sensíveis. Tampouco substitui pesquisa com clientes, SAC, dados de vendas, análise jurídica ou os recursos nativos de cada plataforma. O briefing ajuda a decidir o próximo teste, não a declarar a verdade sobre um público inteiro.

Compatibilidade e pré-requisitos

O manifesto da Skill declara suporte a Claude, Cursor e Codex. Para funcionar, ela exige Comment Mining e ScrapeCreators API. Instalar somente o arquivo principal não cria um coletor.

• Marca, produto, concorrentes, termos, país, idioma e período.
• Uma decisão que o briefing precisa informar.
• Plataformas autorizadas e tamanho máximo da amostra.
• Acesso ao GooseWorks MCP ou CLI, ou uma chave própria da ScrapeCreators.
• Orçamento e limite de créditos definidos antes da coleta.
• Política de retenção, minimização e descarte dos dados coletados.
• Revisão humana de contexto, ironia, homônimos e casos sensíveis.

Instalação recomendada

Comece pelo ZIP documental do Bastidores em uma pasta de teste. Ele contém oito arquivos: SKILL.md e skill.meta.json da unidade principal, os dois documentos equivalentes de cada dependência, licença MIT e ORIGEM.md. Não contém CLI, pacote npm, scripts, MCP, executáveis, chaves, cookies, tokens, respostas de API, posts, comentários, perfis, transcrições ou relatórios reais.

Há uma divergência que merece atenção. O manifesto usa npx goose-skills install social-listening-brief, enquanto o README do repositório mostra comandos npx gooseworks. O package.json clonado identifica o binário como goose-skills. Por isso, não copie um comando isolado sem conferir o pacote e a documentação que o mantenedor apresenta no momento da instalação.

git clone https://github.com/gooseworks-ai/goose-skills.git
git -C goose-skills checkout e1592ee2bdc563e3aa6e36b308bcd88f393e3817
# Leia a Skill principal, as duas dependências e a licença.
# Não faça login nem conecte MCP durante a inspeção.

Configuração antes do primeiro uso

Defina o alvo em uma folha curta. Registre nomes oficiais, apelidos, grafias erradas, campanhas, concorrentes e termos de categoria. Para cada grupo, explique por que ele está no escopo. Sem isso, uma palavra genérica pode misturar marcas homônimas, idiomas ou assuntos que não têm relação com a decisão.

Escolha poucas plataformas com justificativa. A documentação da ScrapeCreators lista endpoints para TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Reddit, Threads, Bluesky, Pinterest e outros serviços. Disponibilidade técnica não significa autorização editorial para coletar tudo. Confira também termos e políticas da plataforma de origem.

Fixe o período, o número máximo de itens, o número de páginas, os campos necessários e o tempo de retenção. Exclua do relatório nomes de pessoas quando não forem indispensáveis. Mantenha a URL canônica para auditoria e armazene somente o trecho necessário para explicar o tema.

Primeiro uso seguro

O melhor piloto é pequeno e deliberadamente limitado. Escolha uma marca, uma pergunta, duas plataformas e uma janela curta. Peça primeiro o plano de consulta e a estimativa de chamadas. Só depois aprove a coleta. Não peça ao agente para descobrir seguidores, características pessoais ou perfis privados.

Use Social Listening Brief em modo piloto.
Decisão: quais dúvidas públicas devem virar uma FAQ?
Escopo: marca X, Brasil, últimos 14 dias, YouTube e Reddit.
Máximo: 60 comentários públicos, com URL e data.
Não inferir atributos sensíveis nem identificar pessoas no resumo.
Separar sinal repetido, caso isolado, spam e lacuna.
Pare depois do plano e da estimativa de coleta para aprovação.

A primeira saída esperada é a matriz de consulta, não o briefing final. Revise termos ambíguos, contas oficiais, período, custo e campos antes de permitir chamadas externas.

Como o fluxo deve funcionar

1. Registrar a decisão, o mercado, o idioma, a janela e os limites.
2. Montar grupos transparentes para marca, produtos, concorrentes, categoria e problemas.
3. Selecionar somente plataformas relevantes e explicar exclusões.
4. Fazer uma chamada pequena e inspecionar o formato retornado.
5. Paginar até o limite aprovado ou até não haver próximo cursor.
6. Preservar URL, plataforma, data, autor público e contexto necessário.
7. Deduplicar por identificador nativo ou URL canônica.
8. Remover spam e separar conteúdo próprio, menção, criador, pergunta e reclamação.
9. Validar sentimento e ironia no conteúdo original.
10. Marcar sinais repetidos, picos de um único post e casos isolados.
11. Comparar com uma linha de base apenas quando períodos e consultas forem equivalentes.
12. Converter achados em ações, cada uma com responsável, urgência e evidência.

A dependência de coleta manda usar a OpenAPI oficial como fonte dos endpoints atuais. Isso é importante porque nomes, métodos, parâmetros, custos e formatos podem mudar. Não invente uma rota quando a operação falhar.

Resultado esperado

Um bom briefing começa com resumo executivo e cobertura. Ele mostra grupos de consulta, plataformas, período, total coletado, total removido como duplicata ou spam e lacunas. A tabela de temas usa contagens da amostra e diferencia padrões repetidos de um comentário isolado.

Exemplos representativos precisam manter link e contexto suficientes para revisão. Ações propostas devem ser proporcionais. Uma pergunta repetida pode justificar testar uma FAQ. Uma reclamação grave e isolada pode justificar encaminhamento ao suporte, mas não autoriza afirmar que a maioria dos clientes enfrenta o problema.

O documento deve encerrar com limitações. Se a plataforma bloqueou paginação, o período não pôde ser filtrado ou um concorrente tem nome ambíguo, isso entra no resultado. Qualidade aqui significa rastreabilidade e prudência, não volume.

Permissões, privacidade e riscos

O caminho gerenciado usa conta e créditos GooseWorks. O README informa que as credenciais locais ficam em arquivo protegido e que o MCP é opcional. A política de privacidade da GooseWorks diz que conteúdo do workspace e dados de integrações podem ser processados para fornecer o serviço. Leia a política atual antes de enviar informação de cliente.

Os termos da GooseWorks atribuem ao usuário a responsabilidade por leis, direitos de terceiros e revisão das saídas. Também informam que certos recursos usam créditos ou assinatura e que integrações obedecem aos termos dos respectivos serviços. A licença MIT do repositório não cobre automaticamente a API paga nem o conteúdo das plataformas.

O maior risco analítico é viés de seleção. Conteúdo público tende a refletir quem publicou, quem teve alcance e quem decidiu comentar. O maior risco de privacidade é reter mais dados pessoais do que a decisão exige. Colete menos, resuma padrões, restrinja acesso e descarte o bruto conforme a política definida.

Erros comuns

Chamar contagem da amostra de participação de mercado. Informe numerador, origem e período. Não extrapole.

Aplicar sentimento sem abrir o contexto. Ironia, gíria, citação e resposta podem inverter o sentido.

Somar reposts como vozes independentes. Deduplicate antes de medir repetição.

Pesquisar só o nome oficial. Inclua apelidos e erros conhecidos, mas revise homônimos.

Forçar todas as plataformas. Escolha fontes coerentes com a pergunta e registre o que ficou fora.

Guardar a chave no prompt. Use o runtime autenticado ou segredo local protegido e nunca registre o valor.

Confundir silêncio com ausência. Uma consulta sem resultados pode ter falhado, sido estreita ou encontrado uma plataforma indisponível.

Publicar exemplos com dados desnecessários. Preserve o link para auditoria e minimize identificação no texto agregado.

Versão, licença e origem verificadas

A API oficial do GitHub foi consultada em 04/09/2026. O repositório gooseworks-ai/goose-skills registrava 1.195 estrelas, estava público, não arquivado e declarava licença MIT. Estrelas indicam atenção relativa, não precisão do briefing, conformidade jurídica ou representatividade dos dados.

A curadoria fixou o commit e1592ee2bdc563e3aa6e36b308bcd88f393e3817. O último commit identificado pela API no caminho da Skill foi ac68ab00666aa878f5877c6686882c0eefeecc82, de 13/08/2026. Foram inspecionados a unidade principal, as duas dependências, os manifestos, README, package.json e a licença MIT.

O ZIP local contém oito arquivos documentais, tem 8.077 bytes e SHA-256 dd773b18146baa6033b792f6f74bfd3a37e15081f50cfcd6df325f49fd4ca114. A redistribuição preserva o aviso de licença. CLI, MCP, scripts, dados e credenciais foram omitidos.

Checklist antes de automatizar

• Fixe commit, cliente, runtime e as duas dependências.
• Declare a decisão, termos, mercado, idioma, plataformas e período.
• Estime créditos e limite chamadas, páginas e itens antes de coletar.
• Use somente conteúdo público necessário e respeite termos das fontes.
• Mantenha chaves, cookies e tokens fora do prompt, logs e arquivos versionados.
• Deduplicate e preserve o contexto de comentários e respostas.
• Revise sarcasmo, homônimos, spam e picos de um único post.
• Use contagens da amostra, nunca percentuais de toda a população sem desenho adequado.
• Não infira atributos sensíveis nem exponha pessoas desnecessariamente.
• Defina retenção, acesso e descarte do material bruto.
• Submeta cada ação de conteúdo, suporte, produto ou publicação à aprovação humana.

Fontes primárias

• Repositório oficial gooseworks-ai/goose-skills.
• Diretório da Skill no commit auditado.
• Instruções da Social Listening Brief.
• Dependência Comment Mining.
• Dependência ScrapeCreators API.
• README, compatibilidade, instalação e segurança.
• Licença MIT do repositório.
• Documentação oficial da ScrapeCreators.
• OpenAPI oficial da ScrapeCreators.
• Termos de serviço da GooseWorks.
• Política de privacidade da GooseWorks.