Soldgraph
Sold comps and active listings from eBay, Poshmark, Mercari, Depop, Vinted, TCGplayer and more.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http soldgraph 'https://api.soldgraph.com/mcp' --header 'Authorization: <Bearer <your Soldgraph API key>. Get one at https://soldgraph.com/app/keys>'
{
"mcpServers": {
"soldgraph": {
"type": "http",
"url": "https://api.soldgraph.com/mcp",
"headers": {
"Authorization": "<Bearer <your Soldgraph API key>. Get one at https://soldgraph.com/app/keys>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Soldgraph API examples
Copy-paste examples for the Soldgraph resale data API: eBay, Poshmark and Mercari sold listings as JSON, plus active listings from Depop, Whatnot, OfferUp and Facebook Marketplace and Vinted, and TCGplayer card prices.
Use it to replace eBay's retired findCompletedItems. You don't need an eBay developer account.
from soldgraph import search # python/soldgraph.py
result = search("/ebay/sold", {"q": "nintendo switch oled"})
for row in result["data"]:
print(row["sold_date"], row["displayed_price"], row["title"])
Get a free key: 100 free requests, no credit card required.
Examples
| Folder | What it shows |
|---|---|
python/ | Client, eBay sold prices with a median, eBay vs Poshmark vs Mercari, Facebook Marketplace near a ZIP code |
node/ | Client (Node 18+, no dependencies), sold prices, paging through results, Facebook Marketplace near a ZIP code |
curl/ | Search and poll from the shell with jq |
google-sheets/ | =SOLDGRAPH_SOLD("item") custom function |
findcompleteditems-migration/ | Move off eBay's Finding API, with a field mapping |
mcp/ | Connect Claude, Cursor or VS Code to the hosted MCP server |
Run one
export SOLDGRAPH_KEY=sg_...
# Python
cd python && pip install -r requirements.txt && python ebay_sold.py "nintendo switch oled"
# Node
node node/ebay-sold.mjs "nintendo switch oled"
# curl
./curl/ebay-sold.sh "nintendo switch oled"
How the API works
A search either returns its result right away or a job to poll. The clients in python/ and node/ handle that, plus retries and idempotency. If you're writing your own, read AGENTS.md first.
Links
Soldgraph is not affiliated with eBay, Poshmark, Mercari, Depop, Whatnot, OfferUp, Facebook, Vinted or TCGplayer.
MIT licensed.
الأسئلة الشائعة
ما هو Soldgraph؟
Sold comps and active listings from eBay, Poshmark, Mercari, Depop, Vinted, TCGplayer and more.
كيف أثبّت Soldgraph؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http soldgraph 'https://api.soldgraph.com/mcp' --header 'Authorization: <Bearer <your Soldgraph API key>. Get one at https://soldgraph.com/app/keys>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Soldgraph إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Soldgraph مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Soldgraph؟
ينشره soldgraph. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.