Skip to main content
Glama
X Search MCP

X Search MCP

by joaovfnandes

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.

Available Tools

2 tools
list_cua_toolsA

Lista as ferramentas disponiveis no CUA MCP conectado ao Edge.

Inputs: no named parameters.

search_xA

Pesquisa no X.com usando o Microsoft Edge controlado pelo CUA e retorna o texto acessivel da pagina. Aceita operadores como from:, since:, until:, lang:, filter:links e frases entre aspas.

Inputs: query (required), live.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 2 tools

    Disambiguation5/5

    list_cua_tools and search_x have clearly distinct purposes with no overlap. One lists available CUA tools, the other performs searches on X.com, making disambiguation trivial.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern in snake_case: 'list_cua_tools' and 'search_x'. The naming convention is uniform across the tool set.

    Tool Count3/5

    With only 2 tools, the set feels thin for a server named 'X Search MCP' which suggests a broader scope. However, the count is not extreme, and the tools serve basic functions.

    Completeness2/5

    The server's stated purpose is X search, but it only provides a single search tool and a meta-tool for listing CUA tools. Missing common operations like retrieving individual tweets, user search, or timeline access make the surface incomplete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables searching X (formerly Twitter) using xAI's Responses API with support for filtering by handles, date ranges, and media understanding, returning structured results with citations.
      1
      16 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to search X posts and read user timelines without API costs, using cookie authentication.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables reading public X (Twitter) content like profiles, tweets, and search results via a stealth browser, without official API costs.
      11
      20 PyPI
      MIT