Periskop MCP, Product Discovery For AI Agents

Periskop — 面向 AI Agent 的商品发现

面向 AI Agent 的商品发现。一次 MCP 调用即可将自然语言购物意图转化为结构化、排序后的商品结果——精选商品、替代品、组合商品、注意事项、价格和商家链接，覆盖开放商家网络上的各类独立商店。

Periskop 是托管式远程 MCP 服务（闭源）。使用 Periskop API 密钥即可通过公开的 HTTPS 端点连接——无需安装或运行任何东西。它是 Agent 商业的发现层：Agent 用自然语言提出需求，Periskop 则返回排序后的商品及指向商家的链接。服务仅止于商品发现——不提供结账、支付或下单功能。

• 网站： https://periskop.ai
• 开发者门户 / 获取 API 密钥： https://periskop.ai/developer
• 文档： https://periskop.ai/developer/docs
• MCP 端点： https://mcp.periskop.ai/v1/mcp（Streamable HTTP，JSON-RPC 2.0）

适用对象

任何需要将意图转化为可靠商品结果、但不想拥有结账流程的产品——Agent 平台和编排器、AI 工作平台、AI 购物助手、浏览器 Agent、商业副驾驶、推荐系统、采购和 B2B 供应商寻源工作流、价格和优惠监控工具、补货 / 重购机器人、礼品应用、转售和套利工作流，以及无障碍购物工具。具体来说，可以是规划露营旅行并返回所需装备的 Agent、比较不同供应商选项的采购副驾驶，或是根据一句话推荐合适商品的语音助手。

功能与非功能

Periskop 仅返回商品结果和商家链接。它不会完成结账、创建商家购物车、处理付款、预留库存或购买商品。 用户始终需要在商家自己的网站上完成购买。每个响应都包含一个 purchase_boundary 区块，重申这一点。

连接

端点	https://mcp.periskop.ai/v1/mcp
传输方式	Streamable HTTP — 通过 HTTP POST 使用 JSON-RPC 2.0（每次 POST 返回一个 JSON 响应；不使用 SSE）
线上协议	2024-11-05
身份验证	Authorization: Bearer <YOUR_PERISKOP_API_KEY>（密钥格式为 dp_…）
获取密钥	https://periskop.ai/developer

未通过身份验证的请求会收到带有 WWW-Authenticate: Bearer 标头的 401 响应。

注意：Periskop 也支持 OAuth 2.1（Authorization Code + PKCE），供偏好此方式的主机使用（令牌格式为 dpo_…）。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

报告结果是好、差还是一般。

Field	Type	Required
result_id	string	✅
rating	string (good | bad | mixed)	✅
reason	string | null
selected_product_id	string | null
freeform_feedback	string | null

suggest_store_coverage

建议 Periskop 今后支持的商店/商家/市场平台。不计费。 不会搜索或抓取该商店，也不保证今后会提供支持。

Field	Type	Required
store_name	string	✅
store_url	string | null
country / region / category	string | null
context	string | 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 示例。