MCP server and CLI for eBay Terapeak sold and active listing research through an authenticated CloakBrowser session.
概览
An MCP server that lets an AI agent (Claude, etc.) — or you, from the terminal — search eBay's data (sold & active listings) without opening the Seller Hub UI. It wraps eBay's internal endpoint GET /sh/research/api/search and keeps a (a fingerprint-patched Chromium) alive so requests are made from inside a real browser. That carries your session cookies, passes eBay's bot detection (Akamai + perfdrive), and lets the browser rotate the short-lived anti-bot cookies itself — which is what avoids constant cookie-staleness. ⚠️ This uses a private endpoint intended for the Seller Hub web app, driven by your own logged-in session. It is not an eBay-supported API and can break if eBay changes the endpoint. Use it for your own research and keep request volume reasonable. For a supported alternative, see eBay's . - Node.
README
以下为原文 README 节选，完整内容请查看原文。
ebay-terapeak-mcp
An MCP server and CLI that lets an AI agent (Claude, etc.) — or you, from the terminal — search eBay’s Terapeak “Product Research” data (sold & active listings) without opening the Seller Hub UI.
It wraps eBay’s internal endpoint GET /sh/research/api/search and keeps a
persistent, logged-in CloakBrowser
session (a fingerprint-patched Chromium) alive so requests are made from inside
a real browser. That carries your session cookies, passes eBay’s bot
detection (Akamai + perfdrive), and lets the browser rotate the short-lived
anti-bot cookies itself — which is what avoids constant cookie-staleness.
⚠️ Unofficial. This uses a private endpoint intended for the Seller Hub web app, driven by your own logged-in session. It is not an eBay-supported API and can break if eBay changes the endpoint. Use it for your own research and keep request volume reasonable. For a supported alternative, see eBay’s Marketplace Insights API.
Full reference: Documentation · Changelog: CHANGELOG.md · Versioning & releases: docs/RELEASES.md
Requirements
- Node.js 18+ (tested on v24)
- A display (or
xvfbon a headless server) — the session runs a real browser - An eBay account with access to Seller Hub → Research
Setup
From npm (recommended)
npm install -g @bintangtimurlangit/ebay-terapeak-mcp # downloads the CloakBrowser binary (~200 MB, cached)
Puts the ebay-terapeak-mcp command on your PATH (it doubles as the CLI and,
with login, the one-time sign-in). Or run without installing:
npx -y @bintangtimurlangit/ebay-terapeak-mcp.
From source
git clone https://github.com/bintangtimurlangit/ebay-terapeak-mcp.git
cd ebay-terapeak-mcp
npm install # also downloads the CloakBrowser binary (~200 MB, cached)
npm run build
One-time login
Sign into eBay once. This opens a real browser window and saves the session to a
persistent profile (~/.ebay-research-mcp/profile by default).
ebay-terapeak-mcp login # global install — or, from a source checkout: npm run login
Sign in (complete any 2FA) and wait until the “Research products” page loads.
安装
npx -y @bintangtimurlangit/ebay-terapeak-mcp配置
{
"mcpServers": {
"ebay-terapeak": {
"command": "npx",
"args": ["-y", "@bintangtimurlangit/ebay-terapeak-mcp"]
}
}
}