Rolli MCP

rolli-mcp

Servidor MCP para Rolli IQ — busca e análise de mídias sociais em X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky e outras.

Ferramentas

Ferramenta	Descrição
list_keyword_searches	Lista todas as buscas por palavra-chave, filtradas por status
keyword_search	Cria uma busca por palavra-chave/hashtag e retorna os resultados quando concluída
get_keyword_search	Obtém os resultados da busca por palavra-chave (status, análises, posts)
list_user_searches	Lista todas as buscas de usuários, filtradas por status
user_search	Cria uma busca de perfil de usuário e retorna os resultados quando concluída
get_user_search	Obtém os resultados da busca de usuário (perfil, métricas, análise de conteúdo)
list_expert_searches	Lista todas as buscas de especialistas, filtradas por status
expert_search	Encontra especialistas correspondentes a uma consulta em linguagem natural e retorna os resultados quando concluída
get_expert_search	Obtém os resultados da busca de especialistas (especialistas recomendados com resumos de correspondência gerados por IA)
get_topic_tree	Obtém a árvore de tópicos da conversa para uma busca por palavra-chave
get_keyword_search_posts	Obtém posts brutos de uma busca por palavra-chave
get_user_search_posts	Obtém posts brutos de uma busca de usuário
list_agent_runs	Lista execuções do Rolli Agent (investigações de inteligência social orientadas por IA)
start_agent_run	Inicia uma investigação do Rolli Agent e retorna o relatório em markdown quando concluída
get_agent_run	Obtém uma execução do Rolli Agent pelo ID (progresso enquanto está em execução, relatório completo quando concluída)
cancel_agent_run	Cancela uma execução do Rolli Agent pendente ou em andamento
rerun_agent_run	Repete uma execução do Rolli Agent que falhou, está aguardando ou travada
update_agent_run	Fixa ou renomeia uma execução do Rolli Agent
delete_agent_run	Exclui temporariamente uma execução do Rolli Agent concluída ou com falha
list_agent_schedules	Lista relatórios agendados do Rolli Agent
create_agent_schedule	Cria um relatório recorrente do Rolli Agent (diário/semanal/mensal/único)
get_agent_schedule	Obtém um agendamento do Rolli Agent com suas 10 execuções mais recentes
update_agent_schedule	Atualiza um agendamento do Rolli Agent
delete_agent_schedule	Exclui permanentemente um agendamento do Rolli Agent
pause_agent_schedule	Pausa um agendamento do Rolli Agent
resume_agent_schedule	Retoma um agendamento pausado do Rolli Agent
list_agent_schedule_runs	Lista o histórico completo de execuções de um agendamento do Rolli Agent
get_integration_setup	Obtém as configurações atuais de integração (URL do webhook, nome)
update_integration_setup	Define a URL do webhook para notificações de conclusão de busca
get_usage	Obtém dados de uso da API e detalhamentos por usuário

Configuração

Você precisa de uma conta Rolli com acesso à API. Obtenha seu token de API em rolli.ai.

Claude Desktop / Claude Code / VS Code / Cursor / Windsurf

Adicione à sua configuração MCP (claude_desktop_config.json, .vscode/mcp.json ou equivalente):

{
  "mcpServers": {
    "rolli": {
      "command": "npx",
      "args": ["-y", "@rolli/mcp"],
      "env": {
        "ROLLI_API_TOKEN": "your_token"
      }
    }
  }
}

ROLLI_USER_ID é opcional e o padrão é "rolli-mcp". Defina-o para substituir pelo seu próprio ID de usuário.

Variáveis de Ambiente Opcionais

Variável	Padrão	Descrição
ROLLI_USER_ID	"rolli-mcp"	ID de usuário enviado com solicitações de API
ROLLI_POLL_INTERVAL_MS	5000	Intervalo de polling (ms) ao aguardar resultados de busca
ROLLI_MAX_POLL_MS	600000	Tempo máximo (ms) de espera antes do timeout da busca (padrão: 10 min)

Smithery

Este servidor inclui um smithery.yaml para implantação via Smithery. Ele solicitará seu token de API durante a configuração.

Exemplos de Uso

Buscar uma palavra-chave nas mídias sociais:

"Busque posts sobre 'inteligência artificial' no Twitter e Reddit da última semana"

Analisar um perfil de usuário:

"Consulte @elonmusk no Twitter e analise seus posts recentes"

Obter detalhamento de tópicos:

"Mostre-me a árvore de tópicos para minha busca por palavra-chave #123"

Verificar uso da API:

"Quantas buscas usei este mês?"

Configurar um webhook:

"Defina minha URL de webhook para https://myapp.com/rolli-callback"

Contexto Opcional de Fonte X/Twitter

O Rolli é útil para busca social multiplataforma, árvores de tópicos, análise de usuários e relatórios agendados de inteligência social. Se um agente também precisar de evidências revisadas de fonte X/Twitter com escopo de conta antes de uma investigação do Rolli, colete essas evidências em um fluxo de trabalho OpenClaw aprovado, como TweetClaw, e depois passe apenas os handles revisados, URLs de posts, IDs de posts, trechos ou notas de resumo para os prompts do Rolli.

Mantenha as credenciais do Rolli e do TweetClaw separadas. Não transfira tokens de API, cookies, sessões ou credenciais de conta entre ferramentas. Trate a saída do TweetClaw como contexto de fonte para buscas e relatórios do Rolli, não como aprovação de publicação.

Desenvolvimento

npm ci
npm run lint    # ESLint
npm run build   # TypeScript
npm test        # Vitest

O CI é executado em cada push e PR para master. As versões publicadas no GitHub são automaticamente publicadas no npm (requer o segredo do repositório NPM_TOKEN).

Licença

MIT