ScrapeBadger MCP Server 是一个 Model Context Protocol(MCP)服务器,用于让 AI 助手访问 Twitter/X 数据。它通过 ScrapeBadger API 为 Claude、ChatGPT、Cursor、Windsurf 以及其他兼容 MCP 的客户端提供数据接入能力。项目托管在 GitHub,采用 MIT 许可证。
用途 借助该 MCP 服务器,AI 可以获取 Twitter 用户资料、关注者和正在关注列表;搜索和检索推文;访问全球或按位置的趋势话题;探索 Twitter 列表和社区;搜索地点和地理定位内容。
主要能力 服务器共提供 17 个工具,并按类别组织,其中包括社区工具(Community Tools)。官方给出的对话示例包括:研究某个 Twitter 账号(如获取 @sama 的资料和近期推文,使用 get_twitter_user_profile 与 get_twitter_user_tweets);监控趋势话题(如查看当前科技类趋势,使用 get_twitter_trends 并设置 category="news");竞品分析(如比较 Stripe、Square、PayPal 的 Twitter 互动情况,对每家公司使用 get_twitter_user_profile)。
使用方式 首先在 scrapebadger.com 注册并获取 API Key。然后配置 AI 客户端:Claude Desktop 的配置文件位于 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json;Cursor 使用 .cursor/mcp.json;Windsurf 使用其 MCP 配置;VS Code 使用 .vscode/mcp.json。配置完成后即可让 AI 抓取 Twitter 数据,例如“Get the profile of @elonmusk”“Search for tweets about AI agents”“What's trending on Twitter right now?”或“Find the top 10 Python developers on Twitter”。项目还说明支持通过 Docker 使用、直接使用 Python 运行,以及本地运行方式;环境变量方面需要设置 SCRAPEBADGER_API_KEY。
适用场景 适用于需要让 AI 助手实时查询 Twitter/X 公开数据的场景,例如账号研究、趋势监控、竞品分析等。
限制与注意事项 使用前必须拥有 ScrapeBadger API Key;SCRAPEBADGER_API_KEY 是必需的环境变量。ScrapeBadger 根据套餐设有使用限制,若触发速率限制,可降低请求频率、使用分页并设置更小的 max_results,或在 scrapebadger.com 升级套餐。常见问题包括 API Key 未设置、Claude Desktop 中服务器不显示(需重启并检查配置路径与 JSON 格式)、uvx 命令未找到(需先安装 uv)。官方还提及相关项目:ScrapeBadger Python SDK、Node.js SDK、API 文档、文档站点 docs.scrapebadger.com、GitHub Issues、支持邮箱 support@scrapebadger.com 以及 Discord 社区。