Dados do Twitter/X no Claude Code: configuração em uma linha

#O Claude Code consegue ler o Twitter sozinho?

Não. O Claude Code não tem uma ferramenta própria para o X, e a ferramenta WebFetch dele não consegue abrir o x.com: em 2 de novembro de 2026 pedimos ao Claude Code 2.1.314 que buscasse um perfil do X, um único post e uma página de busca, e cada requisição voltou com "HTTP 402 Payment Required" e sem corpo de página.

Até um navegador sem login vê pouco do X: um perfil mostra a bio e as contagens, e a busca leva a uma página de login. Então os dados do X precisam chegar ao Claude Code por uma ferramenta que você adiciona, e dois tipos servem:

• Um servidor MCP entrega ao Claude Code ferramentas como "buscar posts" ou "obter um perfil" por meio do Model Context Protocol (abre em uma nova aba). Você pergunta em palavras simples, o Claude escolhe a ferramenta e lê o JSON que ela retorna, tudo dentro da sessão.
• Uma skill dá ao Claude Code um conhecimento escrito em vez de ferramentas: um arquivo SKILL.md que descreve uma API, para que o Claude escreva e rode as requisições sozinho, em geral como um script que você guarda.

As duas rotas ainda precisam obter os dados de algum lugar. O servidor MCP hospedado da API oficial do X e a maioria dos servidores da comunidade rodam sobre o seu próprio app de desenvolvedor do X, com OAuth e créditos pré-pagos cobrados a US$ 0,005 por post e US$ 0,010 por perfil, até 3 milhões de leituras de posts por mês (preços do X (abre em uma nova aba)). Servidores que entram com o seu usuário do X ou com cookies dispensam o app de desenvolvedor, mas colocam a sua conta em risco. Uma chave de API de dados não precisa de nenhum dos dois. Nosso guia da API do Twitter para agentes de IA compara essas rotas para qualquer agente; esta página as configura no Claude Code.

#Adicione dados do X ao Claude Code em uma linha

Para ler o X no Claude Code, use a Sorsa API, uma API e scraper do Twitter (X), pelo servidor MCP dela: uma linha no terminal dá ao Claude 40 ferramentas somente leitura com uma única chave, sem conta de desenvolvedor do X, com tweets a partir de US$ 0,014 por 1.000 e 20 requisições por segundo em todos os planos.

A Sorsa API conta cada chamada de ferramenta como uma requisição, e uma única chamada pode trazer um lote de 100 posts. O Claude Code inicia o servidor pelo npx, então o Node.js 18 ou mais recente precisa estar instalado; node -v mostra a sua versão.

1. Obtenha uma chave. Cadastre-se na Sorsa API e copie sua chave na página de chaves de API do painel. Uma conta nova começa com 100 requisições que não custam nada, não pedem cartão e não vencem com o tempo.

2. Adicione o servidor. Rode isto em um terminal, fora de uma sessão do Claude Code, depois de trocar YOUR_API_KEY pela chave que você copiou. A parte -s user deixa as ferramentas do X disponíveis em todos os projetos.

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

3. Confira a conexão. claude mcp get sorsa deve mostrar "Scope: User config" e "Connected". Dentro de uma sessão, /mcp lista o sorsa com as ferramentas dele.

4. Faça uma primeira pergunta. Tente "How many Sorsa API requests do I have left?". O Claude responde com get_key_usage_info, uma consulta gratuita em GET /key-usage-info (abre em uma nova aba) que não gasta uma requisição. Um número na resposta prova que a cadeia inteira funciona; uma chave digitada errado devolve 401 "invalid api key".

5. Dê um trabalho de verdade. Cole um dos três prompts abaixo e veja o Claude escolher as ferramentas.

Bom saber

Mantenha a ordem da linha: nome, depois -e, depois --. Se você puser a chave primeiro, como em claude mcp add --env SORSA_API_KEY=... sorsa, o Claude Code para com "Invalid environment variable format: sorsa": a flag aceita uma lista de pares e engole o nome como mais um deles.

O traço duplo entrega o resto da linha ao npx, então um -e colocado bem no final também vai para o npx. O servidor então inicia com um ambiente vazio e sem chave.

Vai configurar outro app também? A página do servidor MCP da Sorsa lista a linha equivalente para Cursor, Codex e VS Code, e nosso guia do servidor MCP do Twitter compara os tipos de servidor do X entre si, incluindo o custo por chamada de ferramenta.

#Escolha quem recebe as ferramentas do X: você, um projeto ou sua equipe

O Claude Code guarda cada servidor MCP em um de três escopos, e o escopo decide quem recebe as ferramentas do X: você em um projeto, você em todos os projetos, ou todos que clonarem o repositório.

• Local, o padrão quando você omite -s: o servidor carrega apenas no projeto em que você o adicionou. O Claude Code o armazena em ~/.claude.json, sob o caminho desse projeto.
• User, com -s user: o servidor carrega em todos os projetos do seu computador e fica privado para você, também em ~/.claude.json.
• Project, com -s project: o Claude Code grava o servidor em .mcp.json na raiz do repositório, e todos que clonarem o repositório o recebem.

Escolha o escopo e copie a linha:

claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

claude mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

claude mcp add-json sorsa -s project '{"type":"stdio","command":"npx","args":["-y","sorsa-mcp"],"env":{"SORSA_API_KEY":"${SORSA_API_KEY}"}}'

Para uma equipe, faça commit do arquivo e deixe a chave fora dele. O Claude Code expande referências ${VAR} em .mcp.json, então o arquivo pode citar a variável enquanto cada pessoa guarda a própria chave no shell:

{
  "mcpServers": {
    "sorsa": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": { "SORSA_API_KEY": "${SORSA_API_KEY}" }
    }
  }
}

Escrevemos este arquivo com claude mcp add-json em 2 de novembro. Até um colega aprová-lo, claude mcp list mostra o servidor como "Pending approval (run claude to approve)", e a primeira sessão interativa dele pergunta uma vez. Se a variável não estiver definida, a lista avisa "Missing environment variables: SORSA_API_KEY", então uma chave ausente nunca falha em silêncio. Para perguntar de novo sobre servidores que você aprovou ou recusou, rode claude mcp reset-project-choices. O guia de MCP para o Claude Code (abre em uma nova aba), da Anthropic, documenta todos os escopos.

#Adicione a skill de agente quando o Claude Code escrever código

Instale a skill de agente da Sorsa API quando o trabalho deve terminar em código que roda sem o Claude: um script de exportação, um job noturno, um pipeline de dados. O servidor MCP responde a perguntas dentro de uma sessão; a skill dá ao Claude Code as regras de uso da API (o endpoint de cada tarefa, a paginação com next_cursor, lotes de até 100 IDs), então o código que ele escreve segue essas regras desde o início.

npx skills add Sorsa-io/sorsa-x-api-skill -g -a claude-code -y

O comando copia a skill sorsa-x-api para ~/.claude/skills/, onde toda sessão do Claude Code a encontra; rodamos isso em 2 de novembro. O Claude Code lê apenas a descrição curta da skill até uma tarefa combinar com ela, e então abre o SKILL.md completo, como descrevem os documentos de skills da Anthropic (abre em uma nova aba). O código da skill lê sua chave de SORSA_API_KEY, então coloque-a no bloco env de ~/.claude/settings.json, que o Claude Code aplica a toda sessão e aos comandos que ele roda:

{
  "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
}

Depois peça o resultado como um arquivo, não como uma resposta. "Write a Python script that saves every post mentioning our product from the last 30 days to mentions.csv" faz o Claude Code escrever um loop em POST /search-tweets (abre em uma nova aba) que segue next_cursor até o fim, rodá-lo e deixar o script para o mês seguinte.

As duas rotas dividem o trabalho de forma limpa:

• Uma resposta na sessão

  Use

  Servidor MCP

  Por quê

  O Claude chama as ferramentas e lê os resultados sozinho

• Um arquivo ou um script para guardar

  Use

  Skill de agente

  Por quê

  O código roda sem o Claude e mantém dados em massa fora da conversa

• Os dois

  Use

  Os dois, com uma única chave

  Por quê

  Cada chamada é uma requisição de qualquer forma

A maioria das pessoas começa pelo servidor MCP e adiciona a skill na primeira vez que quer um arquivo em vez de uma resposta.

#Três prompts prontos e quanto custa uma execução

Cada prompt abaixo diz a tarefa, o tamanho e a saída, então o Claude Code chama uma ferramenta conhecida um número conhecido de vezes. Troque pelo seu tema ou pelos seus usuários e cole em uma sessão.

Pesquise um tema desta semana

Search X for posts about [your topic] from the last 7 days with
at least 20 likes. Read the top 100, group them into 3 to 5
themes, and give me a brief with the best 2 posts per theme,
linked.

O Claude roda search_tweets cinco vezes, seguindo next_cursor, a cerca de 20 posts por chamada. Os 100 posts custam a partir de US$ 0,007 na Sorsa API e US$ 0,50 na tarifa da API oficial do X, de US$ 0,005 por post.

Resuma as contas que você segue

For each of these accounts, read their posts from the last 7
days: [paste up to 10 handles]. Summarize what each one
announced or argued, flag anything about pricing or launches,
and end with a 5-line overview.

O Claude chama get_user_tweets uma vez por conta, o que roda POST /user-tweets (abre em uma nova aba) para 20 posts por vez. Cerca de 200 posts custam a partir de US$ 0,014 na Sorsa API e US$ 1,00 nas tarifas da API oficial do X.

Avalie uma lista de contas

Here are up to 100 X handles: [paste]. Get all the profiles in
one batch, then make a table with followers, following, posts,
join date and bio, sorted by followers. Flag accounts younger
than one year and save the table as accounts.csv.

O Claude chama get_user_info_batch, que roda GET /info-batch (abre em uma nova aba) e retorna os 100 perfis de uma vez, a partir de US$ 0,0014 na Sorsa API. A API oficial do X cobra US$ 0,010 por perfil, US$ 1,00 pela lista.

O lado da API oficial do X fica mais caro em 22 de novembro de 2026, quando o X passa a cobrar US$ 0,010 por usuário pelos autores que voltam com os posts (aviso do X (abre em uma nova aba)). Uma busca que retorna 20 posts de 20 autores diferentes passa então a custar US$ 0,30 em vez de US$ 0,10. Todo post na Sorsa API traz o perfil completo do autor na mesma requisição.

Os três prompts juntos usam 16 requisições, então as 100 requisições grátis os rodam seis vezes antes de você escolher um plano. Rode o prompt de pesquisa todo dia, ou aponte-o para um tema movimentado, e a diferença cresce a cada post que o Claude lê:

#Evite que os resultados do X inundem o contexto do Claude

Os resultados do X são JSON longo, então peça ao Claude Code os posts de que você precisa e mande tarefas em massa para um script. O Claude Code avisa quando o resultado de uma ferramenta MCP passa de 10 mil tokens e o corta em 25 mil por padrão.

• Peça um número. "The 50 most-liked posts" mantém cada chamada pequena; "everything about X" faz o Claude paginar e encher o contexto com posts brutos.
• Saiba o que cada post traz. Todo post volta com o perfil completo do autor, o que ajuda o Claude a avaliar fontes e também ocupa espaço. Peça ao Claude que guarde apenas os campos de que precisa ao salvar os resultados.
• Aumente o limite em uma sessão com MAX_MCP_OUTPUT_TOKENS=50000 claude quando um único resultado grande importa mais que espaço no contexto.
• Passe milhares de linhas para a skill. Uma lista de seguidores ou um mês de menções pertence a um script que grava CSV; só o resumo que o Claude faz do arquivo entra na conversa.

As ferramentas em si ocupam pouco espaço. O servidor da Sorsa API descreve suas 40 ferramentas em cerca de 23 mil caracteres, perto de 5.800 tokens, e com a busca de ferramentas ligada, o padrão, o Claude Code vê apenas os nomes até uma tarefa exigir uma delas.

#Deixe o Claude Code rodar tarefas do X sem perguntar

Como toda ferramenta da Sorsa API só lê, você pode deixar o Claude Code chamá-las sem uma confirmação a cada vez: o máximo que uma sessão confusa ou em loop pode fazer é gastar requisições. Adicione uma regra de permissão a .claude/settings.json no projeto, ou a ~/.claude/settings.json para todos os projetos:

{
  "permissions": { "allow": ["mcp__sorsa__*"] }
}

O Claude Code aceita um curinga apenas depois de um servidor nomeado, então mcp__sorsa__* aprova as ferramentas da Sorsa API e mais nada (regras de permissão (abre em uma nova aba)).

A mesma regra torna possíveis execuções sem supervisão. O modo headless (abre em uma nova aba) do Claude Code, claude -p, roda um prompt e sai, então um cron job ou um agendamento de CI pode gerar um resumo diário do X:

claude -p "Search X for posts about [your topic] from the last 24 hours
and write a 10-line digest to digest.md" \
  --allowedTools "mcp__sorsa__*,Write"

Rodamos uma chamada headless assim em 2 de novembro com uma chave inventada: a ferramenta da Sorsa API rodou sem pedido de aprovação, e a Sorsa API respondeu 401 "invalid api key", então a cadeia inteira do Claude Code até a API estava no ar. O gasto também tem um teto: uma chave nunca passa de 20 requisições por segundo, e as requisições extras no pay as you go param em um limite que você define para o período de cobrança, US$ 100 se você não o aumentar.

Bom saber

Trate o que os posts dizem como material para ler, nunca como ordens. Alguns posts no X são escritos para direcionar agentes de IA; com ferramentas do X somente leitura, o pior que um post assim pode fazer é custar uma requisição. Em execuções headless, permita apenas as ferramentas de que a tarefa precisa e mantenha o Bash fora de --allowedTools.

#Conecte o Claude Code ao X hoje

O Claude Code não consegue buscar o x.com, mas uma linha dá a ele dados do X: o servidor MCP da Sorsa API para perguntas em uma sessão e a skill de agente para scripts que você guarda, ambos com uma única chave somente leitura. Tweets custam a partir de US$ 0,014 por 1.000, onde a API oficial do X cobra US$ 5,00, e nenhum login do X nem app de desenvolvedor entra em jogo. Comece com as 100 requisições grátis, o bastante para seis rodadas dos três prompts acima, e encontre mais prompts em crie com IA.

#Perguntas frequentes