BE

bintangtimurlangit/ebay-terapeak-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

5 stars 4 forks Качество 73 Тренд 21MIT

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 xvfb on a headless server) — the session runs a real browser
  • An eBay account with access to Seller Hub → Research

Setup

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.

Открыть полный README на GitHub

Установка

npx -y @bintangtimurlangit/ebay-terapeak-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "ebay-terapeak": { "command": "npx", "args": ["-y", "@bintangtimurlangit/ebay-terapeak-mcp"] } } }