bintangtimurlangit/ebay-terapeak-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
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"]
}
}
}