Poshmark Comps

@pipeworx/poshmark-comps

Poshmarkの公開マーケットプレイスで、販売済み価格と出品中の商品を検索できます。 Poshmarkで最も優れた販売済み価格の比較データを、ログインもAPIキーも不要で利用できます。

Pipeworx の一部です。AI エージェントを1683以上の稼働中データソースに接続するMCPゲートウェイです。

ツール

• poshmark_sold_search(query, department?, sort_by?, limit?) — 販売済みの出品を検索し、各結果について価格、サイズ、ブランド、コンディション、販売日、出品者、出品URLを返します。
• poshmark_active_search(query, department?, sort_by?, limit?) — 現在出品中（まだ販売されていない）の商品を同じ形式で検索し、希望価格と販売済み価格を比較できます。

認証

キーは不要です。ログインもAPIキーも不要で、ボット対策のチャレンジも確認されていません（2026-09-05に実環境で確認）。

データソース

• https://poshmark.com/search — Poshmark独自の公開検索ページです。個別のJSON APIエンドポイントはありません。このページはVueアプリによってサーバー側でレンダリングされ、完全な検索結果がwindow.__INITIAL_STATE__のスクリプトタグ内のデータに埋め込まれています（実環境で確認済み：XHR／Accept: application/jsonリクエストでも、JSONではなく同じ完全なHTMLページが返されます）。このパックはHTMLを取得し、埋め込まれたJSONを直接抽出します。DOM解析よりも低コストで、堅牢です。

次の担当者向けの注意点：

• 1回の呼び出しにつき1ページで、結果は最大約48件です（Poshmarkのデフォルトのページサイズ）。レスポンス内のnext_max_idは実際のページネーションカーソルですが、このパックはまだ次のページを取得しません。ツール出力のtotal_matches_reported_by_poshmarkで、さらにどれだけの結果があるかを呼び出し元に伝えます。
• 販売済み商品のpriceは、販売済みの投稿でPoshmarkが表示する出品価格（販売者が提示していた価格）であり、領収書や落札価格として別途確認された金額ではありません。また、Poshmarkの手数料と送料は含まれません。この点を呼び出し元に伝えてください。各レスポンスのcoverage_noteに記載されています。
• sort_byで確実に使えるのはbest_match（デフォルト）、price_desc、price_ascのみです。実環境で確認したところ、2026-09-05時点でnewestとmost_lovedは空の結果セットを返したため、選択肢として公開していません。
• サイトのbrand／sizeクエリパラメーターは、確認時にフィルタリングが安定して機能せず（一致しないブランドも結果に含まれました）。実際のフィルタリングにはフリーテキストのqueryを使うため、ブランドとサイズは個別のパラメーターとして公開していません。代わりにqueryに含めてください（例："lululemon align size 6"）。
• 節度を持ってクロールしてください。ツール呼び出し1回につきページ取得は1回のみとし、ページネーションのループや並列ファンアウトは行わないでください。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "poshmark-comps": {
      "url": "https://gateway.pipeworx.io/poshmark-comps/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/poshmark-comps/mcpのtools/listは、上の表に記載されたツールに加えて、共有Pipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で利用できる一連のツール）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて約30個の共有ツールが一覧表示されます。接続のinitializeレスポンスには正確なスコープが記載されており、その日の状況を確認するにはこれが確実です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断してルーティングするask_pipeworxを通じて回答できます。MCPサーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

このパックだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworxのフルゲートウェイに接続してください。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/poshmark_sold_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"lululemon align","sort_by":"relevance","limit":10}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/poshmark_sold_search を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

単独で実行（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントもゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "poshmark-comps": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-poshmark-comps"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-poshmark-comps

stdin/stdout 経由で MCP をやり取りし、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。上記のパックエンドポイントだけでなく、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Poshmark Comps data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT