Scrapebadger MCP

🚀 ScrapeBadger MCP 服務器

ScrapeBadger MCP 服務器可讓 AI 助手（如 Claude、ChatGPT 等）通過 Model Context Protocol 訪問 Twitter/X 數據，為 AI 代理提供強大的數據支持。

🚀 快速開始

1. 獲取 API 密鑰

在 scrapebadger.com 上註冊並獲取 API 密鑰。

2. 安裝

# 使用 uvx（推薦 - 無需安裝）
uvx scrapebadger-mcp

# 或者使用 pip 全局安裝
pip install scrapebadger-mcp

# 或者使用 uv 安裝
uv tool install scrapebadger-mcp

3. 配置 AI 客戶端

Claude Desktop

將以下內容添加到 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

將以下內容添加到 Cursor MCP 設置（.cursor/mcp.json）中：

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

Windsurf

將以下內容添加到 Windsurf MCP 配置中：

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

帶有 Copilot 的 VS Code

將以下內容添加到 VS Code 設置（.vscode/mcp.json）中：

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

4. 開始使用！

配置完成後，只需讓你的 AI 獲取 Twitter 數據即可，例如：

• "獲取 @elonmusk 的個人資料"
• "搜索關於 AI 代理的推文"
• "當前 Twitter 上有哪些熱門話題？"
• "查找 Twitter 上排名前十的 Python 開發者"

✨ 主要特性

ScrapeBadger MCP 服務器使 AI 能夠：

• 獲取 Twitter 用戶資料、關注者和關注列表
• 搜索和檢索推文
• 訪問全球或特定地區的熱門話題
• 探索 Twitter 列表和社區
• 搜索地點和地理位置相關內容

📦 安裝指南

環境變量

使用 Docker

FROM python:3.12-slim

RUN pip install scrapebadger-mcp

ENV SCRAPEBADGER_API_KEY=your_key_here

CMD ["scrapebadger-mcp"]

直接使用 Python

# 設置你的 API 密鑰
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

# 運行服務器
python -m scrapebadger_mcp.server

💻 使用示例

研究 Twitter 賬戶

你：獲取 @sama 的個人資料和近期推文 Claude：我將獲取 Sam Altman 的 Twitter 個人資料和近期推文。 使用 get_twitter_user_profile 和 get_twitter_user_tweets

Sam Altman (@sama)
- 320 萬關注者，1847 個關注對象
- 簡介："openai 首席執行官"
- 加入時間：2008 年 12 月

近期推文：
1. "很高興分享..."（24.5 萬點贊）
2. "人工智能的未來..."（18 萬點贊）
...

監控熱門話題

你：今天 Twitter 上科技領域有哪些熱門話題？ Claude：我將查看當前的熱門話題。 使用 get_twitter_trends 並指定類別為 "news"

頂級科技熱門話題：
1. #GPT5 - 12.5 萬條推文
2. Apple Vision Pro - 8.9 萬條推文
3. #AGI - 4.5 萬條推文
...

競爭分析

你：比較 Stripe、Square 和 PayPal 在 Twitter 上的參與度 Claude：我將收集這三家公司的 Twitter 個人資料數據。 為每家公司使用 get_twitter_user_profile

| 公司 | 關注者 | 關注對象 | 參與率 |
|---------|-----------|-----------|-----------------|
| Stripe  | 89.2 萬 | 1245 | 2.3% |
| Square  | 120 萬 | 567 | 1.8% |
| PayPal  | 210 萬 | 234 | 0.9% |

📚 詳細文檔

可用工具

MCP 服務器提供 17 種工具，分為以下幾類：

用戶工具

推文工具

熱門話題工具

地理位置工具

列表工具

社區工具

配置選項

環境變量

使用 Docker

FROM python:3.12-slim

RUN pip install scrapebadger-mcp

ENV SCRAPEBADGER_API_KEY=your_key_here

CMD ["scrapebadger-mcp"]

直接使用 Python

# 設置你的 API 密鑰
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

# 運行服務器
python -m scrapebadger_mcp.server

錯誤處理

MCP 服務器能夠優雅地處理常見錯誤：

開發

環境搭建

# 克隆倉庫
git clone https://github.com/scrape-badger/scrapebadger-mcp.git
cd scrapebadger-mcp

# 安裝依賴
uv sync --dev

# 設置你的 API 密鑰
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

本地運行

# 直接運行 MCP 服務器
uv run python -m scrapebadger_mcp.server

# 或者使用 CLI
uv run scrapebadger-mcp

測試

# 運行測試
uv run pytest

# 運行並查看覆蓋率
uv run pytest --cov=src/scrapebadger_mcp

代碼質量

# 代碼檢查
uv run ruff check src/

# 代碼格式化
uv run ruff format src/

# 類型檢查
uv run mypy src/

故障排除

"SCRAPEBADGER_API_KEY 環境變量是必需的"

確保你已在 MCP 配置中設置了 API 密鑰：

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

Claude Desktop 中未顯示服務器

1. 修改配置後重啟 Claude Desktop
2. 檢查配置文件路徑是否適用於你的操作系統
3. 驗證 JSON 語法是否有效（無尾隨逗號）

"uvx: command not found"

先安裝 uv：

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

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

速率限制錯誤

ScrapeBadger 根據你的計劃設置了使用限制。如果你遇到限制：

1. 降低請求頻率
2. 使用分頁並設置較小的 max_results
3. 在 scrapebadger.com 上升級你的計劃

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

相關項目

• ScrapeBadger Python SDK - 官方 Python SDK
• ScrapeBadger Node.js SDK - 官方 Node.js SDK
• ScrapeBadger API 文檔 - 完整的 API 文檔

支持

• 文檔：docs.scrapebadger.com
• 問題反饋：GitHub Issues
• 郵箱：support@scrapebadger.com
• Discord：加入我們的社區

由 ScrapeBadger 用心打造