Shruwd

shruwd-mcp

Un servidor local de MCP para Shruwd. Permite que un agente de IA — Claude Desktop, Claude Code, Cursor, cualquier cosa que hable MCP — configure una marca, añada los prompts y competidores a rastrear, lea cómo aparece la marca en respuestas generadas por IA, y actúe sobre los hallazgos de diagnóstico.

Necesitas una clave de API del panel de Shruwd (Cuenta → Claves de API). La clave está vinculada a un espacio de trabajo y alcanza tus marcas en él: todas las marcas si eres dueño del espacio de trabajo, las marcas de las que eres miembro en caso contrario. Actúa con tu rol en cada marca: las lecturas necesitan viewer, las escrituras editor, la acuñación de un token de ingesta admin; crear o archivar una marca requiere ser dueño. Para trabajar en varios espacios de trabajo, acuña una clave en cada uno y añade una entrada de servidor por espacio de trabajo.

Alojado, sin instalación

Las mismas herramientas se ejecutan en https://shruwd.io/mcp (HTTP Streamable). En Claude.ai, ChatGPT o Grok, añade esa URL como conector personalizado e inicia sesión con tu cuenta de Shruwd; no se necesita clave. Un cliente que acepte un encabezado puede enviar una clave en su lugar:

claude mcp add --transport http shruwd https://shruwd.io/mcp --header "Authorization: Bearer sh_live_…"

Configuración para cada aplicación: shruwd.io/docs/api/mcp-server.

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

Claude Code

claude mcp add shruwd -e SHRUWD_API_KEY=sh_live_… -- npx -y shruwd-mcp

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

Herramientas

Herramienta	Función
shruwd_get_workspace	Plan, derechos, uso, marcas. Empieza aquí.
shruwd_list_brands · shruwd_get_brand · shruwd_create_brand · shruwd_update_brand · shruwd_archive_brand	Marcas. Crear una también crea su entidad propia y su primera medición. Crear y archivar requieren owner.
shruwd_list_prompts · shruwd_add_prompts · shruwd_update_prompt · shruwd_remove_prompt	Las preguntas formuladas a cada motor en cada ciclo.
shruwd_list_entities · shruwd_add_competitor · shruwd_set_entity · shruwd_remove_entity	La marca y sus competidores, con los alias exactos que cuentan como mención.
shruwd_run_measurement · shruwd_list_cycles	Medir ahora; observar el ciclo. Los resultados llegan en las horas siguientes.
shruwd_get_visibility · shruwd_get_visibility_series · shruwd_get_crawlers	Tasa de mención y cuota de voz con intervalos, ahora y en cada cierre de ciclo; actividad verificada de rastreadores de IA.
shruwd_list_answers	Las respuestas individuales más recientes: si la marca fue nombrada y en qué posición, los competidores nombrados, las páginas citadas. Evidencia, no una métrica.
shruwd_list_suggestions · shruwd_accept_suggestion · shruwd_dismiss_suggestion	Competidores que las respuestas nombraron y que la marca aún no rastrea.
shruwd_suggest_setup	Redacta diez prompts y hasta seis competidores desde la página de inicio. Nada se guarda hasta que se añaden con las herramientas habituales.
shruwd_list_findings · shruwd_get_finding · shruwd_transition_finding	Diagnósticos con una corrección específica; marca una corrección como aplicada para iniciar la revisión. Los planes limitados devuelven el resto como un recuento de locked.
shruwd_create_ingest_token	El token y el endpoint para enviar registros del servidor. Requiere admin.

Cada herramienta devuelve exactamente lo que devuelve la API. Las métricas nunca son números simples: cada una es una estimación puntual con su intervalo del 95% y n, o un estado explícito de insufficient_data, que las descripciones de las herramientas indican al agente que no lea como cero. Los planes que limitan los hallazgos visibles informan el resto como un recuento de locked en lugar de ocultar que existe.

Entorno

Variable
SHRUWD_API_KEY	Obligatoria.
SHRUWD_API_URL	Opcional. El valor predeterminado es https://shruwd.io/api/v1.