X Search MCP

Este MCP usa o CUA Driver para controlar o Microsoft Edge e pesquisar no X.com usando o mesmo perfil que já está aberto e autenticado.

Ferramentas

• list_cua_tools: lista as ferramentas expostas pelo CUA conectado.

• search_x: abre uma busca no X e retorna o texto atual da página.

• get_latest_profile_posts: retorna os posts mais recentes visíveis de um perfil.

• get_profile_info: retorna o texto acessível com as informações visíveis de um perfil.

• search_hashtag_top: pesquisa uma hashtag e retorna os resultados mais relevantes.

• search_hashtag_latest: pesquisa uma hashtag e retorna os posts mais recentes.

• get_post_thread: abre um post e retorna o contexto visível da conversa.

search_x aceita operadores do X, por exemplo:

• from:OpenAI model;

• "frase exata";

• since:2026-07-01 until:2026-07-15;

• lang:pt filter:links.

O parâmetro live=true abre a aba de posts mais recentes. Ele apenas controla o filtro da busca; não é usado como mecanismo de atualização.

Related MCP server: Xee-mcp

Como funciona

1. Localiza a janela aberta do Edge com list_windows.

2. Navega pela barra de endereços usando get_window_state, click, set_value e press_key.

3. Lê o conteúdo atual com page(action="get_text").

4. Confirma que a URL e o texto retornado pertencem à consulta atual antes de responder.

Essa validação evita devolver silenciosamente o conteúdo de uma busca anterior quando a árvore de acessibilidade do X fica defasada.

Instalação

npm install
npm run build

Variáveis necessárias para o CUA via stdio:

CUA_TRANSPORT=stdio
CUA_COMMAND=C:\Users\User\AppData\Local\Programs\Cua\cua-driver\bin\cua-driver.exe
CUA_ARGS_JSON=["mcp"]

Para CUA via HTTP:

CUA_TRANSPORT=http
CUA_URL=http://localhost:3000/mcp

Teste de regressão

Com o Edge aberto e autenticado no X:

npm run test:sequential

O teste executa quatro pesquisas consecutivas e uma leitura de perfil na mesma sessão. Ele falha se alguma resposta contiver conteúdo defasado ou se a timeline do perfil ainda estiver carregando.

Para testar somente a timeline de um perfil:

npm run test:profile

Requisitos e limites

• O Edge precisa estar aberto no perfil desejado.

• A sessão do X precisa estar autenticada para buscas completas.

• O MCP não armazena senha e não contorna login, CAPTCHA ou controles do site.

• Não é necessário iniciar o Edge com porta de debugging nem usar perfil temporário.