API do Twitter (X) para agentes de IA e ferramentas de código (2026)

Por Sorsa Editorial

Atualizado em julho de 2026: adiciona o servidor MCP hospedado oficial do X (lançado em 30 de junho de 2026) e atualiza as taxas de leitura de pagamento por uso da API do X contra a mudança de 20 de abril de 2026.

Em resumo: Agentes de IA e ferramentas de código alcançam dados públicos do X (Twitter) de três formas: um servidor MCP que expõe ferramentas de leitura a clientes de chat, uma skill de agente que ensina os endpoints às ferramentas de código e uma API REST simples chamada a partir de código gerado. O acesso somente leitura mantém agentes autônomos fora das contas de usuário, e a cobrança fixa por requisição evita custos por recurso.

A maioria dos guias sobre uma API do Twitter para agentes de IA supõe que o agente vai postar. Observar um feed, rascunhar uma resposta, publicar. Esse é um trabalho, e a API oficial do X é dona dele. O trabalho maior e que mais cresce é a leitura: um agente que busca conversas, puxa um perfil, verifica quem segue quem ou coleta tweets para um modelo resumir. A leitura é onde uma camada de dados gerenciada e somente leitura vence ligar um agente autônomo a uma conta com capacidade de escrita.

É essa lacuna que a Sorsa API, uma API alternativa do Twitter (X) feita para acesso de leitura intensa, preenche para quem constrói com IA. Ela expõe 40 endpoints de leitura em perfis, tweets, busca, seguidores, Listas, Comunidades e verificações, com uma única chave de API em um cabeçalho ApiKey (sem OAuth, sem análise de app), cobrança fixa por requisição a partir de US$ 0,02 por 1.000 tweets e um limite fixo de 20 requisições por segundo em todos os planos. Contas novas ganham 100 requisições grátis, uma única vez, sem cartão de crédito, em todos os 40 endpoints, o bastante para ligar um agente a dados reais antes de pagar qualquer coisa.

Este guia cobre os três caminhos de conexão, como o somente leitura muda a conta de segurança para agentes autônomos, como as peças mapeiam para as ferramentas que as pessoas de fato usam (Claude Desktop, Cursor, Claude Code, Codex, Windsurf e construtores de vibe coding) e quanto os dados custam em escala de agente.

Nesta página

Por que agentes de IA e ferramentas de código precisam de uma API do Twitter (X)
Três formas de conectar dados do Twitter (X) a ferramentas de IA
Somente leitura ou acesso de escrita: o que um agente autônomo precisa
A API oficial do X e seu servidor MCP hospedado
Quanto os dados do Twitter (X) custam para um agente de IA
Qual caminho serve a qual ferramenta
Como uma equipe pequena ligou um agente a dados do X ao vivo
Perguntas frequentes
Primeiros passos

Por que agentes de IA e ferramentas de código precisam de uma API do Twitter (X) {#why}

Agentes de IA e ferramentas de código precisam de uma API do Twitter (X) porque um modelo de linguagem não tem acesso ao vivo à plataforma por conta própria: seus dados de treinamento estão congelados, e o X bloqueia scraping não autenticado. Uma API transforma "o que as pessoas estão dizendo sobre isso" em uma chamada estruturada que o modelo pode fazer, receber JSON limpo de volta e raciocinar em cima, sem o modelo inventar uma resposta.

A demanda não é de nicho. Na Pesquisa de Desenvolvedores 2025 do Stack Overflow, com mais de 49.000 desenvolvedores, 84% dos respondentes estão usando ou planejando usar ferramentas de IA no seu processo de desenvolvimento, ante 76% em 2024, e 51% dos desenvolvedores profissionais usam ferramentas de IA todos os dias. Essas ferramentas cada vez mais buscam dados reais fora do próprio contexto, e a conversa social pública é uma das fontes mais pedidas.

Dois leitores distintos aparecem na prática. O primeiro é um agente em tempo de execução: um agente de monitoramento, um assistente de pesquisa, um bot de suporte que precisa checar uma conta pública. O segundo é a própria ferramenta de código em tempo de desenvolvimento, em que o Cursor ou o Claude Code escreve o código de integração e precisa saber os endpoints, a autenticação e os formatos de resposta para acertar as chamadas. Os três caminhos abaixo servem aos dois.

Três formas de conectar dados do Twitter (X) a ferramentas de IA {#three-ways}

Há três formas de dar dados do Twitter (X) a ferramentas de IA: um servidor MCP para clientes de chat, uma skill de agente para ferramentas de código e a API REST chamada diretamente do código gerado. Eles não são concorrentes; servem a ferramentas diferentes, e a mesma chave de API funciona nos três.

Opção 1: um servidor MCP para clientes de chat

Um servidor MCP é o caminho mais rápido para um cliente estilo chat. O Model Context Protocol é um padrão aberto, introduzido pela Anthropic no fim de 2024, que deixa uma aplicação de IA chamar ferramentas externas de forma uniforme. Um servidor MCP expõe um conjunto de ferramentas; o cliente fala o protocolo; o modelo escolhe a ferramenta certa para cada requisição. O servidor MCP da Sorsa embrulha os endpoints de leitura para que qualquer cliente compatível com MCP ganhe ferramentas nativas para buscar tweets e ler perfis, seguidores, respostas, menções e trends.

Ele roda localmente por npx, então não há nada para clonar ou compilar. Aponte-o para a sua chave e reinicie o cliente:

json

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

Esse mesmo bloco funciona no Claude Desktop, no Cursor, no VS Code com GitHub Copilot, no Windsurf e em qualquer outro cliente MCP. O servidor expõe uma ferramenta por endpoint (40 no total), todas somente leitura. O código-fonte do servidor MCP está no GitHub sob licença MIT. Para o passo a passo cliente por cliente, veja o guia dedicado do Servidor MCP do Twitter; esta seção é a versão curta.

Opção 2: uma skill de agente para ferramentas de código

Para agentes de código que constroem e rodam fluxos, uma skill de agente encaixa melhor que uma ferramenta de chat. Uma skill no formato aberto SKILL.md é uma pasta de instruções que um agente lê para aprender uma capacidade: como se autenticar, qual endpoint combina com qual objetivo e como paginar e agrupar em lote. Diferente de um servidor MCP, que o modelo chama em tempo de chat, uma skill ensina um agente de código a escrever o próprio código de API correto e então rodá-lo dentro de um projeto real.

A skill aberta SKILL.md para a Sorsa API funciona com qualquer agente que leia o formato: Claude Code, Cursor, Codex CLI e outros. A instalação manual é uma cópia para o diretório de skills do agente:

bash

git clone https://github.com/Sorsa-io/sorsa-x-api-skill ~/.claude/skills/sorsa-x-api
export SORSA_API_KEY=your_key

Depois disso, um prompt como "pegue os 100 seguidores mais recentes de @elonmusk" ou "busque no X posts populares que mencionam Solana esta semana" já basta. A skill diz ao agente para se autenticar com o cabeçalho ApiKey, escolher o endpoint (/followers para seguidores, /search-tweets para busca) e paginar os resultados. Ela vem com exemplos executáveis em Python e curl mais um pequeno cliente que trata retentativa e paginação, então o agente reaproveita esse código de requisição em vez de reescrevê-lo.

A rota da skill é a que a maioria das páginas de concorrentes pula, e é o encaixe natural para o lado de leitura de um fluxo agêntico: o agente decide quando os dados do X são necessários e os busca por conta própria.

Opção 3: a API REST e a documentação legível por IA para vibe coding

Quando você constrói o app e deixa uma IA escrever a integração, chame a API REST diretamente. Vibe coding, construir software descrevendo-o em linguagem simples, foi a palavra do ano de 2025 do Collins Dictionary, e ferramentas como Cursor, Bolt, Lovable e Replit agora entregam apps funcionais a partir de prompts. O gargalo para qualquer API externa nesse fluxo é se o modelo conhece a API bem o bastante para escrever chamadas corretas.

É isso que a documentação legível por IA resolve. Ao lado da documentação para humanos, a Sorsa publica uma versão legível por IA da documentação: uma referência em texto simples que um agente pode puxar para o contexto e processar sem brigar com HTML ou renderização. Colar ou linkar isso no Cursor ou no Claude Code dá ao modelo a lista de endpoints, os parâmetros e os campos de resposta, então as requisições geradas batem com a API real de primeira.

A API em si continua simples, o que mantém o código gerado curto. Uma consulta de perfil é um GET autenticado:

python

import os, requests

r = requests.get(
    "https://api.sorsa.io/v3/info",
    headers={"ApiKey": os.environ["SORSA_API_KEY"]},
    params={"username": "elonmusk"},
)
r.raise_for_status()
print(r.json()["followers_count"])

A busca é um POST com um corpo JSON que aceita operadores da busca avançada do Twitter pelo endpoint de busca de tweets:

bash

curl -X POST "https://api.sorsa.io/v3/search-tweets" \
  -H "ApiKey: $SORSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "from:elonmusk min_faves:1000", "order": "popular"}'

A partir daí, o endpoint de seguidores retorna até 200 perfis por chamada, os endpoints em lote aceitam até 100 tweets ou perfis por requisição, e a mesma chave cobre tudo. Para uma orientação mais completa, o guia para construir com IA e o início rápido da API percorrem a configuração de ponta a ponta.

Somente leitura ou acesso de escrita: o que um agente autônomo precisa {#read-only}

Para a maioria dos casos de uso de IA, um agente precisa ler dados públicos do X, não escrever em uma conta, e o acesso somente leitura remove uma classe real de risco. Um agente que só lê não pode postar, apagar, seguir ou enviar um DM, não importa o que uma prompt injection em uma resposta raspada mande ele fazer. Essa é uma barreira significativa quando o agente roda sozinho.

Os dados de confiança sustentam a cautela. A mesma pesquisa do Stack Overflow de 2025 encontrou uma diferença acentuada entre uso e confiança: apenas 29% dos respondentes de 2025 disseram confiar na IA, uma queda de 11 pontos percentuais em relação a 2024, e a maior frustração, citada por dois terços dos desenvolvedores, foi a saída de IA que está quase certa, mas não bem. Quando os erros de um agente ficam confinados a leituras, uma ação quase certa retorna dados errados que você consegue pegar, não um post errado em uma conta ao vivo que você não consegue recolher.

Esta é também a ressalva honesta. Se o trabalho do seu agente é publicar, curtir ou enviar DMs, a API oficial do X é o caminho em conformidade para ações de escrita em uma conta de usuário, e nenhum provedor somente leitura a substitui. Algumas APIs de terceiros vendem ações de escrita; essa é uma troca diferente, já que coloca escritas automatizadas em contas reais. A Sorsa é somente leitura por design, o que mantém o uso da API totalmente fora das contas de usuário. Para um agente de leitura intensa, um fixo de 20 requisições por segundo e o preço fixo por requisição importam mais que endpoints de escrita que o agente nunca vai chamar. Para a autenticação por chave única somente leitura, a configuração é uma chave em um cabeçalho, não um fluxo OAuth por usuário.

A API oficial do X e seu servidor MCP hospedado {#official-x}

A API oficial do X é a fonte de primeira parte e, em meados de 2026, ganhou a própria camada MCP. Segundo o anúncio de desenvolvedor do X, a plataforma lançou um servidor MCP hospedado em 30 de junho de 2026, deixando o Grok, o Cursor, o Claude ou qualquer cliente MCP ler e escrever no X pelas credenciais do próprio desenvolvedor, com um servidor MCP separado para a documentação de desenvolvedor. Ele é de primeira parte, com escopo OAuth, e roteia cada chamada pelo plano de API do X da conta.

O porém que apareceu na hora foi o custo. O MCP hospedado não muda o preço; ele fica no modelo de pagamento por uso, então cada chamada de ferramenta cobra por recurso buscado, e observadores apontaram a conta por chamada como a maior surpresa do primeiro dia. Para um agente que dispara muitas leituras, isso soma de uma forma que um plano fixo não.

Para um agente somente leitura, as diferenças que importam são configuração e custo: a API oficial precisa de um app OAuth e cobra por recurso, enquanto um plano fixo somente leitura precisa de uma chave e cobra por requisição.

Eixo	API oficial do X	Sorsa API
Configuração para um agente	app OAuth 2.0, análise, refresh de token por usuário	uma única chave de API no cabeçalho `ApiKey`
Opção de MCP	MCP hospedado de primeira parte (30 de junho de 2026), com escopo OAuth, leitura e escrita	servidor MCP somente leitura, local via `npx`, sem OAuth
Modelo de acesso	paga por recurso buscado	fixo: 1 chamada = 1 requisição
Custo de leitura	US$ 0,005 por post, US$ 0,010 por perfil	a partir de US$ 0,02 por 1.000 tweets, a partir de US$ 0,01 por 1.000 perfis
Ações de escrita	postagem, DMs, rascunhos (caminho em conformidade)	nenhuma (somente leitura por design)
Começo grátis	sem plano gratuito; compre créditos antes	100 requisições grátis, sem cartão

Uma requisição da Sorsa retorna até 100 tweets ou 200 perfis, então os valores por 1.000 usam essa base de lote. As taxas de leitura da API oficial do X seguem o preço de 20 de abril de 2026.

Quanto os dados do Twitter (X) custam para um agente de IA {#cost}

Para um agente de IA de leitura intensa, um plano fixo por requisição é muito mais barato que a cobrança por recurso, porque agentes fazem muitas leituras pequenas e reutilizam os mesmos dados. A API oficial do X cobra por recurso buscado: US$ 0,005 por post lido e US$ 0,010 por usuário lido, então um único tweet retornado com o perfil do autor custa US$ 0,015, ou cerca de US$ 15 por 1.000. Os dados do autor embutidos em um resultado de busca são cobrados como uma leitura de usuário separada.

Um plano fixo inverte isso. Na Sorsa, 1 chamada de API é 1 requisição da sua cota mensal, não importa quantos itens ela retorne, e o perfil do autor dentro de cada resposta de tweet é grátis. Os planos são US$ 49 por mês por 10.000 requisições (Starter), US$ 199 por 100.000 (Pro) e US$ 899 por 500.000 (Enterprise), cada um a 20 requisições por segundo. Em cargas de leitura intensa, isso sai até 50x mais barato que a API oficial assim que o volume passa de cerca de 10.000 leituras de posts por mês.

Leia o número por tweet de duas formas. Uma consulta de IDs em massa pelo /tweet-info-bulk retorna 100 tweets por requisição e cai na base de a partir de US$ 0,02 por 1.000 tweets no Pro. Uma busca interativa pelo /search-tweets retorna cerca de 20 tweets por requisição, então sai mais perto de US$ 0,10 por 1.000 no mesmo plano, já que cada chamada retorna menos itens. Os dois ficam bem abaixo de US$ 15 por 1.000 no modelo por recurso, e nenhum carrega o teto de 2 milhões de leituras de posts por mês da API oficial. Cortar o número de requisições com chamadas em lote é coberto em otimização do uso da API; o preço oficial completo está na análise de preços da API do X em 2026.

Qual caminho serve a qual ferramenta {#which-path}

O caminho certo depende da ferramenta e do trabalho, não de qual é o mais novo. Uma lista curta de decisão:

Claude Desktop, Cursor ou VS Code como cliente de chat: o servidor MCP, já que ele coloca ferramentas de leitura com um bloco de configuração e sem código de cola.

Claude Code, Codex ou Cursor construindo um fluxo: a skill de agente, que ensina ao agente de código os endpoints, a autenticação e a paginação contra os quais ele escreve.

Um app sob medida ou de vibe coding: a API REST chamada do código gerado, com a documentação legível por IA para o modelo escrever requisições corretas.

Um agente que posta, curte ou envia DMs: a API oficial do X, o caminho em conformidade para ações de escrita em uma conta de usuário.

Coleta de dados de alto volume e leitura intensa: um plano fixo da Sorsa, em que 1 chamada é 1 requisição e os perfis de autor vêm de graça dentro das respostas de tweet.

Muitos projetos misturam caminhos: um servidor MCP para exploração enquanto prototipa, e depois a API REST no app entregue. Coletar tweets para treinar ou fazer fine-tuning de um modelo é um fluxo próprio, coberto em montagem de um dataset do Twitter para machine learning.

Como uma equipe pequena ligou um agente a dados do X ao vivo {#case}

Uma equipe pequena de análise social, cerca de cinco pessoas, rodava um agente de rastreamento de menções na API oficial do X e via a conta por recurso subir conforme a cobertura crescia entre mais marcas. Cada menção acompanhada significava uma leitura de post mais uma leitura de usuário para o autor, e o código de refresh de token OAuth tinha de ser mantido separadamente para cada ambiente.

Mover a carga de leitura para um plano fixo e ligar o agente pelo servidor MCP cortou o gasto com dados do Twitter em mais de 90% e deixou que eles apagassem o tratamento de token por ambiente em favor de uma chave em uma variável de ambiente. Como toda ferramenta que o agente podia chamar era somente leitura, uma prompt injection enterrada em uma resposta raspada não conseguia fazê-lo postar ou seguir nada, o que removeu uma etapa de revisão que a equipe tinha adicionado por cautela. O padrão se generaliza para qualquer agente de leitura sempre ligado; a mecânica de polling contínuo está em monitoramento em tempo real com a API REST.

Perguntas frequentes {#faq}

Agentes de IA conseguem acessar dados do Twitter (X) sem uma conta de desenvolvedor?

Sim. Uma API gerenciada de dados do Twitter (X) como a Sorsa precisa apenas de uma chave de API em um cabeçalho ApiKey, sem conta de desenvolvedor do X, fluxo OAuth ou análise de app. Um agente se autentica com uma chave e chama endpoints de leitura para perfis, tweets, busca e seguidores. Contas novas ganham 100 requisições grátis, sem cartão de crédito, então um agente pode puxar dados ao vivo poucos minutos após o cadastro.

Usar o servidor MCP da Sorsa ou a skill de agente para ferramentas de código?

Use o servidor MCP para clientes de chat como Claude Desktop e Cursor, em que o modelo chama ferramentas de leitura diretamente durante uma conversa. Use a skill de agente SKILL.md para agentes de código como Claude Code e Codex que escrevem e rodam código de integração, já que a skill ensina a eles os endpoints, a autenticação e a paginação. Os dois usam a mesma chave de API da Sorsa, e muitos construtores rodam os dois.

Um agente de IA consegue postar tweets pela Sorsa API?

Não. A Sorsa é somente leitura por design e não tem endpoints de escrita, então um agente não pode postar, responder, curtir, seguir ou enviar DMs por ela. Isso é intencional: o acesso somente leitura mantém agentes autônomos fora das contas de usuário. Para ações de escrita em uma conta, a API oficial do X é o caminho em conformidade; a Sorsa cobre o lado de leitura, que é o que a maioria dos fluxos de agente e de ferramenta de código de fato precisa.

Quanto os dados do Twitter (X) custam para um agente de IA?

A API oficial do X cobra por recurso buscado, US$ 0,005 por post e US$ 0,010 por perfil, então um tweet com o autor sai por cerca de US$ 15 por 1.000. A Sorsa usa cobrança fixa por requisição: US$ 49, US$ 199 ou US$ 899 por mês por 10.000, 100.000 ou 500.000 requisições. Consultas em massa caem perto de US$ 0,02 por 1.000 tweets e buscas perto de US$ 0,10 por 1.000, com perfis de autor incluídos de graça.

O que é o servidor MCP oficial do X e como ele é diferente?

O X lançou um servidor MCP hospedado de primeira parte em 30 de junho de 2026, deixando clientes de IA lerem e escreverem no X pelas credenciais OAuth do próprio desenvolvedor, roteadas pelo plano de API do X dele. Ele suporta ações de escrita, o que servidores somente leitura não fazem. A troca é o custo: ele cobra no modelo de pagamento por uso por chamada, enquanto o servidor MCP somente leitura da Sorsa roda localmente e cobra por requisição contra um plano fixo.

Quais ferramentas de código de IA funcionam com a skill do Twitter (X) da Sorsa?

A skill usa o formato aberto SKILL.md, então funciona com qualquer agente que leia esse formato, incluindo Claude Code, Cursor e Codex CLI. O servidor MCP funciona com qualquer cliente compatível com MCP: Claude Desktop, Claude Code, Cursor, VS Code com GitHub Copilot e Windsurf, entre outros. De uma forma ou de outra, a configuração é a mesma configuração padrão e uma chave de API da Sorsa.

Primeiros passos {#getting-started}

Você pode testar os dados antes de escrever qualquer código. Comece no playground do navegador para rodar endpoints por uma interface sem cadastro, depois pegue as 100 requisições grátis para apontar um agente real a dados ao vivo. As 100 requisições são únicas, dispensam cartão de crédito, nunca expiram e cobrem todos os 40 endpoints, o bastante para testar o servidor MCP, a skill ou uma chamada direta de ponta a ponta.

A partir daí, escolha um caminho. Adicione o bloco de configuração MCP para um cliente de chat, clone a skill para um agente de código, ou cole a documentação legível por IA no seu editor e deixe-o escrever a integração. A documentação completa e o limite fixo de 20 requisições por segundo cobrem os detalhes operacionais, e equipes que estão movendo um agente existente da API oficial podem seguir o guia de migração. Se você está pesando provedores primeiro, a comparação de alternativas à API do Twitter expõe as opções com números reais.

Revisado por Keksich, fundador da Sorsa, profissional de marketing e pesquisador da API do X.

Este guia se apoia na operação prática da Sorsa API, nos seus endpoints ao vivo e repositórios públicos de MCP e skill, e na documentação atual da v3. Os números externos foram verificados em 11 de julho de 2026 contra a Pesquisa de Desenvolvedores 2025 do Stack Overflow para adoção e confiança em ferramentas de IA, e contra o próprio anúncio de desenvolvedor do X sobre o servidor MCP hospedado (30 de junho de 2026) e a atualização de preços da API do X de 20 de abril de 2026 para a comparação de custo. A API oficial do X é o ponto de comparação principal em todo o texto.