Username Inspector

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のプラットフォームで、1つのユーザー名を検索します。各プラットフォームの結果は 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 を指定します。7つのプラットフォームについて、手数料と手元に残る金額を高い順に返し、コストが指定されている場合は利益、利益率、ROI も返します。米国の販売者向けの概算で、売上税は含まれません。各手数料率の最終確認日も示します。

すべてのツールは読み取り専用で、出力スキーマを宣言します。

制限と動作

• クライアントあたり、1分間に約12回のツール呼び出しが可能です（超過すると Retry-After を含む HTTP 429 が返されます）。リクエスト本文は16 KBまで、1バッチあたりのメッセージ数は5件までです。
• check_username の呼び出し1回につき、ユーザー名は1つです。結果はユーザー名とプラットフォームごとにメモリ内で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 のサーバーレス関数としても動作するように構成されているため、変更せずにデプロイできます。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	2 つのエンドポイント
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をご覧ください。

お問い合わせ

誤った結果を見つけた場合や、プラットフォームの追加を希望する場合は、お問い合わせページをご利用ください。