二手MCP
A. 模型上下文协议 (MCP)服务器,让人工智能助手搜索二手市场。在Facebook Marketplace、eBay、Depop和Poshmark上搜索二手商品——按价格、类别、条件、尺寸和颜色过滤,然后获得包含照片、描述和卖家信息的完整列表详细信息。
适用于Claude Desktop、Claude Code、Cursor和任何兼容MCP的客户端。
\[!提示\] 想跳过设置吗? 尝试 二手MCP云 --在30秒内连接到Claude.ai和ChatGPT的托管版本。无需安装或Chrome。包括免费套餐。
支持的市场
| 市场 | 需要授权 | 备注 |
|---|---|---|
| Facebook Marketplace | 否 | 基于位置的搜索 |
| 易趣 | 是(API密钥) | API官方浏览 |
| Depop | 否 | 需要安装Chrome |
| Poshmark | 否 | 需要安装Chrome |
设置
克劳德桌面版
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"secondhand": {
"command": "npx",
"args": ["-y", "secondhand-mcp"],
"env": {
"EBAY_CLIENT_ID": "your-ebay-client-id",
"EBAY_CLIENT_SECRET": "your-ebay-client-secret"
}
}
}
}克劳德代码
增添 ~/.claude/.mcp.json:
{
"mcpServers": {
"secondhand": {
"command": "npx",
"args": ["-y", "secondhand-mcp"],
"env": {
"EBAY_CLIENT_ID": "your-ebay-client-id",
"EBAY_CLIENT_SECRET": "your-ebay-client-secret"
}
}
}
}eBay、Depop和Poshmark都是可选的-如果eBay API密钥丢失或未安装Chrome,这些市场将自动禁用,其余市场仍然有效。
Depop&Poshmark/Chrome要求
Depop和Poshmark需要一个无头浏览器。如果 谷歌Chrome或Chromium 安装在您的系统上,两者都会自动启用,无需配置。如果找不到Chrome,则会自动跳过。
在macOS上,当你第一次搜索Depop或Poshmark时,你可能会看到一个系统提示,要求允许Node.js控制Chrome。这是意料之中的——木偶师需要在无头模式下启动Chrome。允许它一次,它就不会再问了。
浏览器在后台不可见地运行,只有在您实际搜索Depop或Poshmark时才会启动。
配置
选择市场
默认情况下,所有市场都已启用。要限制哪些是活动的,请设置 MARKETPLACES env变量(逗号分隔):
{
"env": {
"MARKETPLACES": "facebook,ebay"
}
}有效值: facebook, ebay, depop, poshmark
易趣API钥匙
eBay使用官方 浏览API。您需要一个免费的易趣开发者帐户:
- 创建一个账户 developer.ebay.com
- 创建一个应用程序以获取客户端ID和客户端密钥
- 将它们添加到MCP配置中
EBAY_CLIENT_ID和EBAY_CLIENT_SECRET
工具
search_marketplace
在市场上搜索商品。
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
query | 是 | 搜索词 | |
marketplace | 没有 | facebook | facebook, ebay, depop, poshmark,或 all |
location | 没有 | san francisco | 要搜索的城市(仅限Facebook) |
maxPrice | 否 | 最高价格 | |
minPrice | 否 | 最低价格 | |
limit | 没有 | 20 | 最大结果 |
showSold | 没有 | false | 包括已售商品(仅限Facebook) |
includeImages | 没有 | false | 在输出中包含图像URL |
sort | 没有 | relevance | 排序顺序(仓库、Poshmark): relevance, newest, most_popular, price_low_to_high, price_high_to_low |
condition | 无 | 项目条件。易趣网: new, like_new, good, fair.仓库: new, like_new, excellent, good, fair, usedPoshmark: new (NWT) like_new (NWOT), good, fair | |
category | 否 | 产品类别。仓库: tops, bottoms, dresses, coats-jackets, footwear, accessories, bags, jewellery, activewear, swimwearPoshmark: Jackets_&_Coats, Dresses, Shoes, Accessories等等。 | |
brand | 否 | 品牌过滤器(仅限Poshmark):例如。 "Nike", "Levi's", "Gucci" | |
department | 否 | 部门筛选器(仅限Poshmark): Women, Men, Kids | |
sizes | 否 | 尺寸过滤器(Depop、Poshmark):例如。 ["S", "M", "L"] 或 ["US 9", "US 10"] | |
colors | 否 | 滤色器(Depop、Poshmark): black, white, red, blue, green, yellow, orange, pink, purple, brown, grey, cream, multi, silver, gold |
每个市场返回的数据:
| Field | eBay | Depop | Poshmark | |
|---|---|---|---|---|
| 标题 | 是 | 是 | 有 | 有 |
| 价格 | 是 | 是 | 有 | 有 |
| 位置 | 城市 | 城市,州 | -- | -- |
| 条件 | -- | 是 | -- | -- |
| 照片计数 | 1缩略图 | 1缩略图 | 1缩略图 | 1 |
| 卖家 | 是 | 是 | -- | -- |
get_listing_details
使用搜索结果中的ID获取特定列表的完整详细信息。
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
listingId | 是 | 搜索结果中的列表ID | |
marketplace | 没有 | facebook | facebook, ebay, depop,或 poshmark |
每个市场返回的数据:
| Field | eBay | Depop | Poshmark | |
|---|---|---|---|---|
| 描述 | 是 | 是 | 有 | 有 |
| 所有照片 | 是 | 是 | 有 | 有 |
| 位置 | 城市 | 城市、州、国家 | -- | -- |
| 卖家 | 姓名 | 用户名 | 用户名 | |
| 交货类型 | 是 | -- | -- | -- |
| 发货 | 是/否 | 服务代码 | 是/无 | 始终包含 |
list_marketplaces
列出所有启用的市场及其状态。
运作原理
Facebook 商城 --按位置、价格和查询搜索列表。将城市名称解析为坐标。无需登录或浏览器。
易贝 -使用带有OAuth 2.0客户端凭据的官方易趣浏览API。令牌被缓存并自动刷新。
Depop --使用无头浏览器搜索支持类别、条件、大小和颜色过滤器的列表。浏览器实例在请求之间共享。
Poshmark --使用无头浏览器搜索列表,支持条件、大小、颜色、排序和价格过滤器。Poshmark不是基于位置的——所有商品都在全国范围内发货。
发展
git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp
npm install
npm run build添加市场
- 在中创建新文件
src/marketplaces/ - 扩展
BaseMarketplace并实施search()并且可选getListingDetails() - 将构造函数添加到
allMarketplaces在src/marketplaces/index.ts
局限性
- 脸书:如果脸书改变前端,可能会崩溃
- 易贝:需要开发人员API密钥(可用的免费层)
- Depop:需要安装Chrome/Chromium;比Facebook/eBay慢(每次搜索约5秒)
- Poshmark:需要安装Chrome/Chromium;没有官方的API依赖页面抓取
- 速率限制:不要太快地提出太多要求
许可证
麻省理工学院

