Pular para o conteúdo

API e scraper do Twitter (X) para o seu
agente de IA, até 250x mais barata

Deixe seu agente fazer scraping do Twitter (X) sem navegador, sem proxies e sem o seu login do X. Uma linha conecta Claude Code, Cursor, Codex, Grok ou Hermes a ferramentas somente leitura, com tweets a partir de US$ 0,014 por 1.000, em vez de US$ 5,00 na API oficial do X.

Sem cartão de crédito, e elas nunca expiram.

40
Ferramentas somente leitura
Para o seu agente
20req/s
Em todos os planos
Inclusive no início grátis
2022
Em produção desde
Antiga TweetScout API
0
Risco para sua conta do X
Sem login, sem postagens

Conecte seu agente em uma linha.

Copie a linha do seu agente e coloque sua chave no lugar de YOUR_API_KEY. Ele encontra todas as ferramentas sozinho, então basta pedir em linguagem natural.

Depois é só pedir, por exemplo:

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

Rode uma vez. --scope user deixa a Sorsa API disponível em todos os projetos.

Sua chave de APIEla entra no lugar de YOUR_API_KEY. 100 requisições grátis, sem cartão de crédito.
Ganhe 100 requisições grátis

Outros clientes e a lista completa de ferramentas: servidor MCP do Twitter

Ou deixe seu agente escrever o código.

Agentes de código acertam uma API quando a conhecem. Ensine a Sorsa API ao seu uma vez, ou entregue a documentação em um arquivo, e comece com um prompt testado.

1

Ensine a Sorsa API ao seu agente uma vez

Escolha uma forma. A partir daí, toda sessão chama a API da forma certa.

Skill para agentes
npx skills add Sorsa-io/sorsa-x-api-skill -g

Um comando ensina ao Claude Code, ao Cursor, ao Codex, ao Grok, ao Hermes e a mais de 70 agentes os endpoints, os lotes, a paginação e os erros.

Bloco para AGENTS.md
## X (Twitter) data
This project reads public X data through Sorsa API (https://api.sorsa.io/v3).
- Auth: send the key from SORSA_API_KEY in the ApiKey header. Server-side only.
- Docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt (index: https://docs.sorsa.io/llms.txt). Spec: https://api.sorsa.io/v3/swagger.json
- Every call costs 1 request. Use POST /tweet-info-bulk and GET /info-batch for up to 100 items per call.
- Paginate with next_cursor until it is empty. On 429, wait 1 second and retry.

Cole no AGENTS.md ou no CLAUDE.md, e toda sessão nesse repositório chama a Sorsa API da forma certa.

Documentação em um arquivo
https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt

Todos os endpoints, parâmetros e respostas em um arquivo de texto, para qualquer chat ou agente. MCP da documentação para agentes de código: https://docs.sorsa.io/mcp.

2

Depois peça o código

Comece com um prompt testado ou copie um para o seu agente.

Quanto custam as tarefas do seu agente.

Uma chamada de ferramenta é uma requisição, e as ferramentas em lote retornam até 100 posts ou perfis nessa chamada. Escolha uma tarefa para ver o recibo ao lado do que a API oficial do X cobra pelos mesmos dados.

Recibo da tarefa

“Uma sessão de pesquisa: 10 páginas de busca, 100 posts por ID e 50 perfis.”

search_tweets × 10US$ 0,014
get_tweet_info_bulk × 1US$ 0,0014
get_user_info_batch × 1US$ 0,0014
Autores de todos os posts$0.00
Total, a partir deUS$ 0,017
API oficial do X, mesmos dadosUS$ 5,00
300 postsUS$ 1,50
50 perfisUS$ 0,50
Os autores dos postsUS$ 3,00

Obrigado por não pagar a mais

Os planos vão de 10 mil a 10 milhões de requisições por mês, com todos os endpoints e 20 requisições por segundo em todos eles. Veja os preços da Sorsa API.

Segura para entregar a um agente.

Seu agente pode ler qualquer post público. Ele não pode apertar um único botão.

  • Sem login do X.A Sorsa API nunca pede, então não há nada seu para suspender.
  • Só dados públicos.Contas protegidas e DMs continuam fechadas.
  • Você controla a conta.Um plano de preço fixo. O pagamento por uso só roda se você ativar, até o seu limite.
Sua chave de API grátis
100requisições
Até 10 mil tweets ou 20 mil perfis.
•••• •••• •••• 7f3aPronta depois do cadastro
Sem cartão de crédito E elas nunca expiram.
Ganhe 100 requisições grátis

Perguntas sobre IA, respondidas.

Sim. Uma linha dá ao seu agente dados ao vivo do X pelo servidor Sorsa MCP, e mais uma instala a skill da Sorsa API para que ele escreva código correto. Grok Bot, Hermes Agent, Gemini CLI, OpenClaw e qualquer cliente MCP funcionam da mesma forma, e você começa com 100 requisições grátis.

Sim. O servidor Sorsa MCP dá aos agentes de IA 40 ferramentas somente leitura para dados do X: busca até 2006, perfis, seguidores, posts, respostas, quotes, Listas, Comunidades, Spaces, trending topics e verificações de follow, repost, quote e comentário. Ele é instalado com npx -y sorsa-mcp e roda com uma chave da Sorsa API. A configuração de cada cliente está na página do servidor MCP do Twitter.

No Claude Code, rode claude mcp add sorsa --scope user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp. No Claude Desktop, adicione o mesmo servidor a claude_desktop_config.json. Depois é só pedir em linguagem natural, por exemplo: encontre os posts mais curtidos da semana sobre um tema e quem os escreveu.

Não, e é justamente esse o ponto. A Sorsa API é somente leitura por design: nenhum endpoint posta, curte, segue ou envia DMs, então um agente com uma chave da Sorsa API não pode fazer nada disso, seja qual for a instrução. Ela também nunca toca na sua conta do X.

Não. Uma chave da Sorsa API é tudo de que seu agente precisa: sem app de desenvolvedor do X, sem OAuth, sem aprovação. A Sorsa API nunca pede seu login ou cookies do X.

Uma chamada de ferramenta é uma requisição do seu plano, e as ferramentas em lote retornam até 100 posts ou perfis nessa chamada. Os tweets custam a partir de US$ 0,014 por 1.000, até 250x menos que na API oficial do X, e os seguidores, a partir de US$ 0,007. Uma sessão de pesquisa com 10 páginas de busca, 100 posts por ID e 50 perfis custa a partir de US$ 0,017; a API oficial do X cobra US$ 5,00 pelos mesmos dados com autores.

Um plano tem preço fixo e número fixo de requisições, então um agente não consegue aumentar a conta: quando as requisições acabam, as chamadas param. O pagamento por uso só as mantém rodando se você ativar, e, se você definir um limite mensal, nunca o ultrapassa.

https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt: todos os endpoints, parâmetros e respostas em um arquivo de texto. Agentes de código também podem ler o índice em https://docs.sorsa.io/llms.txt, qualquer página da documentação em Markdown, ou buscar na documentação pelo MCP dela em https://docs.sorsa.io/mcp.

Sim. npx skills add Sorsa-io/sorsa-x-api-skill -g instala a skill no Claude Code, no Codex, no Cursor, no Gemini CLI, no Grok, no Hermes Agent, no OpenClaw e em outros. Ela ensina ao seu agente os endpoints, os lotes de 100, a paginação e o tratamento de erros, para que ele escreva a integração corretamente.

Adicione o bloco da Sorsa API ao AGENTS.md ou ao CLAUDE.md do seu projeto. Os agentes de código leem esse arquivo no início de cada sessão, então todos sabem chamar a Sorsa API com a sua chave, agrupar até 100 itens por chamada e paginar com next_cursor.

Sim, com uma chamada para cada: check_follow, check_retweet, check_quoted, check_comment e check_community_member. Uma verificação de repost percorre 100 reposts por requisição e continua com next_cursor em posts maiores.

O X MCP oficial exige seu próprio app de desenvolvedor do X, cobra cada leitura pelos preços do X (US$ 5,00 por 1.000 posts) e, com login pela ponte local, age como a sua conta do X e pode escrever nela. O servidor Sorsa MCP roda com uma chave da Sorsa API, é somente leitura, lê posts a partir de US$ 0,014 por 1.000, até 250x menos, e acrescenta verificações de follow e repost em uma chamada que o X MCP não tem.

O servidor Sorsa MCP tem 40 ferramentas somente leitura contra 12, incluindo verificações de follow, repost, quote, comentário e Comunidade, além de Listas, Comunidades e Spaces. Os tweets custam a partir de US$ 0,014 por 1.000 contra US$ 0,15 na TwitterAPI.io, e a Sorsa API não tem nenhum endpoint de escrita, então a chave que você dá a um agente nunca pode postar.

Sim. Frameworks que falam MCP (OpenAI Agents SDK, LangChain pelos adaptadores MCP, CrewAI, Mastra, Vercel AI SDK) rodam o sorsa-mcp como servidor local. Todo o resto chama a API REST com um header ApiKey, inclusive o nó HTTP Request em um workflow de AI Agent no n8n.

Sim. Toda conta nova recebe 100 requisições grátis, até 10 mil tweets ou 20 mil perfis, sem cartão de crédito, e elas nunca expiram. Elas funcionam em todos os endpoints e em todas as ferramentas.

API e scraper do Twitter (X) para o seu
agente de IA, 250x mais barato

Deixe seu agente fazer scraping do Twitter (X) sem navegador, sem proxies e sem o seu login no X. Ferramentas somente leitura, tweets a partir de US$ 0,014 por 1.000.

40Ferramentas somente leituraPara o seu agente
20req/sEm todos os planosInclusive no início grátis
2022Em produção desdeAntiga TweetScout API
0Risco para sua conta do XSem login, sem postagens

Conecte seu agente em uma linha.

Copie a linha e coloque sua chave no lugar de YOUR_API_KEY.

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

Ou deixe seu agente escrever o código.

Ensine a Sorsa API uma vez. A partir daí, toda sessão a chama da forma certa.

Skill para agentes
npx skills add Sorsa-io/sorsa-x-api-skill -g

Um comando ensina ao Claude Code, ao Cursor, ao Codex, ao Grok, ao Hermes e a mais de 70 agentes os endpoints, os lotes, a paginação e os erros.

Comece por um prompt testado.

Abra um no ChatGPT ou no Claude, ou copie para o seu agente.

Busca para CSV

Usando a Sorsa API (documentação: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt), escreva um script Python que encontre os 500 posts mais curtidos sobre "vector databases" dos últimos 30 dias e salve autor, curtidas, data e link em posts.csv. Leia a chave de API de SORSA_API_KEY e siga next_cursor até ter 500.

Usa /search-tweets. 500 posts com seus autores a partir de US$ 0,035; a API oficial do X cobra US$ 7,50.

Exportar seguidores

Usando a Sorsa API (documentação: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt), exporte todos os seguidores de @YOUR_HANDLE com nome, bio, localização e número de seguidores para followers.csv. /followers retorna 200 por página: leia a chave de SORSA_API_KEY e pagine com next_cursor até ele vir vazio.

Usa /followers. 10 mil seguidores a partir de US$ 0,07; a API oficial do X cobra US$ 100,00.

Enriquecer usernames

Usando a Sorsa API (documentação: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt), adicione seguidores, bio e localização a cada username de handles.csv. Consulte 100 usernames por chamada com /info-batch, leia a chave de SORSA_API_KEY e escreva enriched.csv.

Usa /info-batch. 5.000 perfis a partir de US$ 0,07; a API oficial do X cobra US$ 50,00.

Reidratar IDs

Usando a Sorsa API (documentação: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt), transforme os IDs de tweets de ids.txt em um dataset JSONL com texto, métricas e autor. Envie 100 IDs por chamada para /tweet-info-bulk, leia a chave de SORSA_API_KEY e liste os IDs que não voltaram.

Usa /tweet-info-bulk. 10 mil tweets com seus autores a partir de US$ 0,14; a API oficial do X cobra US$ 150,00.

Alertas de marca

Usando a Sorsa API (documentação: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt), construa um pequeno worker em Node.js que verifique a cada 5 minutos se há novos posts mencionando @YOUR_BRAND com 10 ou mais curtidas e envie cada um para um webhook do Slack. Leia a chave de SORSA_API_KEY e guarde o último post visto.

Usa /mentions. Uma requisição por verificação, 20 requisições por segundo em todos os planos.

Sair da API do X

Migre este código da API oficial do X v2 para a Sorsa API. Leia https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt primeiro. Use a URL base https://api.sorsa.io/v3 e envie a chave de SORSA_API_KEY no header ApiKey em vez de OAuth. Mapeie cada endpoint do X para o endpoint correspondente da Sorsa API, remova expansions porque todo tweet traz o autor em user, e pagine com next_cursor em vez de pagination_token. Mantenha as postagens na API oficial do X.

Mudam um header e alguns caminhos. Tweets a partir de US$ 0,014 por 1.000, em vez de US$ 5,00.

Quanto custam as tarefas do seu agente.

Uma chamada de ferramenta é uma requisição. Toque em uma tarefa para ver o recibo dela ao lado da conta da API oficial do X.

Segura para entregar a um agente.

Chave da Sorsa APISomente leitura

Esta chave pode

  • Busque posts desde 2006
  • Ler perfis, seguidores e seguindo
  • Ler respostas, citações e reposts
  • Ler Listas, Comunidades e Spaces
  • Verificar follows, reposts, quotes e comentários

Esta chave não pode

  • Postar, responder ou citar
  • Curtir ou repostar
  • Seguir ou deixar de seguir
  • Enviar DMs ou ver contas protegidas
  • Usar seu login do X
100requisições
Sua chave de API grátis

Até 10 mil tweets ou 20 mil perfis.

•••• •••• •••• 7f3aPronta depois do cadastro
Sem cartão de créditoE elas nunca expiram.
Ganhe 100 requisições grátis

Perguntas sobre IA, respondidas.