ScrapeBadger MCP Server Give your AI agents access to Twitter/X data via the Model Context Protocol ScrapeBadger MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude, ChatGPT, Cursor, Windsurf, and other MCP-compatible clients to access Twitter/X data through the ScrapeBadger API. With this MCP server, your AI can: - Get Twitter user profiles, followers, and f
Add this skill
npx mdskills install scrape-badger/scrapebadger-mcpComprehensive MCP server providing Twitter data access with 17 well-documented tools and excellent setup guides
1<!-- mcp-name: io.github.scrape-badger/scrapebadger -->23<p align="center">4 <img src="https://scrapebadger.com/logo-dark.png" alt="ScrapeBadger" width="400">5</p>67<h1 align="center">ScrapeBadger MCP Server</h1>89<p align="center">10 <a href="https://pypi.org/project/scrapebadger-mcp/"><img src="https://img.shields.io/pypi/v/scrapebadger-mcp.svg" alt="PyPI version"></a>11 <a href="https://pypi.org/project/scrapebadger-mcp/"><img src="https://img.shields.io/pypi/pyversions/scrapebadger-mcp.svg" alt="Python versions"></a>12 <a href="https://github.com/scrape-badger/scrapebadger-mcp/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/scrapebadger-mcp.svg" alt="License"></a>13 <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Compatible-blue" alt="MCP Compatible"></a>14</p>1516<p align="center">17 <strong>Give your AI agents access to Twitter/X data via the Model Context Protocol</strong>18</p>1920---2122## What is this?2324ScrapeBadger MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables AI assistants like **Claude**, **ChatGPT**, **Cursor**, **Windsurf**, and other MCP-compatible clients to access Twitter/X data through the [ScrapeBadger API](https://scrapebadger.com).2526**With this MCP server, your AI can:**2728- Get Twitter user profiles, followers, and following lists29- Search and retrieve tweets30- Access trending topics globally or by location31- Explore Twitter lists and communities32- Search for places and geolocated content3334## Quick Start3536### 1. Get Your API Key3738Sign up at [scrapebadger.com](https://scrapebadger.com) and get your API key.3940### 2. Install4142```bash43# Using uvx (recommended - no installation needed)44uvx scrapebadger-mcp4546# Or install globally with pip47pip install scrapebadger-mcp4849# Or with uv50uv tool install scrapebadger-mcp51```5253### 3. Configure Your AI Client5455#### Claude Desktop5657Add to your Claude Desktop configuration file:5859**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`60**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`6162```json63{64 "mcpServers": {65 "scrapebadger": {66 "command": "uvx",67 "args": ["scrapebadger-mcp"],68 "env": {69 "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"70 }71 }72 }73}74```7576#### Cursor7778Add to your Cursor MCP settings (`.cursor/mcp.json`):7980```json81{82 "mcpServers": {83 "scrapebadger": {84 "command": "uvx",85 "args": ["scrapebadger-mcp"],86 "env": {87 "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"88 }89 }90 }91}92```9394#### Windsurf9596Add to your Windsurf MCP configuration:9798```json99{100 "mcpServers": {101 "scrapebadger": {102 "command": "uvx",103 "args": ["scrapebadger-mcp"],104 "env": {105 "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"106 }107 }108 }109}110```111112#### VS Code with Copilot113114Add to your VS Code settings (`.vscode/mcp.json`):115116```json117{118 "mcpServers": {119 "scrapebadger": {120 "command": "uvx",121 "args": ["scrapebadger-mcp"],122 "env": {123 "SCRAPEBADGER_API_KEY": "sb_live_your_api_key_here"124 }125 }126 }127}128```129130### 4. Start Using It!131132Once configured, simply ask your AI to fetch Twitter data:133134> "Get the profile of @elonmusk"135136> "Search for tweets about AI agents"137138> "What's trending on Twitter right now?"139140> "Find the top 10 Python developers on Twitter"141142---143144## Available Tools145146The MCP server provides 17 tools organized into categories:147148### User Tools149150| Tool | Description |151|------|-------------|152| `get_twitter_user_profile` | Get a user's profile by username (bio, followers, following, etc.) |153| `get_twitter_user_about` | Get extended "About" info (account location, username history) |154| `search_twitter_users` | Search for users by query |155| `get_twitter_followers` | Get a user's followers |156| `get_twitter_following` | Get accounts a user follows |157158### Tweet Tools159160| Tool | Description |161|------|-------------|162| `get_twitter_tweet` | Get a single tweet by ID |163| `get_twitter_user_tweets` | Get recent tweets from a user |164| `search_twitter_tweets` | Search for tweets (supports Twitter search operators) |165166### Trend Tools167168| Tool | Description |169|------|-------------|170| `get_twitter_trends` | Get global trending topics (optionally by category) |171| `get_twitter_place_trends` | Get trends for a specific location (by WOEID) |172173### Geo Tools174175| Tool | Description |176|------|-------------|177| `search_twitter_places` | Search for Twitter places by name |178179### List Tools180181| Tool | Description |182|------|-------------|183| `get_twitter_list_detail` | Get details about a Twitter list |184| `search_twitter_lists` | Search for Twitter lists |185| `get_twitter_list_tweets` | Get tweets from a list |186187### Community Tools188189| Tool | Description |190|------|-------------|191| `get_twitter_community_detail` | Get details about a Twitter community |192| `search_twitter_communities` | Search for communities |193194---195196## Example Conversations197198### Research a Twitter Account199200**You:** Get the profile and recent tweets from @sama201202**Claude:** I'll fetch Sam Altman's Twitter profile and recent tweets.203204*Uses `get_twitter_user_profile` and `get_twitter_user_tweets`*205206```207Sam Altman (@sama)208- 3.2M followers, 1,847 following209- Bio: "ceo of openai"210- Joined: December 2008211212Recent tweets:2131. "excited to share..." (245K likes)2142. "the future of ai..." (180K likes)215...216```217218### Monitor Trending Topics219220**You:** What's trending in tech on Twitter today?221222**Claude:** I'll check the current trending topics.223224*Uses `get_twitter_trends` with category="news"*225226```227Top Tech Trends:2281. #GPT5 - 125,000 tweets2292. Apple Vision Pro - 89,000 tweets2303. #AGI - 45,000 tweets231...232```233234### Competitive Analysis235236**You:** Compare the Twitter engagement of Stripe, Square, and PayPal237238**Claude:** I'll gather data on all three companies' Twitter profiles.239240*Uses `get_twitter_user_profile` for each company*241242```243| Company | Followers | Following | Engagement Rate |244|---------|-----------|-----------|-----------------|245| Stripe | 892K | 1,245 | 2.3% |246| Square | 1.2M | 567 | 1.8% |247| PayPal | 2.1M | 234 | 0.9% |248```249250---251252## Configuration Options253254### Environment Variables255256| Variable | Required | Description |257|----------|----------|-------------|258| `SCRAPEBADGER_API_KEY` | Yes | Your ScrapeBadger API key |259260### Using with Docker261262```dockerfile263FROM python:3.12-slim264265RUN pip install scrapebadger-mcp266267ENV SCRAPEBADGER_API_KEY=your_key_here268269CMD ["scrapebadger-mcp"]270```271272### Using with Python Directly273274```bash275# Set your API key276export SCRAPEBADGER_API_KEY="sb_live_your_key_here"277278# Run the server279python -m scrapebadger_mcp.server280```281282---283284## Error Handling285286The MCP server handles common errors gracefully:287288| Error | Description | Solution |289|-------|-------------|----------|290| `AuthenticationError` | Invalid API key | Check your `SCRAPEBADGER_API_KEY` |291| `RateLimitError` | Too many requests | Wait and retry, or upgrade your plan |292| `InsufficientCreditsError` | Out of credits | Purchase more at scrapebadger.com |293| `NotFoundError` | User/tweet not found | Verify the username or tweet ID |294295---296297## Development298299### Setup300301```bash302# Clone the repository303git clone https://github.com/scrape-badger/scrapebadger-mcp.git304cd scrapebadger-mcp305306# Install dependencies307uv sync --dev308309# Set your API key310export SCRAPEBADGER_API_KEY="sb_live_your_key_here"311```312313### Running Locally314315```bash316# Run the MCP server directly317uv run python -m scrapebadger_mcp.server318319# Or use the CLI320uv run scrapebadger-mcp321```322323### Testing324325```bash326# Run tests327uv run pytest328329# Run with coverage330uv run pytest --cov=src/scrapebadger_mcp331```332333### Code Quality334335```bash336# Lint337uv run ruff check src/338339# Format340uv run ruff format src/341342# Type check343uv run mypy src/344```345346---347348## Troubleshooting349350### "SCRAPEBADGER_API_KEY environment variable is required"351352Make sure you've set the API key in your MCP configuration:353354```json355{356 "env": {357 "SCRAPEBADGER_API_KEY": "sb_live_your_key_here"358 }359}360```361362### Server not showing in Claude Desktop3633641. Restart Claude Desktop after changing the config3652. Check the config file path is correct for your OS3663. Verify JSON syntax is valid (no trailing commas)367368### "uvx: command not found"369370Install `uv` first:371372```bash373# macOS/Linux374curl -LsSf https://astral.sh/uv/install.sh | sh375376# Windows377powershell -c "irm https://astral.sh/uv/install.ps1 | iex"378```379380### Rate limit errors381382ScrapeBadger has usage limits based on your plan. If you're hitting limits:3833841. Reduce request frequency3852. Use pagination with smaller `max_results`3863. Upgrade your plan at [scrapebadger.com](https://scrapebadger.com)387388---389390## Related Projects391392- [ScrapeBadger Python SDK](https://github.com/scrape-badger/scrapebadger-python) - Official Python SDK393- [ScrapeBadger Node.js SDK](https://github.com/scrape-badger/scrapebadger-node) - Official Node.js SDK394- [ScrapeBadger API Docs](https://docs.scrapebadger.com) - Full API documentation395396---397398## Support399400- **Documentation:** [docs.scrapebadger.com](https://docs.scrapebadger.com)401- **Issues:** [GitHub Issues](https://github.com/scrape-badger/scrapebadger-mcp/issues)402- **Email:** support@scrapebadger.com403- **Discord:** [Join our community](https://discord.gg/scrapebadger)404405---406407## License408409MIT License - see [LICENSE](LICENSE) for details.410411---412413<p align="center">414 Made with love by <a href="https://scrapebadger.com">ScrapeBadger</a>415</p>416
Full transparency — inspect the skill content before installing.