搜索月销售额最高的 Shopify 店铺。
AI 工具 · 命令行 · 自动化脚本
PPSPY MCP 服务器与 CLI
Shopify 数据研究
研究 Shopify 店铺、热销商品与 Facebook 广告。
通过 MCP 连接 AI 客户端，或在终端直接查询 PPSPY 数据。
Shopify 店铺
商品
Facebook 广告
广告与销量监控
安装 PPSPY MCP 或 CLI
在 AI 客户端、终端或脚本中使用 PPSPY，选择适合你的接入方式。
开始前准备：Node.js 22+（含 npx）PPSPY API 密钥与额度你使用的 AI 客户端
Claude Desktop
桌面应用 · 本地 MCP 服务器
获取 PPSPY API 密钥
登录 PPSPY API 平台，获取 API 密钥，并确认账户具有所需数据的查询额度。
打开 API 服务 ↗打开桌面应用配置
在 Claude Desktop 中打开 Settings → Developer → Edit Config，将 PPSPY 条目合并到现有配置。
~/Library/Application Support/Claude/claude_desktop_config.json保存并检查连接
请将
YOUR_API_KEY替换为你自己的密钥。保存文件，完全退出并重新打开 Claude Desktop，确认可用工具中出现 PPSPY 工具。
{
"mcpServers": {
"ppspy": {
"command": "npx",
"args": ["-y", "ppspy-mcp-server"],
"env": { "PPSPY_API_KEY": "YOUR_API_KEY" }
}
}
}请妥善保管 API 密钥，将此条目合并到现有配置。
JSON 配置 · 软件包：
ppspy-mcp-serverClaude Desktop 官方指南 ↗不同版本的客户端菜单和配置格式可能有所差异，请参考上方对应的官方指南。
开始前准备：Node.js 20+ & npmPPSPY API 密钥与额度
PPSPY CLI
通过终端和自动化脚本调用 PPSPY API。
从 npm 安装 ppspy-cli
安装软件包后，运行
ppspy help查看可用命令。无需全局安装也可以运行
在 npm 查看 ppspy-cli ↗npx -y ppspy-cli help。设置 PPSPY API 密钥
请将
获取 API 密钥 ↗YOUR_API_KEY替换为你自己的密钥。此环境变量仅对当前终端会话生效。通过 CLI 搜索 Shopify 店铺
示例按月销售额排序查询 5 家店铺，运行
ppspy shopify-store list --help查看筛选和排序选项。API 查询会使用账户额度。帮助命令在本地运行，不会发起 API 请求。
npm install -g ppspy-cli
ppspy helpexport PPSPY_API_KEY="YOUR_API_KEY"ppspy shopify-store list --per_page 5 --order_by monthly_revenue --direction desc --prettynpm 软件包：
ppspy-cli · 命令： ppspyCLI 使用文档 ↗PPSPY CLI 通过开放平台 API 查询数据。如需在支持 MCP 的 AI 客户端中使用，请切换到上方 MCP 安装方式。
从一个问题开始
完成连接后，将示例提示词粘贴到 AI 客户端。
查找已持续投放超过 30 天的宠物商品 Facebook 广告。
列出我所有正在运行的销量监控任务。
以上是 PPSPY MCP 文档中的请求示例。实际结果以账户 API 返回为准；查询监控数据前需已有监控任务。
Shopify 选品与竞品研究
通过 AI 对话或直接执行 API 命令，查询 PPSPY 数据。
Shopify 店铺与竞品分析
按地区、语言、销售额、流量、主题和应用筛选店铺，获取店铺详情与流量信息。
ppspy_shopify_store_list · ppspy_shopify_store_detailsShopify 商品研究与选品
按价格、销量、类别和销售额筛选商品，查询指定店铺的热销商品。
ppspy_shopify_product_list · ppspy_shopify_bestselling_product_listFacebook 广告研究
在广告库中搜索广告、店铺和商品，获取广告详情、投放趋势与内容分析。
ppspy_advertisement_list · ppspy_ad_store_advertising_trendsShopify 销量追踪与广告监控
创建和管理监控任务，查询被监控店铺的任务详情、每日概览与销售记录。
ppspy_ad_monitor_task_list · ppspy_sales_monitor_task_listPPSPY MCP 与 CLI 常见问题
安装配置、Shopify 销量追踪、选品与 Facebook 广告分析。
什么是用于 Shopify 数据研究的 PPSPY MCP 服务器？
PPSPY MCP 将兼容的 AI 客户端连接到 PPSPY 的 Shopify 店铺、商品、Facebook 广告及监控数据，支持用自然语言进行竞品分析和选品研究。这些工具调用 PPSPY API，不提供 Shopify 店铺后台管理或主题部署功能。
如何在 Claude、Cursor 或 Codex 中查询 Shopify 数据？
在 MCP 安装指南中选择客户端，添加 ppspy-mcp-server 并设置 PPSPY_API_KEY。重启或刷新客户端，确认 PPSPY 工具可用后，即可搜索 Shopify 店铺或查询店铺热销商品。
如何从 npm 安装 PPSPY CLI？
安装 Node.js 20 或更高版本，运行 npm install -g ppspy-cli，再使用 ppspy help 查看命令。查询 API 前需设置 PPSPY_API_KEY。CLI 安装指南包含 macOS、Linux 和 Windows PowerShell 的配置命令。
不进行全局 npm 安装也能使用 PPSPY CLI 吗？
可以。运行 npx -y ppspy-cli help 查看命令，或在 npx -y ppspy-cli 后添加业务域与命令。需要 Node.js 20 或更高版本，API 查询仍需要 PPSPY API 密钥。
能否通过 MCP 或 CLI 追踪 Shopify 竞品店铺销量？
可以。PPSPY API 提供销量监控任务、销售记录及概览查询。请先创建或选择监控任务，再查询该店铺的监控数据。可查看 Shopify 销量追踪工具及其数据说明；可用范围受账户监控配额限制。
如何查找 Shopify 热销商品并进行 Dropshipping 选品？
使用 Shopify 商品搜索，按价格、类别、销量及销售额筛选，或查询指定店铺的热销商品。结合店铺和广告数据进行 Shopify 选品研究与 Dropshipping 商品对比。
能否通过 PPSPY 分析竞品的 Facebook 广告？
可以。搜索 Facebook 广告库、获取广告详情，分析店铺的投放趋势与广告内容。广告监控工具还可查询已创建的任务，可用范围受账户权限和配额限制。
使用 PPSPY MCP 和 CLI 是否需要 API 密钥或额度？
两者发起 API 请求都需要 PPSPY API 密钥。搜索查询和监控任务遵循 PPSPY API 的额度与配额规则。请在 PPSPY API 服务中获取密钥并查看当前计费说明。CLI 帮助命令不会发起 API 请求。
PPSPY MCP 无法连接 Claude 或 Cursor 时如何排查？
检查客户端是否能访问 Node.js 和 npx、配置格式是否正确，以及是否已替换 YOUR_API_KEY。重启 MCP 连接并查看客户端的服务器日志。安装面板提供对应客户端的官方指南链接。
能否在网页版 ChatGPT 或 Claude 中使用 PPSPY MCP？
本页安装示例通过 npx 启动本地 MCP 服务器。需要远程 MCP 的网页客户端，必须另行部署服务端点并配置适当的身份验证。本页不提供托管连接器地址。