Periskop MCP, Product Discovery For AI Agents

Periskop — AI エージェント向けの商品発見

AI エージェント向けの商品発見。1 回の MCP 呼び出しで、自然言語による買い物の意図を、最適な商品、代替品、セット商品、注意事項、価格、販売店へのリンクを含む、順位付けされた構造化商品検索結果に変換します。オープンな販売店ウェブ上の独立系ストアを横断して検索できます。

Periskop は、ホスト型のリモート MCP サーバー（クローズドソース）です。公開 HTTPS エンドポイントに Periskop API キーで接続するだけで、インストールや実行は不要です。Periskop はエージェント型コマースのための商品発見レイヤーです。エージェントが自然言語で質問すると、Periskop は販売店へのリンク付きで順位付けされた商品を返します。商品発見までを担い、チェックアウト、支払い、注文は行いません。

• ウェブサイト： https://periskop.ai
• 開発者ポータル／API キーの取得： https://periskop.ai/developer
• ドキュメント： https://periskop.ai/developer/docs
• MCP エンドポイント： https://mcp.periskop.ai/v1/mcp（ストリーミング可能な HTTP、JSON-RPC 2.0）

対象ユーザー

チェックアウト機能を自社で持つことなく、意図を信頼できる商品検索結果に変換する必要があるあらゆるプロダクトが対象です。エージェントプラットフォームやオーケストレーター、AI ワーカープラットフォーム、AI ショッピングアシスタント、ブラウザーエージェント、コマースコパイロット、レコメンデーションシステム、調達や B2B ソーシングのワークフロー、価格・お買い得品のモニター、再入荷・再注文ボット、ギフトアプリ、再販・裁定取引のワークフロー、アクセシビリティ対応のショッピングツールなどです。具体例としては、キャンプ旅行の計画を立てて必要なギアを提示するエージェント、複数のサプライヤーから選択肢を比較する調達コパイロット、あるいは一文のリクエストから適切な商品を提示する音声アシスタントなどがあります。

提供する機能（および提供しない機能）

Periskop が返すのは、商品検索結果と販売店へのリンクのみです。チェックアウトの完了、販売店のカート作成、支払い処理、在庫の確保、商品の購入は行いません。 購入手続きは、必ずユーザーが販売店のウェブサイト上で完了します。すべての応答に、この点を改めて示す purchase_boundary ブロックが含まれます。

接続

エンドポイント	https://mcp.periskop.ai/v1/mcp
トランスポート	ストリーミング可能な HTTP — HTTP POST 上の JSON-RPC 2.0（POST ごとに JSON 応答を 1 件返します。SSE は使用しません）
ワイヤープロトコル	2024-11-05
認証	Authorization: Bearer <YOUR_PERISKOP_API_KEY>（キーは dp_… の形式です）
キーの取得	https://periskop.ai/developer

認証されていないリクエストには、WWW-Authenticate: Bearer ヘッダー付きの 401 が返されます。

注：Periskop は、OAuth を希望するホスト向けに OAuth 2.1（Authorization Code + PKCE）もサポートしています（トークンは dpo_… の形式です）。最も簡単なのは API キーを使う方法で、以下の設定では API キーだけで十分です。

ツール

すべてのツールは、単一の JSON オブジェクトを引数として受け取ります。以下のスキーマは、公開されているツールのインターフェースです。

run_shopping_discovery

自然言語によるリクエストから、商品を探す、選ぶ、閲覧する、おすすめする、最適な商品を見つける、またはセット商品を作成します。必須フィールドは prompt のみです。

フィールド	型	必須	備考
prompt	string	✅	自然言語による買い物の意図
mode	string | null		auto | browse | recommend | best | bundle（デフォルトは auto）
store	string | null		auto、ストア ID、またはストア名／ヒント
country	string | null		例：PT、ES
currency	string | null		例：EUR
language	string | null		例：en、pt
max_results	integer | null		返す商品の上限数
response_format	string | null		full（デフォルト）| simple

get_discovery_result

result_id を使って以前の結果を取得します。結果は一時的なもので、期限切れになる場合があります。

フィールド	型	必須
result_id	string	✅
response_format	string | null

discover_supported_stores

Periskop が利用できる公開ストアを調べます。公開ストアの機能のみを返します。

フィールド	型	必須
country	string | null
category	string | null
capability	string | null（search | bundle | product_links）

report_result_feedback

結果が良かったか、悪かったか、どちらとも言えなかったかを報告します。

フィールド	型	必須
result_id	文字列	✅
rating	文字列（good | bad | mixed）	✅
reason	文字列 | null
selected_product_id	文字列 | null
freeform_feedback	文字列 | null

suggest_store_coverage

今後 Periskop に対応してほしいストア／販売業者／マーケットプレイスを提案します。課金対象外です。 ストアの検索やスクレイピングは行わず、今後の対応を保証するものではありません。

フィールド	型	必須
store_name	文字列	✅
store_url	文字列 | null
country / region / category	文字列 | null
context	文字列 | null（例：unsupported_store、no_match）

例

リクエスト（JSON-RPC tools/call）

curl -sS -X POST https://mcp.periskop.ai/v1/mcp \
  -H "Authorization: Bearer YOUR_PERISKOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "run_shopping_discovery",
      "arguments": { "prompt": "wireless noise-cancelling headphones for travel under 200€", "mode": "best" }
    }
  }'

レスポンス（省略版 — サンプル／架空のデータであり、実際のものではありません）

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"result_id\":\"res_example_8f2a1c\",\"mode_used\":\"best\",\"products\":[{\"title\":\"SampleAudio Aero NC\",\"price\":\"€179.00\",\"currency\":\"EUR\",\"merchant\":\"Example Store\",\"url\":\"https://store.example/p/aero-nc\",\"role\":\"best_pick\"},{\"title\":\"Acme Quietline 2\",\"price\":\"€149.00\",\"currency\":\"EUR\",\"merchant\":\"Example Store\",\"url\":\"https://store.example/p/quietline-2\",\"role\":\"alternative\"}],\"caveats\":[\"Prices and availability may change on the merchant site.\"],\"purchase_boundary\":{\"checkout_created\":false,\"payment_processed\":false,\"stock_reserved\":false,\"user_must_complete_purchase_on_merchant_site\":true}}"
      }
    ]
  }
}

構造化ペイロードは、result.content[0].text のテキストとして返されます。各レスポンスと X-Request-ID レスポンスヘッダーには、呼び出しごとのリクエスト ID が含まれます。

料金（概要）

プリペイドウォレット方式で、成功した検索リクエストのみ課金されます。認証エラー、不正な形式の リクエスト、内部／実行時エラー、レート制限、該当結果なし（確定）は課金されません。 最新の料金については https://periskop.ai/developer/billing をご覧ください。

クライアントの設定

コピーして貼り付けられる設定は config-snippets/ にあります。Cursor （.cursor/mcp.json）、Claude Desktop、Claude Code、および curl の基本的な使用例が含まれます。