ScrapeBadger

Accede a datos de Twitter/X, incluidos perfiles de usuario, tweets, seguidores, tendencias, listas y comunidades a través de la API de ScrapeBadger.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de ScrapeBadger

Dale a tus agentes de IA acceso a datos de Twitter/X mediante el Protocolo de Contexto de Modelo

¿Qué es esto?

El servidor MCP de ScrapeBadger es un servidor del Protocolo de Contexto de Modelo (MCP) que permite a asistentes de IA como Claude, ChatGPT, Cursor, Windsurf y otros clientes compatibles con MCP acceder a datos de Twitter/X a través de la API de ScrapeBadger.

Con este servidor MCP, tu IA puede:

Obtener perfiles de usuarios de Twitter, seguidores y listas de seguidos
Buscar y recuperar tweets
Acceder a temas de tendencia globales o por ubicación
Explorar listas y comunidades de Twitter
Buscar lugares y contenido geolocalizado

Inicio rápido

1. Obtén tu clave de API

Regístrate en scrapebadger.com y obtén tu clave de API.

2. Instalación

# 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. Configura tu cliente de IA

Claude Desktop

Añade a tu archivo de configuración de 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

Añade a la configuración de MCP de Cursor (.cursor/mcp.json):

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

Windsurf

Añade a la configuración de MCP de Windsurf:

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

VS Code con Copilot

Añade a la configuración de VS Code (.vscode/mcp.json):

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

4. ¡Empieza a usarlo!

Una vez configurado, simplemente pide a tu IA que obtenga datos de Twitter:

"Obtén el perfil de @elonmusk"

"Busca tweets sobre agentes de IA"

"¿Qué es tendencia en Twitter ahora mismo?"

"Encuentra a los 10 mejores desarrolladores de Python en Twitter"

Herramientas disponibles

El servidor MCP proporciona 17 herramientas organizadas en categorías:

Herramientas de usuario

Herramienta	Descripción
`get_twitter_user_profile`	Obtén el perfil de un usuario por nombre de usuario (biografía, seguidores, seguidos, etc.)
`get_twitter_user_about`	Obtén información ampliada "Acerca de" (ubicación de la cuenta, historial de nombres de usuario)
`search_twitter_users`	Busca usuarios por consulta
`get_twitter_followers`	Obtén los seguidores de un usuario
`get_twitter_following`	Obtén las cuentas que sigue un usuario

Herramientas de tweets

Herramienta	Descripción
`get_twitter_tweet`	Obtén un tweet individual por ID
`get_twitter_user_tweets`	Obtén tweets recientes de un usuario
`search_twitter_tweets`	Busca tweets (admite operadores de búsqueda de Twitter)

Herramientas de tendencias

Herramienta	Descripción
`get_twitter_trends`	Obtén temas de tendencia globales (opcionalmente por categoría)
`get_twitter_place_trends`	Obtén tendencias para una ubicación específica (por WOEID)

Herramientas geo

Herramienta	Descripción
`search_twitter_places`	Busca lugares de Twitter por nombre

Herramientas de listas

Herramienta	Descripción
`get_twitter_list_detail`	Obtén detalles sobre una lista de Twitter
`search_twitter_lists`	Busca listas de Twitter
`get_twitter_list_tweets`	Obtén tweets de una lista

Herramientas de comunidades

Herramienta	Descripción
`get_twitter_community_detail`	Obtén detalles sobre una comunidad de Twitter
`search_twitter_communities`	Busca comunidades

Conversaciones de ejemplo

Investiga una cuenta de Twitter

Tú: Obtén el perfil y los tweets recientes de @sama

Claude: Obtendré el perfil de Twitter de Sam Altman y sus tweets recientes.

Usa get_twitter_user_profile y 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)
...

Monitorea temas de tendencia

Tú: ¿Qué es tendencia en tecnología en Twitter hoy?

Claude: Revisaré los temas de tendencia actuales.

Usa get_twitter_trends con categoría="news"

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

Análisis competitivo

Tú: Compara la interacción en Twitter de Stripe, Square y PayPal

Claude: Recopilaré datos de los perfiles de Twitter de las tres 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%           |

Opciones de configuración

Variables de entorno

Variable	Requerida	Descripción
`SCRAPEBADGER_API_KEY`	Sí	Tu clave de API de ScrapeBadger

Uso con Docker

FROM python:3.12-slim

RUN pip install scrapebadger-mcp

ENV SCRAPEBADGER_API_KEY=your_key_here

CMD ["scrapebadger-mcp"]

Uso directo con Python

# Set your API key
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

# Run the server
python -m scrapebadger_mcp.server

Manejo de errores

El servidor MCP maneja errores comunes de manera elegante:

Error	Descripción	Solución
`AuthenticationError`	Clave de API no válida	Verifica tu `SCRAPEBADGER_API_KEY`
`RateLimitError`	Demasiadas solicitudes	Espera y reintenta, o mejora tu plan
`InsufficientCreditsError`	Sin créditos	Compra más en scrapebadger.com
`NotFoundError`	Usuario/tweet no encontrado	Verifica el nombre de usuario o el ID del tweet

Desarrollo

Configuración

# 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"

Ejecución local

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

# Or use the CLI
uv run scrapebadger-mcp

Pruebas

# Run tests
uv run pytest

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

Calidad del código

# Lint
uv run ruff check src/

# Format
uv run ruff format src/

# Type check
uv run mypy src/

Solución de problemas

"Se requiere la variable de entorno SCRAPEBADGER_API_KEY"

Asegúrate de haber configurado la clave de API en tu configuración de MCP:

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

El servidor no aparece en Claude Desktop

Reinicia Claude Desktop después de cambiar la configuración
Verifica que la ruta del archivo de configuración sea correcta para tu sistema operativo
Verifica que la sintaxis JSON sea válida (sin comas finales)

"uvx: comando no encontrado"

Instala uv primero:

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

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

Errores de límite de velocidad

ScrapeBadger tiene límites de uso según tu plan. Si estás alcanzando los límites:

Reduce la frecuencia de solicitudes
Usa paginación con un max_results más pequeño
Mejora tu plan en scrapebadger.com

Proyectos relacionados

SDK de Python de ScrapeBadger - SDK oficial de Python
SDK de Node.js de ScrapeBadger - SDK oficial de Node.js
Documentación de la API de ScrapeBadger - Documentación completa de la API

Soporte

Documentación: docs.scrapebadger.com
Problemas: Problemas de GitHub
Correo electrónico: support@scrapebadger.com
Discord: Únete a nuestra comunidad

Licencia

Licencia MIT: consulta LICENCIA para más detalles.

Hecho con amor por ScrapeBadger