Rolli MCP

rolli-mcp

Servidor MCP para Rolli IQ — búsqueda y análisis de redes sociales en X, Reddit, YouTube, Facebook, Instagram, Threads, Bluesky y más.

Herramientas

Herramienta	Descripción
list_keyword_searches	Lista todas las búsquedas por palabras clave, filtradas por estado
keyword_search	Crea una búsqueda por palabra clave/hashtag y devuelve los resultados cuando esté completa
get_keyword_search	Obtén resultados de búsqueda por palabra clave (estado, análisis, publicaciones)
list_user_searches	Lista todas las búsquedas de usuarios, filtradas por estado
user_search	Crea una búsqueda de perfil de usuario y devuelve los resultados cuando esté completa
get_user_search	Obtén resultados de búsqueda de usuario (perfil, métricas, análisis de contenido)
list_expert_searches	Lista todas las búsquedas de expertos, filtradas por estado
expert_search	Encuentra expertos que coincidan con una consulta en lenguaje natural y devuelve los resultados cuando esté completa
get_expert_search	Obtén resultados de búsqueda de expertos (expertos recomendados con resúmenes de coincidencia generados por IA)
get_topic_tree	Obtén el árbol de temas de conversación para una búsqueda por palabra clave
get_keyword_search_posts	Obtén publicaciones sin procesar de una búsqueda por palabra clave
get_user_search_posts	Obtén publicaciones sin procesar de una búsqueda de usuario
list_agent_runs	Lista las ejecuciones de Rolli Agent (investigaciones de inteligencia social impulsadas por IA)
start_agent_run	Inicia una investigación de Rolli Agent y devuelve el informe en markdown cuando esté completa
get_agent_run	Obtén una ejecución de Rolli Agent por ID (progreso mientras se ejecuta, informe completo cuando termine)
cancel_agent_run	Cancela una ejecución de Rolli Agent pendiente o en curso
rerun_agent_run	Reintenta una ejecución de Rolli Agent fallida, en espera o bloqueada
update_agent_run	Fija o renombra una ejecución de Rolli Agent
delete_agent_run	Elimina de forma suave una ejecución de Rolli Agent completada o fallida
list_agent_schedules	Lista los informes programados de Rolli Agent
create_agent_schedule	Crea un informe recurrente de Rolli Agent (diario/semanal/mensual/una vez)
get_agent_schedule	Obtén un programa de Rolli Agent con sus 10 ejecuciones más recientes
update_agent_schedule	Actualiza un programa de Rolli Agent
delete_agent_schedule	Elimina permanentemente un programa de Rolli Agent
pause_agent_schedule	Pausa un programa de Rolli Agent
resume_agent_schedule	Reanuda un programa de Rolli Agent pausado
list_agent_schedule_runs	Lista el historial completo de ejecuciones de un programa de Rolli Agent
get_integration_setup	Obtén la configuración actual de integración (URL de webhook, nombre)
update_integration_setup	Establece la URL de webhook para notificaciones de finalización de búsqueda
get_usage	Obtén datos de uso de API y desgloses por usuario

Configuración

Necesitas una cuenta de Rolli con acceso a la API. Obtén tu token de API en rolli.ai.

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

Agrega a tu configuración de MCP (claude_desktop_config.json, .vscode/mcp.json, o equivalente):

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

ROLLI_USER_ID es opcional y tiene como valor predeterminado "rolli-mcp". Configúralo para sobrescribir con tu propio ID de usuario.

Variables de Entorno Opcionales

Variable	Predeterminado	Descripción
ROLLI_USER_ID	"rolli-mcp"	ID de usuario enviado con las solicitudes de API
ROLLI_POLL_INTERVAL_MS	5000	Intervalo de sondeo (ms) al esperar resultados de búsqueda
ROLLI_MAX_POLL_MS	600000	Tiempo máximo (ms) de espera antes del tiempo de espera de búsqueda (predeterminado: 10 min)

Smithery

Este servidor incluye un smithery.yaml para implementación mediante Smithery. Te pedirá tu token de API durante la configuración.

Ejemplos de Uso

Busca una palabra clave en redes sociales:

"Busca publicaciones sobre 'inteligencia artificial' en Twitter y Reddit de la última semana"

Analiza un perfil de usuario:

"Busca @elonmusk en Twitter y analiza sus publicaciones recientes"

Obtén desglose de temas:

"Muéstrame el árbol de temas para mi búsqueda por palabra clave #123"

Consulta el uso de API:

"¿Cuántas búsquedas he usado este mes?"

Configura un webhook:

"Establece mi URL de webhook a https://myapp.com/rolli-callback"

Contexto Opcional de Fuente X/Twitter

Rolli es útil para búsqueda social multiplataforma, árboles de temas, análisis de usuarios e informes programados de inteligencia social. Si un agente también necesita evidencia revisada de fuente X/Twitter con alcance de cuenta antes de una investigación de Rolli, recopila esa evidencia en un flujo de trabajo aprobado de OpenClaw como TweetClaw, y luego pasa solo los handles revisados, URLs de publicaciones, IDs de publicaciones, extractos o notas de resumen a los prompts de Rolli.

Mantén las credenciales de Rolli y TweetClaw separadas. No transfieras tokens de API, cookies, sesiones o credenciales de cuenta entre herramientas. Trata la salida de TweetClaw como contexto de fuente para búsquedas e informes de Rolli, no como aprobación de publicación.

Desarrollo

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

CI se ejecuta en cada push y PR a master. Las versiones publicadas en GitHub se publican automáticamente en npm (requiere el secreto de repositorio NPM_TOKEN).

Licencia

MIT