Taobaoscraper Mcp Server

TaobaoScraper MCP サーバー

Taobao/Tmall および JD.com（Jingdong）から商品データをスクレイピングするための MCP（Model Context Protocol）サーバーです。Claude Desktop または Claude Code から直接使用できる 8 つのツールを提供します。

プラットフォーム：Windows（Chrome ブラウザーが必要です） 言語：Python 3.10+

特長

• マルチプラットフォームのスクレイピング - 1 つのツールで Taobao、Tmall、JD.com に対応
• 8 つの MCP ツール - スクレイピング、タスク管理、通知、システム制御
• ホット検索ワード - トレンドのキーワードと市場のインサイトを発見
• Excel エクスポート - 結果を .xlsx ファイルとして自動保存
• 通知の送信 - WeChat（ServerChan / PushPlus）およびメールで通知
• 2 種類のトランスポート - stdio（ローカル）および SSE（リモート）プロトコル
• 3 言語対応の GUI - 中国語／英語／韓国語のインターフェース（任意）

アーキテクチャ

Claude Desktop / Claude Code
        |
   MCP Server (stdio or SSE)
        |
   FastAPI Backend (:8000)
        |
   Selenium + Chrome (:9222)

クイックスタート

1. 前提条件

• Python 3.10+
• Google Chrome ブラウザー
• Windows OS

2. インストール

git clone https://github.com/jhongjun1981/taobao-scraper-mcp.git
cd taobao-scraper-mcp

# Install MCP server dependencies
pip install -r requirements_mcp.txt

# Install API backend dependencies
pip install -r requirements_api.txt

3. 設定

cp .env.example .env
# Edit .env to set your SCRAPER_API_KEY

4. デバッグポートを指定して Chrome を起動

# Close all Chrome instances first, then:
START_GUI.bat
# Or manually:
chrome.exe --remote-debugging-port=9222 --user-data-dir="%LOCALAPPDATA%\Google\Chrome\Debug Profile"

5. Taobao にログイン（初回のみ）

Chrome を開き、Taobao アカウントにログインします。Cookie はデバッグプロファイルに保持されます。

6. API バックエンドを起動

python run_api.py

7. MCP サーバーを設定

Claude Code の場合 - .claude/settings.json に追加します。

{
  "mcpServers": {
    "taobao-scraper": {
      "command": "python",
      "args": ["run_mcp.py"],
      "cwd": "/path/to/taobao-scraper-mcp"
    }
  }
}

Claude Desktop の場合 - claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "taobao-scraper": {
      "command": "python",
      "args": ["run_mcp.py"],
      "cwd": "C:\\path\\to\\taobao-scraper-mcp"
    }
  }
}

SSE モード（リモート）の場合：

python run_mcp.py --transport sse --port 8001

{
  "mcpServers": {
    "taobao-scraper": {
      "type": "sse",
      "url": "http://your-server:8001/sse"
    }
  }
}

ツールリファレンス

スクレイピングツール

scrape_products

EC プラットフォームから商品データをスクレイピングします。

パラメーター	型	デフォルト	説明
keyword	string	必須	検索キーワード
platform	string	"taobao"	"taobao" / "jd" / "multi"
pages	int	3	スクレイピングするページ数
sort_by	string	"sale"	並べ替え方法
tmall_only	bool	false	Tmall の商品のみ
exact_match	bool	false	キーワードの完全一致
price_min	float	0	最低価格のフィルター
price_max	float	0	最高価格のフィルター
wait_for_result	bool	true	完了まで待機
timeout	int	300	タイムアウト（秒）

例：「Taobao と JD の両方からランニングシューズをスクレイピング」

scrape_hotwords

市場分析用に、トレンドまたは関連する検索キーワードをスクレイピングします。

パラメーター	型	デフォルト	説明
keyword	string	必須	基本キーワード
wait_for_result	bool	true	完了まで待機
timeout	int	120	タイムアウト（秒）

タスク管理ツール

list_tasks

最近のスクレイピングタスクをステータス（pending／running／completed／failed）とともに一覧表示します。

パラメーター	型	デフォルト	説明
limit	int	20	返すタスクの最大数

get_task

特定のタスクの詳細なステータスを取得します。完全な結果を取得するには、include_result=true を設定します。

パラメーター	型	デフォルト	説明
task_id	string	必須	タスク ID
include_result	bool	false	結果データを含める

cancel_task

実行中または保留中のタスクをキャンセルします。

パラメーター	型	デフォルト	説明
task_id	string	必須	キャンセルするタスクの ID

エクスポートツール

list_files

エクスポートされた Excel データファイルを、ファイル名、サイズ、更新日時とともにすべて一覧表示します。

通知ツール

send_notification

WeChat またはメールでプッシュ通知を送信します。

パラメーター	型	デフォルト	説明
channel	string	必須	"wechat" / "email" / "test"
title	string	""	通知のタイトル
content	string	""	通知本文
wx_type	string	"server_chan"	"server_chan" または "pushplus"

システムツール

system_status

システムの状態を確認するか、Chrome を再起動します。

Parameter	Type	Default	Description
action	string	"check"	"check" または "restart_chrome"

環境変数

Variable	Default	Description
SCRAPER_API_KEY	changeme-your-secret-key	API 認証キー
SCRAPER_API_URL	http://localhost:8000	FastAPI バックエンド URL
SCRAPER_CHROME_PORT	9222	Chrome デバッグポート
MCP_SSE_HOST	0.0.0.0	SSE リッスンアドレス
MCP_SSE_PORT	8001	SSE リッスンポート
MCP_HTTP_TIMEOUT	30	HTTP リクエストのタイムアウト

データ出力

スクレイピングしたデータは、以下の内容を含む Excel ファイルとして自動的に保存されます。

• 商品タイトル、画像 URL、価格
• 月間販売数量、レビュー数
• ショップ名、ショップの種類、ショップの地域
• 商品 URL、スクレイピング日時

重要な注意事項

• Taobao ではログインが必要です - まず Chrome でご自身の Taobao アカウントにログインしてください
• JD はログイン不要です - JD のスクレイピングには認証は必要ありません
• 一度に実行できるタスクは 1 つです - Chrome は同時に 1 つのスクレイピングタスクしか処理できません
• Windows 専用です - Chrome の自動化レイヤーでは Windows 固有の API を使用します
• レート制限を守ってください - 過度なスクレイピングはボット対策による保護を引き起こす可能性があります

ライセンス

MIT License - LICENSE ファイルをご覧ください。