Partle

Partle マーケットプレイス MCP サーバー

Partle マーケットプレイス向けのModel Context Protocolサーバーです。AI を使って、ここで商品を購入できます。アシスタントを離れることなく、商品や店舗を検索したり、価格や購入リンクを取得したり、出品の追加を依頼したりできます。

ライブの商品および店舗の掲載状況は、get_stats ツールで確認できます。公開カタログの読み取りに認証は不要です。書き込みや非公開在庫の読み取りには、OAuth または pk_… API キーが必要です。

2つの実行方法

リモート（推奨 — セットアップ不要）

MCP クライアントの接続先として、次を指定します。

https://partle.rubenayla.xyz/mcp/

これだけです。Streamable HTTP トランスポート、MCP spec 2025-06-18に対応しています。クライアントごとのインストール手順については、/documentation/mcp-setup/をご覧ください。

ローカル stdio（インストール可能なサーバーを使うクライアント、または Glama / Smithery のスコアリング向け）

pip install partle-mcp
partle-mcp

または、uvx を使う方法（インストール不要）：

uvx partle-mcp

または、Docker を使う方法：

docker run --rm -i ghcr.io/rubenayla/partle-mcp

stdio パッケージは、公開 REST API https://partle.rubenayla.xyz にリクエストを中継するため、データベースやローカルバックエンドは不要です。

Claude Desktop / Claude Code（stdio）

{
  "mcpServers": {
    "partle": {
      "command": "uvx",
      "args": ["partle-mcp"]
    }
  }
}

ツール（全20種類）

読み取り（認証不要）

ツール	用途
search_products	名前、価格帯、タグ、店舗でカタログを検索します。言語をまたいだセマンティック検索に対応しています。
get_product	IDで指定した商品の全レコードを取得します。
search_stores	名前または住所で店舗を検索・一覧表示します。
get_store	IDで指定した店舗の全レコードを取得します。
get_stats	プラットフォーム全体の合計数を取得します。
search_wanted	/wanted にある公開 購入リクエスト を閲覧します。購入希望があるものの、まだ見つかっていない商品が掲載されています。一致する商品を提案するには、search_products の結果と照合します。

書き込み（認証済み）

優先順に、次の2つの認証方法があります。

1. OAuth（推奨） — claude.ai または OAuth に対応する MCP クライアントで Partle をカスタムコネクターとして追加すると、クライアントがワンクリックの同意画面を表示し、ベアラートークンを自動的に設定します。スコープ：products:read、products:write、inventory:read、inventory:write。/account → 接続済みアプリから取り消せます。RFC 9728 メタデータは /.well-known/oauth-protected-resource、RFC 7591 動的クライアント登録は /oauth/register にあります。
2. API キー（代替手段） — 書き込みツールに api_key パラメーターを渡します。/account → API キーから生成できます。クライアントが OAuth に対応していない場合（直接実行するスクリプトやプログラムから操作するエージェントなど）に使用してください。

商品 — 公開カタログの掲載情報です。

ツール	用途
create_product	新しい掲載情報を追加します。AI が未確認の人に代わって提案する場合は、verified=false に設定します。
update_product	自分が所有する掲載情報を編集します。
delete_product	自分が所有する掲載情報を削除します。
upload_product_image	画像を添付します（base64 または URL）。
delete_product_image	商品から画像を削除します。
get_my_products	自分が作成した商品を一覧表示します。

リモート HTTP サーバーでは get_upload_url も利用できます（既存の商品用の署名付きアップロード URL を再取得します）。この stdio パッケージでは公開されていません。必要な場合はリモートサーバーを使用してください。

在庫 — 非公開の作業場在庫管理（owned / wanted / for_sale / sold / discarded）です。所有者のみが閲覧でき、公開の /wanted フィードには表示されません。

ツール	用途
get_my_inventory	在庫アイテムを一覧表示します。ステータス、プロジェクト、フリーテキストで絞り込めます。
add_inventory_item	任意のライフサイクル状態で行を追加します。
update_inventory_item	任意のフィールドを更新します。
delete_inventory_item	行を完全に削除します。
mark_for_sale	便利な機能：owned アイテムを for_sale に変更し、希望価格を設定します。
mark_sold	便利な機能：for_sale アイテムを sold に変更します。

購入リクエスト — /wanted に投稿される、需要側の公開投稿です。個人の在庫とは別に管理されます。

ツール	用途
create_buy_request	公開の購入リクエストを投稿します（名前、説明、数量、任意の max_price と contact）。

フィードバック

ツール	用途
submit_feedback	Partle との連携体験について、自由形式のフィードバックを送信します。

公開 REST API

同じデータに、MCP に対応していないクライアント向けの通常の HTTP でもアクセスできます。

• GET /v1/public/products?q=cerrojo&limit=10 — 商品を検索します
• GET /v1/public/stores?q=Madrid&limit=10 — 店舗を検索します
• GET /v1/public/wanted?q=bolt&limit=10 — 公開中の購入リクエストを一覧表示します
• GET /v1/public/stats — プラットフォームの合計数を取得します
• POST /v1/public/feedback — フィードバックを送信します

ベース URL：https://partle.rubenayla.xyz。IP ごとに1時間あたり100リクエストまでに制限されています。

詳細なドキュメント：/documentation/ · OpenAPI：/openapi.json · ディスカバリー：/.well-known/mcp.json。

使用例

あなた：「Partle を使って、€50 未満のドリルを探してください。」

Claude： (search_products(query="drill", max_price=50) を呼び出します)

Blackspur 13pc High Speed Drill Bit Set（€4.99、Lenehans、IE）、Flotec Drill Pump 225 GPH（€17.14、Kooyman Megastore、NL）などが返されます。それぞれに、掲載情報を表示するための partle_url が付いています。

その他の例はセットアップガイドをご覧ください。

ライセンス

Apache-2.0 — LICENSEを参照してください。