接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
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
xvfb on a headless server) — the session runs a real browsernpm 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.
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
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. The window closes itself once login is detected.
The login step and the running server both use the same browser profile, and a profile can only be open in one browser at a time. Stop the MCP server before running login.
Register the server:
claude mcp add ebay-terapeak -- npx -y @bintangtimurlangit/ebay-terapeak-mcp
Or add it to your MCP config JSON:
{
"mcpServers": {
"ebay-terapeak": {
"command": "npx",
"args": ["-y", "@bintangtimurlangit/ebay-terapeak-mcp"]
}
}
}
After a global install you can instead use "command": "ebay-terapeak-mcp", "args": []. From a source checkout, use "command": "node", "args": ["/ABSOLUTE/PATH/TO/ebay-terapeak-mcp/dist/index.js"].
Then ask, e.g.: "Search eBay sold listings for 'nintendo switch oled' over the last 90 days."
Per the MCP annotations spec — all tools are read-only, with no side effects.
The endpoint honors some refinements as query params and ignores others. Which is which was verified empirically (by diffing result counts against the live endpoint), not assumed:
exact phrase,
condition (conditionId), min_price/max_price (minPrice/maxPrice),
format (AUCTION/FIXED_PRICE).exclude (the endpoint returns zero rows for
-term exclusion), sort, and de-duplication of repeated rows.Sorting orders the rows actually retrieved (up to max_results), so raise
max_results for a wider ranking.
{
"query": { "keywords": "...", "tab": "SOLD", "days": 90, ... },
"aggregates": {
"avgSoldPrice": 117.78,
"soldPriceRange": "$0.01 - $16,497.50",
"avgShipping": 11.85,
"freeShippingPct": 73,
"totalSold": 247663,
"sellThrough": "-",
"totalSellers": 50063,
"totalItemSales": 29169748.14,
"raw": { "Avg sold price": "$117.78", ... }
},
"resultCount": 100,
"results": [
{
"itemId": "366324079285",
"title": "For Nintendo Switch OLED/NS/Lite Console ...",
"extendedTitle": "...",
"url": "https://www.ebay.com/itm/366324079285...",
"imageUrl": "https://i.ebayimg.com/images/g/.../s-l1200.webp",
"moreImages": [ "..." ],
"format": "Fixed price",
"avgSoldPrice": 11.27,
"avgSoldPriceText": "$11.27",
"avgShipping": 11.78,
"freeShippingPct": 96,
"totalSold": 486,
"totalSales": 5478.54,
"totalSalesText": "$5,478.54",
"dateLastSold": "Jul 5, 2026",
// ACTIVE-tab rows populate these instead of the sold-* fields above:
"listingPrice": null,
"listingPriceText": null,
"listingShipping": null,
"watchers": null,
"promoted": null,
"startDate": null,
"bids": null
// `extendedTitle` and `moreImages` appear only when detail=true
}
],
"pagination": { "summary": "Results: 1 - 50", "currentPage": 1, "hasNext": true },
"notes": [ "Aggregates reflect the server-side filters ...", "..." ]
}
SOLD rows carry
avgSoldPrice/totalSold/totalSales/dateLastSold; ACTIVE rows carrylistingPrice/watchers/promoted/startDate. The other tab's fields arenull. Rows are compact by default (noextendedTitle/moreImages) to keep responses small — passdetail: trueto include them.
The same search engine is available from the terminal (no MCP client needed):
node dist/index.js search "Players Pins" --exact --sort sales --limit 15
node dist/index.js search "Players Pins" --active --exact --min-price 20 --max-price 60
node dist/index.js search "Players Pins" --exact --condition new --summary
node dist/index.js search "Players Pins" --exact --json > results.json
Run node dist/index.js search --help for all flags. Flags map 1:1 to the tool
params above (--min-price/--max-price, --limit = max_results,
--category = category_id, --sold/--active pick the tab). --json emits
the full structured result; otherwise a compact table is printed.
NotLoggedInError / "non-JSON response" — session expired or got flagged.
Stop the server, run npm run login, restart.EBAY_MCP_HEADLESS=0 in the MCP server env.profile ... already in use — the server and the login command can't run
at the same time. Stop one.src/
index.ts entry: `login` / `search` (CLI) commands vs. start server
browser.ts persistent Playwright session (login + in-page fetch)
parse.ts deep mapping of eBay's module/TextualDisplay JSON -> flat objects
core.ts framework-agnostic search engine: query build, filters, pagination
server.ts MCP server + tool schemas (thin wrapper over core)
cli.ts CLI front-end (arg parsing + table output over core)
reference/
ebay_terapeak.py standalone cookie-replay script (no browser) — reference only
Lint, format, typecheck, and build with npm run lint, npm run format, npm run typecheck, and npm run build. Full guide: docs/DEVELOPMENT.md.
This is an unofficial project. It is not affiliated with, authorized, maintained, sponsored, or endorsed by eBay Inc.
It drives a private endpoint intended for the Seller Hub web app via your own logged-in session; it is not an eBay-supported API and can break if eBay changes the endpoint or its bot detection. For a supported alternative, see eBay's Marketplace Insights API. It reads only research data your account can already access and performs no account actions.
You are responsible for using this software in compliance with eBay's User Agreement and applicable law. Keep request volume reasonable. All product names, logos, and brands are property of their respective owners.
MCP server and CLI for eBay Terapeak sold and active listing research through an authenticated CloakBrowser session.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Ebay Terapeak 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 MCP server and CLI for eBay Terapeak sold and active listing research through an authenticated CloakBrowser session.