JD-Taobao Browser MCP
一个本地运行、人工参与的 MCP Server。它通过 Playwright 打开真实、可见的 Chromium 浏览器,让 Codex 或其他 MCP 客户端在京东、淘宝、天猫页面中进行低频浏览、商品搜索、详情提取和截图。
本项目默认只读。用户必须自己完成扫码、密码、验证码、滑块和安全验证;工具不会绕过平台风控,也不会自动购买、加购、结算或支付。
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
一个本地运行、人工参与的 MCP Server。它通过 Playwright 打开真实、可见的 Chromium 浏览器,让 Codex 或其他 MCP 客户端在京东、淘宝、天猫页面中进行低频浏览、商品搜索、详情提取和截图。
本项目默认只读。用户必须自己完成扫码、密码、验证码、滑块和安全验证;工具不会绕过平台风控,也不会自动购买、加购、结算或支付。
这是一个基于 Python 与 Playwright 开发的电商网页自动化 MCP Server,主要用于模拟用户在京东、淘宝等电商平台上的浏览和操作,并将网页信息以结构化数据形式提供给大模型或智能体调用。 项目支持商品搜索、商品列表读取、详情页访问、商品参数提取、价格与店铺信息获取、部分用户评价整理、页面截图及链接返回等功能。MCP Server 负责接收智能体指令,调用本地浏览器完成页面操作,返回支持 MCP 协议的客户端。
product_url、product_parameters、good_reviews、bad_reviews 及对应 status 字段;good_reviews 最多 5 条,bad_reviews 最多 2 条。*.jd.com、*.360buy.com、*.taobao.com、*.tmall.com。JD-Taobao-MCP/
├─ server.py MCP 工具入口
├─ jd_taobao_mcp/
│ ├─ browser.py Playwright 持久化浏览器与通用操作
│ ├─ service.py 搜索和详情页流程
│ ├─ safety.py 域名、敏感输入与交易动作防护
│ └─ extractors/ 京东/淘宝页面提取器
├─ config_examples/
│ ├─ codex-config.toml Codex 配置示例
│ └─ mcp-client.json Cursor、Claude Desktop 等配置示例
├─ scripts/
│ ├─ install_windows.ps1 Windows 安装脚本
│ └─ start_windows.bat Windows 启动脚本
├─ .env.example 环境变量示例
├─ pyproject.toml Python 包配置
└─ README.md 项目主页文档
要求:
在 PowerShell 中执行:
git clone https://github.com/HaonanYu123/JD-Taobao-MCP.git
cd JD-Taobao-MCP
Set-ExecutionPolicy -Scope Process Bypass
.\scripts\install_windows.ps1
脚本会完成:
.venv.env.example 为 .env.ms-playwright手动安装:
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U pip
.\.venv\Scripts\python.exe -m pip install -e "."
.\.venv\Scripts\python.exe -m playwright install chromium
copy .env.example .env
本地启动测试:
.\.venv\Scripts\python.exe server.py
如果服务进入等待状态,没有立即退出,说明 MCP stdio 服务可以被客户端拉起。按 Ctrl+C 退出。
Codex 的 MCP 配置文件通常位于:
%USERPROFILE%\.codex\config.toml
把下面配置追加到 config.toml,并把 <PROJECT_DIR> 替换为本仓库的绝对路径,例如:
C:\Users\你的用户名\Desktop\JD-Taobao-MCP
[mcp_servers.jd_taobao_browser]
command = "<PROJECT_DIR>/.venv/Scripts/python.exe"
args = ["<PROJECT_DIR>/server.py"]
cwd = "<PROJECT_DIR>"
enabled = true
required = false
startup_timeout_sec = 30
tool_timeout_sec = 120
default_tools_approval_mode = "prompt"
[mcp_servers.jd_taobao_browser.env]
PLAYWRIGHT_HEADLESS = "false"
ALLOW_STATE_CHANGING_ACTIONS = "false"
PLAYWRIGHT_BROWSERS_PATH = ".ms-playwright"
BROWSER_PROFILE_DIR = ".tmp/browser-profile"
ARTIFACTS_DIR = "artifacts"
TAOBAO_SEARCH_MODE = "mobile"
也可以用命令添加:
codex mcp add jd-taobao-browser --env PLAYWRIGHT_HEADLESS=false --env ALLOW_STATE_CHANGING_ACTIONS=false --env PLAYWRIGHT_BROWSERS_PATH=.ms-playwright --env BROWSER_PROFILE_DIR=.tmp/browser-profile --env ARTIFACTS_DIR=artifacts --env TAOBAO_SEARCH_MODE=mobile -- C:\Users\你的用户名\Desktop\JD-Taobao-MCP\.venv\Scripts\python.exe C:\Users\你的用户名\Desktop\JD-Taobao-MCP\server.py
codex mcp list
配置后重启 Codex。看到 jd-taobao-browser 或 jd_taobao_browser 已启用后即可调用工具。
参考 config_examples/mcp-client.json:
{
"mcpServers": {
"jd-taobao-browser": {
"command": "<PROJECT_DIR>\\.venv\\Scripts\\python.exe",
"args": ["<PROJECT_DIR>\\server.py"],
"env": {
"PLAYWRIGHT_HEADLESS": "false",
"ALLOW_STATE_CHANGING_ACTIONS": "false",
"PLAYWRIGHT_BROWSERS_PATH": ".ms-playwright",
"BROWSER_PROFILE_DIR": ".tmp/browser-profile",
"ARTIFACTS_DIR": "artifacts",
"TAOBAO_SEARCH_MODE": "mobile"
}
}
}
}
browser_start() 启动可见浏览器。open_login(platform="jd") 或 open_login(platform="taobao")。check_login(platform="jd") 或 check_login(platform="taobao")。search_products(...) 或 get_product_detail(url) 提取商品数据。示例提示:
用 jd-taobao-browser MCP 搜索京东的“RTX 5070 笔记本”,最多返回 10 个,价格 7000 到 12000 元,并按价格从低到高排序。不要点击购买或购物车。
打开这个淘宝商品链接,提取标题、当前页面价格、店铺、产品参数、最多 5 条好评和最多 2 条差评;页面要求验证时停止并让我手动处理。
Playwright 持久化上下文会保存 Cookie、本地存储和登录状态。不要把 BROWSER_PROFILE_DIR 指向日常浏览器默认用户目录;浏览器可能拒绝并发使用,也会增加误操作风险。
工具会返回 requires_user_verification=true 或在状态字段里说明原因。此时需要用户在可见浏览器中手动完成验证,然后再继续调用工具。
GitHub 只会把仓库根目录的 README.md 显示在项目主页。详细文档必须放在仓库根目录,而不是只放在子目录或缺失的路径下。
.\.venv\Scripts\python.exe -m pytest
.\scripts\start_windows.bat
MIT
这是一个基于 Python 与 Playwright 开发的电商网页自动化 MCP Server,主要用于模拟用户在京东、淘宝等电商平台上的浏览和操作,并将网页信息以结构化数据形式提供给大模型或智能体调用。 项目支持商品搜索、商品列表读取、详情页访问、商品参数提取、价格与店铺信息获取、部分用户评价整理、页面截图及链接返回等功能。MCP Server 负责接收智能体指令,调用本地浏览器完成页面操作
개요
这是一个基于 Python 与 Playwright 开发的电商网页自动化 MCP Server,主要用于模拟用户在京东、淘宝等电商平台上的浏览和操作,并将网页信息以结构化数据形式提供给大模型或智能体调用。 项目支持商品搜索、商品列表读取、详情页访问、商品参数提取、价格与店铺信息获取、部分用户评价整理、页面截图及链接返回等功能。MCP Server 负责接收智能体指令,调用本地浏览器完成页面操作,返回支持 MCP 协议的客户端。
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
JD Taobao은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-28. 这是一个基于 Python 与 Playwright 开发的电商网页自动化 MCP Server,主要用于模拟用户在京东、淘宝等电商平台上的浏览和操作,并将网页信息以结构化数据形式提供给大模型或智能体调用。 项目支持商品搜索、商品列表读取、详情页访问、商品参数提取、价格与店铺信息获取、部分用户评价整理、页面截图及链接返回等功能。MCP Server 负责接收智能体指令,调用本地浏览器完成页面操作,返回支持 MCP 协议的客户端。