Scrapebadger MCP

🚀 ScrapeBadger MCP Server

ScrapeBadger MCP Serverは、Model Context Protocol (MCP) サーバーです。このサーバーを使用すると、Claude、ChatGPT、Cursor、Windsurf などのMCP互換クライアントが ScrapeBadger API を通じてTwitter/Xのデータにアクセスできます。

🚀 クイックスタート

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

VS Code with Copilot

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上のトップ10のPython開発者を見つけて"

✨ 主な機能

MCPサーバーは、17のツールをカテゴリ別に提供しています。

ユーザーツール

ツイートツール

トレンドツール

地理ツール

リストツール

コミュニティツール

💻 使用例

Twitterアカウントの調査

あなた: @samaのプロフィールと最近のツイートを取得して

Claude: サム・アルトマンのTwitterプロフィールと最近のツイートを取得します。

get_twitter_user_profile と get_twitter_user_tweets を使用

Sam Altman (@sama)
- 320万人のフォロワー、1,847人をフォロー中
- 自己紹介: "ceo of openai"
- 加入日: 2008年12月

最近のツイート:
1. "excited to share..." (245,000いいね)
2. "the future of ai..." (180,000いいね)
...

トレンドトピックの監視

あなた: 今日Twitterでテクノロジー分野でトレンドになっているものは何ですか？

Claude: 現在のトレンドトピックを確認します。

get_twitter_trends をカテゴリ="news"で使用

トップテクノロジートレンド:
1. #GPT5 - 125,000ツイート
2. Apple Vision Pro - 89,000ツイート
3. #AGI - 45,000ツイート
...

競争分析

あなた: Stripe、Square、PayPalのTwitterのエンゲージメントを比較して

Claude: 3社のTwitterプロフィールに関するデータを収集します。

各社に対して get_twitter_user_profile を使用

| 会社 | フォロワー | フォロー中 | エンゲージメント率 |
|---------|-----------|-----------|-----------------|
| Stripe  | 892,000    | 1,245     | 2.3%           |
| Square  | 120万人    | 567       | 1.8%           |
| PayPal  | 210万人    | 234       | 0.9%           |

📚 詳細ドキュメント

環境変数

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. 設定ファイルのパスがOSに適していることを確認してください。
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 Docs - 完全なAPIドキュメント

サポート

• ドキュメント: docs.scrapebadger.com
• 問題報告: GitHub Issues
• メール: support@scrapebadger.com
• Discord: コミュニティに参加

ScrapeBadgerによって愛を込めて作成されました。