Shruwd

shruwd-mcp

Um servidor local de MCP para Shruwd. Ele permite que um agente de IA — Claude Desktop, Claude Code, Cursor, qualquer coisa que fale MCP — configure uma marca, adicione os prompts e concorrentes para monitorar, leia como a marca aparece em respostas geradas por IA e aja com base nos diagnósticos encontrados.

Você precisa de uma chave de API do painel do Shruwd (Conta → Chaves de API). A chave está vinculada a um workspace e alcança suas marcas nele: todas as marcas se você for o proprietário do workspace, ou apenas as marcas das quais você é membro caso contrário. Ela age com seu papel em cada marca: leituras exigem viewer, escritas exigem editor, e a criação de um token de ingestão exige admin; criar ou arquivar uma marca exige o papel de proprietário. Para trabalhar em vários workspaces, crie uma chave em cada um e adicione uma entrada de servidor por workspace.

Hospedado, sem instalação

As mesmas ferramentas estão disponíveis em https://shruwd.io/mcp (Streamable HTTP). No Claude.ai, ChatGPT ou Grok, adicione essa URL como um conector personalizado e entre com sua conta Shruwd; nenhuma chave é necessária. Um cliente que aceite um cabeçalho pode enviar uma chave em vez disso:

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

Configuração para cada aplicativo: 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_…" }
    }
  }
}

Ferramentas

Ferramenta	Função
shruwd_get_workspace	Plano, permissões, uso, marcas. Comece por aqui.
shruwd_list_brands · shruwd_get_brand · shruwd_create_brand · shruwd_update_brand · shruwd_archive_brand	Marcas. Criar uma também cria sua entidade própria e a primeira medição. Criar e arquivar exigem owner.
shruwd_list_prompts · shruwd_add_prompts · shruwd_update_prompt · shruwd_remove_prompt	As perguntas feitas a cada mecanismo a cada ciclo.
shruwd_list_entities · shruwd_add_competitor · shruwd_set_entity · shruwd_remove_entity	A marca e seus concorrentes, com os aliases exatos que contam como menção.
shruwd_run_measurement · shruwd_list_cycles	Meça agora; acompanhe o ciclo. Os resultados chegam nas horas seguintes.
shruwd_get_visibility · shruwd_get_visibility_series · shruwd_get_crawlers	Taxa de menção e participação de voz com intervalos, agora e a cada fechamento de ciclo; atividade verificada de rastreadores de IA.
shruwd_list_answers	As respostas individuais mais recentes: se a marca foi citada e em qual posição, os concorrentes citados, as páginas referenciadas. Evidência, não uma métrica.
shruwd_list_suggestions · shruwd_accept_suggestion · shruwd_dismiss_suggestion	Concorrentes citados nas respostas que a marca ainda não monitora.
shruwd_suggest_setup	Gera rascunhos de dez prompts e até seis concorrentes a partir da página inicial. Nada é salvo até que sejam adicionados com as ferramentas usuais.
shruwd_list_findings · shruwd_get_finding · shruwd_transition_finding	Diagnósticos com uma correção específica; marque uma correção como aplicada para iniciar a reavaliação. Planos limitados retornam o restante como uma contagem de locked.
shruwd_create_ingest_token	O token e o endpoint para envio de logs do servidor. Exige admin.

Cada ferramenta retorna exatamente o que a API retorna. As métricas nunca são números isolados: cada uma é uma estimativa pontual com seu intervalo de 95% e n, ou um estado explícito de insufficient_data, que as descrições das ferramentas orientam o agente a não interpretar como zero. Planos que limitam os achados visíveis relatam o restante como uma contagem de locked em vez de ocultar que ele existe.

Ambiente

Variável
SHRUWD_API_KEY	Obrigatória.
SHRUWD_API_URL	Opcional. O padrão é https://shruwd.io/api/v1.