ScrapeBadger

ScrapeBadger MCP サーバー

Model Context Protocol を通じて、AI エージェントが Twitter/X データにアクセスできるようにします

---

これは何ですか？

ScrapeBadger MCP サーバーは、Claude、ChatGPT、Cursor、Windsurf、その他の MCP 対応クライアントなどの AI アシスタントが、ScrapeBadger API を通じて Twitter/X データにアクセスできるようにする、Model Context Protocol (MCP) サーバーです。

この MCP サーバーを使うと、AI は次のことができます：

• Twitter ユーザーのプロフィール、フォロワー、フォロー中のリストを取得する
• ツイートを検索して取得する
• 世界全体または地域別のトレンドトピックにアクセスする
• Twitter リストやコミュニティを調べる
• 場所や位置情報付きコンテンツを検索する

クイックスタート

1. API キーを取得する

scrapebadger.com で登録し、API キーを取得してください。

2. インストールする

# 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. 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 開発者のトップ 10 を探して」

---

利用可能なツール

この MCP サーバーは、カテゴリ別に整理された 17 個のツールを提供します：

ユーザーツール

ツール	説明
get_twitter_user_profile	ユーザー名でユーザーのプロフィール（自己紹介、フォロワー数、フォロー数など）を取得します
get_twitter_user_about	拡張版の「概要」情報（アカウントの所在地、ユーザー名の履歴）を取得します
search_twitter_users	クエリでユーザーを検索します
get_twitter_followers	ユーザーのフォロワーを取得します
get_twitter_following	ユーザーがフォローしているアカウントを取得します

ツイートツール

ツール	説明
get_twitter_tweet	ID で単一のツイートを取得します
get_twitter_user_tweets	ユーザーの最近のツイートを取得します
search_twitter_tweets	ツイートを検索します（Twitter の検索演算子に対応）

トレンドツール

ツール	説明
get_twitter_trends	世界全体のトレンドトピックを取得します（カテゴリ指定も可能）
get_twitter_place_trends	特定の地域のトレンドを取得します（WOEID を使用）

地理ツール

ツール	説明
search_twitter_places	名前で Twitter の場所を検索します

リストツール

ツール	説明
get_twitter_list_detail	Twitter リストの詳細を取得します
search_twitter_lists	Twitter リストを検索します
get_twitter_list_tweets	リストのツイートを取得します

コミュニティツール

ツール	説明
get_twitter_community_detail	Twitter コミュニティの詳細を取得します
search_twitter_communities	コミュニティを検索します

---

会話例

Twitter アカウントを調査する

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

Claude: Sam Altman の Twitter プロフィールと最近のツイートを取得します。

get_twitter_user_profile と 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)
...

トレンドトピックをモニタリングする

あなた: 今日、Twitter でテクノロジー関連のトレンドになっている話題は何ですか？

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

category="news" を指定して get_twitter_trends を使用

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

競合分析

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

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

各社について get_twitter_user_profile を使用

| Company | Followers | Following | Engagement Rate |
|---------|-----------|-----------|-----------------|
| Stripe  | 892K      | 1,245     | 2.3%           |
| Square  | 1.2M      | 567       | 1.8%           |
| PayPal  | 2.1M      | 234       | 0.9%           |

---

設定オプション

環境変数

変数	必須	説明
SCRAPEBADGER_API_KEY	はい	ScrapeBadger API キー

Docker での使用

FROM python:3.12-slim

RUN pip install scrapebadger-mcp

ENV SCRAPEBADGER_API_KEY=your_key_here

CMD ["scrapebadger-mcp"]

Python を直接使用する

# Set your API key
export SCRAPEBADGER_API_KEY="sb_live_your_key_here"

# Run the server
python -m scrapebadger_mcp.server

---

エラー処理

MCP サーバーは一般的なエラーを適切に処理します。

エラー	説明	解決策
AuthenticationError	API キーが無効です	SCRAPEBADGER_API_KEY を確認してください
RateLimitError	リクエストが多すぎます	時間をおいて再試行するか、プランをアップグレードしてください
InsufficientCreditsError	クレジットが不足しています	scrapebadger.com で追加購入してください
NotFoundError	ユーザー／ツイートが見つかりません	ユーザー名またはツイート ID を確認してください

---

開発

セットアップ

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

ローカルでの実行

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

# Or use the CLI
uv run scrapebadger-mcp

テスト

# Run tests
uv run pytest

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

コード品質

# Lint
uv run ruff check src/

# Format
uv run ruff format src/

# Type check
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 でプランをアップグレードする

---

関連プロジェクト

• ScrapeBadger Python SDK - 公式 Python SDK
• ScrapeBadger Node.js SDK - 公式 Node.js SDK
• ScrapeBadger API Docs - API ドキュメントの全文

---

サポート

• ドキュメント： docs.scrapebadger.com
• 課題： GitHub Issues
• メール： [email protected]
• Discord： コミュニティに参加

---

ライセンス

MIT License — 詳細は LICENSE をご覧ください。

---

ScrapeBadger が心を込めて制作