ScrapeBadger

Acesse dados do Twitter/X, incluindo perfis de usuários, tweets, seguidores, tendências, listas e comunidades, através da API do ScrapeBadger.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP ScrapeBadger

Dê aos seus agentes de IA acesso a dados do Twitter/X por meio do Model Context Protocol

O que é isso?

O Servidor MCP ScrapeBadger é um servidor Model Context Protocol (MCP) que permite que assistentes de IA como Claude, ChatGPT, Cursor, Windsurf e outros clientes compatíveis com MCP acessem dados do Twitter/X por meio da API ScrapeBadger.

Com este servidor MCP, sua IA pode:

Obter perfis de usuários do Twitter, seguidores e listas de seguidos
Pesquisar e recuperar tweets
Acessar tópicos em alta globalmente ou por localização
Explorar listas e comunidades do Twitter
Pesquisar lugares e conteúdo geolocalizado

Início Rápido

1. Obtenha Sua Chave de API

Cadastre-se em scrapebadger.com e obtenha sua chave de API.

2. Instalação

# Using uvx (recommended - no installation needed)
uvx scrapebadger-mcp

# Or install globally with pip
pip install scrapebadger-mcp

# Or with uv
uv tool install scrapebadger-mcp

3. Configure Seu Cliente de IA

Claude Desktop

Adicione ao arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "scrapebadger": {
      "command": "uvx",
      "args": ["scrapebadger-mcp"],
      "env": {
        "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

Cursor

Adicione às configurações MCP do Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "scrapebadger": {
      "command": "uvx",
      "args": ["scrapebadger-mcp"],
      "env": {
        "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

Windsurf

Adicione à configuração MCP do Windsurf:

{
  "mcpServers": {
    "scrapebadger": {
      "command": "uvx",
      "args": ["scrapebadger-mcp"],
      "env": {
        "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

VS Code com Copilot

Adicione às configurações do VS Code (.vscode/mcp.json):

{
  "mcpServers": {
    "scrapebadger": {
      "command": "uvx",
      "args": ["scrapebadger-mcp"],
      "env": {
        "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

4. Comece a Usar!

Após a configuração, basta pedir à sua IA para buscar dados do Twitter:

"Obtenha o perfil de @elonmusk"

"Pesquise tweets sobre agentes de IA"

"O que está em alta no Twitter agora?"

"Encontre os 10 principais desenvolvedores Python no Twitter"

Ferramentas Disponíveis

O servidor MCP fornece 17 ferramentas organizadas em categorias:

Ferramentas de Usuário

Ferramenta	Descrição
`get_twitter_user_profile`	Obtenha o perfil de um usuário pelo nome de usuário (bio, seguidores, seguidos, etc.)
`get_twitter_user_about`	Obtenha informações estendidas "Sobre" (localização da conta, histórico de nome de usuário)
`search_twitter_users`	Pesquise usuários por consulta
`get_twitter_followers`	Obtenha os seguidores de um usuário
`get_twitter_following`	Obtenha as contas que um usuário segue

Ferramentas de Tweet

Ferramenta	Descrição
`get_twitter_tweet`	Obtenha um único tweet por ID
`get_twitter_user_tweets`	Obtenha tweets recentes de um usuário
`search_twitter_tweets`	Pesquise tweets (suporta operadores de pesquisa do Twitter)

Ferramentas de Tendências

Ferramenta	Descrição
`get_twitter_trends`	Obtenha tópicos em alta globalmente (opcionalmente por categoria)
`get_twitter_place_trends`	Obtenha tendências para um local específico (por WOEID)

Ferramentas de Geolocalização

Ferramenta	Descrição
`search_twitter_places`	Pesquise lugares do Twitter por nome

Ferramentas de Listas

Ferramenta	Descrição
`get_twitter_list_detail`	Obtenha detalhes sobre uma lista do Twitter
`search_twitter_lists`	Pesquise listas do Twitter
`get_twitter_list_tweets`	Obtenha tweets de uma lista

Ferramentas de Comunidades

Ferramenta	Descrição
`get_twitter_community_detail`	Obtenha detalhes sobre uma comunidade do Twitter
`search_twitter_communities`	Pesquise comunidades

Exemplos de Conversas

Pesquisar uma Conta do Twitter

Você: Obtenha o perfil e os tweets recentes de @sama

Claude: Vou buscar o perfil do Sam Altman no Twitter e seus tweets recentes.

Usa get_twitter_user_profile e get_twitter_user_tweets

Sam Altman (@sama)
- 3.2M followers, 1,847 following
- Bio: "ceo of openai"
- Joined: December 2008

Recent tweets:
1. "excited to share..." (245K likes)
2. "the future of ai..." (180K likes)
...

Monitorar Tópicos em Alta

Você: O que está em alta em tecnologia no Twitter hoje?

Claude: Vou verificar os tópicos em alta atuais.

Usa get_twitter_trends com categoria="news"

Top Tech Trends:
1. #GPT5 - 125,000 tweets
2. Apple Vision Pro - 89,000 tweets
3. #AGI - 45,000 tweets
...

Análise Competitiva

Você: Compare o engajamento no Twitter de Stripe, Square e PayPal

Claude: Vou coletar dados dos perfis no Twitter das três empresas.

Usa get_twitter_user_profile para cada empresa

| Company | Followers | Following | Engagement Rate |
|---------|-----------|-----------|-----------------|
| Stripe  | 892K      | 1,245     | 2.3%           |
| Square  | 1.2M      | 567       | 1.8%           |
| PayPal  | 2.1M      | 234       | 0.9%           |

Opções de Configuração

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`SCRAPEBADGER_API_KEY`	Sim	Sua chave de API ScrapeBadger

Usando com Docker

FROM python:3.12-slim

RUN pip install scrapebadger-mcp

ENV SCRAPEBADGER_API_KEY=your_key_here

CMD ["scrapebadger-mcp"]

Usando com Python Diretamente

# Set your API key
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

# Run the server
python -m scrapebadger_mcp.server

Tratamento de Erros

O servidor MCP lida com erros comuns de forma elegante:

Erro	Descrição	Solução
`AuthenticationError`	Chave de API inválida	Verifique sua `SCRAPEBADGER_API_KEY`
`RateLimitError`	Muitas solicitações	Aguarde e tente novamente, ou faça upgrade do seu plano
`InsufficientCreditsError`	Sem créditos	Compre mais em scrapebadger.com
`NotFoundError`	Usuário/tweet não encontrado	Verifique o nome de usuário ou o ID do tweet

Desenvolvimento

Configuração

# Clone the repository
git clone https://github.com/scrape-badger/scrapebadger-mcp.git
cd scrapebadger-mcp

# Install dependencies
uv sync --dev

# Set your API key
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

Executando Localmente

# Run the MCP server directly
uv run python -m scrapebadger_mcp.server

# Or use the CLI
uv run scrapebadger-mcp

Testes

# Run tests
uv run pytest

# Run with coverage
uv run pytest --cov=src/scrapebadger_mcp

Qualidade de Código

# Lint
uv run ruff check src/

# Format
uv run ruff format src/

# Type check
uv run mypy src/

Solução de Problemas

"A variável de ambiente SCRAPEBADGER_API_KEY é obrigatória"

Certifique-se de ter definido a chave de API na sua configuração MCP:

{
  "env": {
    "SCRAPEBADGER_API_KEY": "sb_live_your_key_here"
  }
}

Servidor não aparecendo no Claude Desktop

Reinicie o Claude Desktop após alterar a configuração
Verifique se o caminho do arquivo de configuração está correto para o seu sistema operacional
Verifique se a sintaxe JSON é válida (sem vírgulas finais)

"uvx: comando não encontrado"

Instale o uv primeiro:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Erros de limite de taxa

O ScrapeBadger tem limites de uso baseados no seu plano. Se você estiver atingindo os limites:

Reduza a frequência de solicitações
Use paginação com max_results menores
Faça upgrade do seu plano em scrapebadger.com

Projetos Relacionados

SDK Python ScrapeBadger - SDK Python oficial
SDK Node.js ScrapeBadger - SDK Node.js oficial
Documentação da API ScrapeBadger - Documentação completa da API

Suporte

Documentação: docs.scrapebadger.com
Problemas: Issues no GitHub
E-mail: support@scrapebadger.com
Discord: Junte-se à nossa comunidade

Licença

Licença MIT - consulte LICENSE para detalhes.

Feito com amor por ScrapeBadger