mcpField
S
shopify-research

shopify-research

github.com/crawlora-org其他141 次安装今天更新
代码仓库

关于 shopify-research

shopify-research 是通过 Crawlora 标准化 JSON API 研究公开 Shopify 店铺的技能，适用于目录、页面、站点地图、搜索和推荐查询。它支持任意店铺域名，并为 14 个指定品牌提供预配置端点。

主要功能

  1. 01浏览商品和系列
  2. 02获取商品与页面详情
  3. 03通过站点地图枚举 URL
  4. 04查询预测搜索建议
  5. 05获取相关商品推荐
  6. 06使用 14 个品牌专用端点

适用场景

  1. 01审查店铺目录和商品变体
  2. 02收集全店商品 URL
  3. 03查看店铺搜索建议
  4. 04分析商品交叉销售推荐

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill shopify-research

安装后在 Claude Code 中输入/shopify-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

Shopify 商店调研

查找并抓取由 Shopify 驱动的独立网店——商品、 系列、页面、站点地图、预测搜索和商品推荐—— 全部以 Crawlora API 返回的标准化 JSON 呈现，无需抓取 HTML。可 通过域名查询任何 Shopify 商店（不包括 Shop.app；有关该平台，请参阅单独的 shop-app-research 技能），另外还支持 14 个品牌网店，这些网店有专用端点，无需 url：Allbirds、Brooklinen、Cole Haan、 Everlane、Fashion Nova、Gymshark、J.Crew、Kylie Cosmetics、Oh Polly、Quince、 Rothy's、SKIMS、Steve Madden 和 The Body Shop。

工具范围和数据流

可选的 shell 助手是此技能要求运行的唯一命令。它只向文档中列出的允许使用的 Crawlora 路由发起 GET 请求。调用时，它会读取 CRAWLORA_API_KEY，并通过 HTTPS 将其作为 x-api-key 标头发送到 api.crawlora.net；不会将密钥发送到 Shopify 网店。它会在 TMPDIR 下短暂写入权限为 600 的 curl 配置文件，并在命令退出时将其删除。它不会检查其他环境变量、枚举文件、 安装软件或以提升的权限运行。网店 URL 会作为普通查询值传入；助手的目标主机固定不变。仅在 需要发起 Crawlora API 请求时运行它；成功的请求可能会消耗额度。

何时使用此技能

-“列出这个 Shopify 商店中的商品／系列。” -“这个 Shopify 商店的 /pages/about 页面上有什么内容？” -“抓取这个 Shopify 商店的站点地图，获取所有商品 URL。” -“这个 Shopify 商店对‘running shoes’的搜索建议是什么？” -“Shopify 会推荐哪些商品与这个商品搭配？”

  • Shopify 驱动的网站的商品目录审计、竞品商品组合调研或全站抓取。

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个额度，无需信用卡）。
  • 运行助手前，在环境中设置 CRAWLORA_API_KEY。
  • 助手会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时 → 401。

工作原理

每次调用都需要传入网店的 url（商店的公开域名，例如 https://example.myshopify.com，或自定义域名，例如 https://example.com），以及对应端点所需的参数：

  1. 解析商店 — /shopify/store 返回标准化的网店元数据；如果自定义域名屏蔽了 /products.json，则会回退到商店公开的 *.myshopify.com 域名。
  2. 浏览商品目录 — /shopify/collections 和 /shopify/products （支持分页，limit 最大为 250）可列出系列和商品；要查看某个系列中的商品，可使用 /shopify/collections/{handle}/products。
  3. 详情 — 使用 /shopify/products/{handle} 获取单个商品的完整详情。
  4. 推荐 — 使用 /shopify/products/{handle}/recommendations （intent=related|complementary）获取交叉销售／追加销售数据。
  5. 静态内容 — 使用 /shopify/pages 和 /shopify/pages/{handle} 获取商店的静态页面（正文 HTML 会以清理后的文本形式返回）。
  6. 站点地图抓取 — /shopify/sitemaps 列出子站点地图； /shopify/sitemap/urls（type=products|collections|pages|blogs|...） 返回其中数量受限的 URL 条目，可用于枚举整个商店，而无需对每个列表端点逐页查询。
  7. 搜索 — /shopify/search/suggest（q=，可选 types=）返回预测搜索的商品、系列和查询建议。
  8. 固定品牌商店 — 同样的操作也提供品牌前缀路由，无需 url 参数，例如 /allbirds/products、 /rothys/products/{handle}、/skims/sitemap/urls。用户直接指定这 14 个预设品牌之一时，请使用这些路由，而不是 /shopify/...?url=...。

完整端点列表、方法和参数：reference/endpoints.md。

调用 API

# Resolve store metadata:
scripts/crawlora.sh /shopify/store url="https://example.myshopify.com"

# List products / collections (paginated):
scripts/crawlora.sh /shopify/products url="https://example.myshopify.com" limit=100 page=1
scripts/crawlora.sh /shopify/collections url="https://example.myshopify.com"

# Crawl the sitemap for every product URL:
scripts/crawlora.sh /shopify/sitemap/urls url="https://example.myshopify.com" type=products limit=250

所有请求都使用 scripts/crawlora.sh；它可避免 API 密钥出现在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Shopify 端点（方法、路径、参数、说明），包括 14 个品牌固定镜像。

示例

  • 目录审计： 使用 /shopify/products（通过 page/limit 分页）列出店铺的完整目录，包括价格和变体，然后标记缺项或异常值。
  • 基于站点地图的完整抓取： 使用 /shopify/sitemaps 查找子站点地图，然后使用 /shopify/sitemap/urls?type=products 枚举所有商品 URL，无需遍历分页列表端点。
  • 搜索与推荐研究： 对查询使用 /shopify/search/suggest，查看店铺的预测搜索会展示哪些内容，然后使用 /shopify/products/{handle}/recommendations 映射商品之间的交叉销售链接。

注意事项与限制

  • 额度 / 成功后付费： 仅对 2xx 响应计费；免费套餐每月有 2,000 个额度。 可在 https://crawlora.net 获取密钥。
  • 仅限公开数据 — 仅抓取公开的店铺页面；请遵守各店铺的条款。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中 — 切勿将其硬编码、用作查询参数或提交到代码库。
  • 每次调用都必须提供 url — 店铺的公开域名（*.myshopify.com 或自定义域名）；没有默认店铺。
  • 结果会分页 — 遍历集合、商品和页面时，传入 page（以及受支持时的 limit，最多为 250）。
  • 商品/集合/页面查询需要使用 handle，而非数字 ID — 请先通过列表端点或站点地图抓取发现 handle。
  • 空结果页会返回带有空数组的 200，而非错误 — 检查数组长度以确定何时停止分页。

评论

支持 Markdown