Username Inspector

用户名检查器 MCP 服务

面向在转售市场平台上销售商品的用户的免费 Model Context Protocol 服务。它可以让 AI 助手：

• 查询 eBay、eBay Store、Poshmark、Grailed、Vinted、Whatnot、Bonanza、Chairish、Depop、Etsy、Mercari 和 Ruby Lane 上的用户名或店铺名称是否可用；以及
• 比较在 eBay、Poshmark、Mercari、Depop、Etsy、Grailed 和 Vinted 上销售商品扣除费用后的实际收入。

这是 Username Inspector 背后的代码。面向最终用户的文档请见 **https://usernameinspector.com/mcp/**。

使用托管服务

无需账号，无需 API 密钥。

服务	URL	工具
查询服务	https://usernameinspector.com/api/mcp	check_username、compare_fees
仅链接服务	https://usernameinspector.com/api/mcp-links	get_profile_links、compare_fees

仅链接服务不会联系任何市场平台。它会生成用户名对应的公开个人资料页面地址，由你自行打开。

Claude Code

claude mcp add --transport http username-inspector https://usernameinspector.com/api/mcp

使用 JSON 配置的客户端（Cursor 等）

{
  "mcpServers": {
    "username-inspector": {
      "url": "https://usernameinspector.com/api/mcp"
    }
  }
}

**使用自定义连接器或远程服务选项的客户端：**添加服务并粘贴 URL。

它也已列入官方 MCP Registry，名称为 com.usernameinspector/username-inspector。

工具

check_username

在最多 12 个平台上查询一个用户名。每个平台会返回 available、taken、unverified 或 error，并在有帮助时附上个人资料页面链接。

• username（必填）：3 到 50 个字母、数字、连字符或下划线。
• platforms（可选）：平台 ID 列表。默认为全部 12 个平台：ebay、ebaystore、poshmark、grailed、vinted、whatnot、bonanza、chairish、depop、etsy、mercari、rubylane。

Depop、Etsy、Mercari 和 Ruby Lane 会拦截自动检查，因此始终只返回个人资料链接。Poshmark、Vinted 和 Bonanza 通常会返回实时查询结果。eBay、eBay Store、Grailed、Whatnot 和 Chairish 经常会拦截自动查询，这些平台会返回 unverified，并附上手动检查链接。哪些平台能够返回结果可能随时变化。

get_profile_links（仅链接服务）

为各个平台生成用户名对应的公开个人资料页面地址。不会向任何市场平台发送请求。

compare_fees

接收以 USD 计价的销售价格，以及可选的 shipping_charged、item_cost、shipping_cost 和 ebay_promoted_rate_percent。按收入从高到低返回七个平台的费用和实际所得；提供成本时还会返回利润、利润率和投资回报率。这些估算面向美国卖家，不含销售税，并注明各项费率最近一次核实的日期。

所有工具均为只读，并声明了输出架构。

限制和行为

• 每个客户端每分钟约可调用工具 12 次（超过后返回 HTTP 429 和 Retry-After），请求正文大小上限为 16 KB，每批最多 5 条消息。
• 每次 check_username 调用只能查询一个用户名。查询结果按用户名和平台在内存中缓存 5 分钟，错误永不缓存。
• 每个实例最多同时执行 12 个外部查询；每个平台的超时时间为 5 秒，每次调用的超时时间为 9 秒。
• 设置 MCP_DISABLED=1 会关闭两个端点。设置 MCP_LINKS_DISABLED=1 只会关闭链接端点。

进程内限制按实例计算，并尽力执行。在无服务器托管环境中，也请在平台级别添加速率限制规则。

隐私

助手会将用户名发送到服务器，服务器会在交易平台上查询并返回结果。不会存储任何内容。日志仅记录计数：工具名称、平台数量和耗时。绝不记录用户名或 IP 地址。请参阅隐私政策。

查询方式

check_username 会发送与浏览器打开个人资料页面时相同的普通 HTTPS 请求，并读取响应状态或页面上的标记，以判断个人资料是否存在。它不使用交易平台 API，也无需登录，并且不会尝试绕过机器人防护：当平台返回质询或错误时，结果为 unverified，绝不会猜测。

平台可以随时更改或屏蔽这些请求。如果你自行运行此服务，则需自行负责由此给这些网站带来的负载，并遵守它们的条款。

自行运行

需要 Node 18 或更高版本。

npm install
npm start

此服务会在 http://127.0.0.1:3000/api/mcp 和 http://127.0.0.1:3000/api/mcp-links 提供服务（设置 PORT 和 HOST 可更改这些地址）。api/ 文件夹也采用 Vercel 无服务器函数的目录结构，因此可直接部署到 Vercel，无需更改。使用 Streamable HTTP 传输；此服务是无状态的。

快速检查：

curl -s -X POST http://127.0.0.1:3000/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

测试

npm test

测试使用 Node 内置的运行器并模拟网络，因此不会向任何交易平台发送请求。

费率

所有费率都位于 lib/fee-calc.js 中，并各自带有 lastVerified 日期。这些是美国费率，且经常变动，因此在定价前请查看平台自己的费用页面。

目录结构

路径	用途
api/mcp.js、api/mcp-links.js	两个端点
lib/mcp-handler.js	HTTP 入口：CORS、限制、紧急关闭开关
lib/mcp-server.js、lib/mcp-links-server.js	工具
lib/platform-checks.js	各个平台的查询方式
lib/fee-calc.js	费率计算
lib/mcp-guard.js	速率限制器、缓存、并发上限
server.js	本地运行器

许可证

MIT。请参阅 LICENSE。

联系方式

发现错误结果或想要添加平台？请使用联系页面。