mcpField
C
costco-research

costco-research

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

关于 costco-research

通过 Crawlora API 查询和比较 Costco 商品、分类、配送情况、仓库及评价，并以规范化 JSON 返回，适用于商品研究和购买前核查。

主要功能

  1. 01浏览商品分类
  2. 02搜索商品并查看详情
  3. 03按邮编查询配送情况
  4. 04获取商品评价
  5. 05查找附近仓库

适用场景

  1. 01确认商品是否可配送
  2. 02比较某分类的价格和评分
  3. 03购买前查看商品评价
  4. 04查找附近的仓库

安装

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

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

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

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

详细介绍

Costco 研究

查询和比较 Costco 的产品、类别、配送情况、附近仓库和评价——所有数据均由 Crawlora API 提供，并以规范化 JSON 返回，无需抓取 HTML。

何时使用此技能

  • “Costco 上的 X 多少钱？”或“在 Costco 上找这个产品。”
  • “这件 Costco 商品有库存吗／什么时候能配送到邮编 {postal_code}？”
  • “Costco 上有哪些类别符合 {keyword}？”／“浏览 Costco 的 {category}。”
  • “获取这件 Costco 商品的评价／评分。”
  • “查找距离 {latitude}、{longitude} 最近的 Costco 仓库。”

设置（仅需一次）

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

工作原理

  1. 浏览类别 — /costco/categories 返回 Costco 类别 slug 和商品数量，还可按搜索词限定范围；每个 slug 都可直接用作 /costco/search 的 category 筛选条件。
  2. 搜索 — /costco/search 根据 query 和／或 category slug 查找候选商品：返回每个结果的标题、品牌、型号、图片和评分。
  3. 详情 — /costco/product/{id} 获取指定商品的标题、 描述、制造商、图片、价格、库存状态和评分。
  4. 可购情况 — /costco/product/{id}/availability 返回指定 postal_code 和 state 目的地的库存及预计配送状态。
  5. 评价 — /costco/product/{id}/reviews 返回一页商品评价：包含标题、 正文、评分、作者和推荐意见。
  6. 仓库 — /costco/warehouses 根据 latitude／longitude 查找附近的 Costco 仓库，并按距离排序。

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

调用 API

# Browse categories matching a term:
scripts/crawlora.sh /costco/categories query="patio furniture" | jq '.'

# Search products by query and/or category slug:
scripts/crawlora.sh /costco/search query="robot vacuum" | jq '.'

# Product detail, then availability at a ZIP/state:
scripts/crawlora.sh /costco/product/1234567 | jq '.data'
scripts/crawlora.sh /costco/product/1234567/availability postal_code=98101 state=WA | jq '.'

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

端点参考

此技能使用的所有 Costco 端点（方法、路径、参数、描述）请参见 reference/endpoints.md。

示例

  • 检查仓库库存： 使用 /costco/search 查找商品的 id，然后 使用购物者的 postal_code 和 state 调用 /costco/product/{id}/availability， 确认商品可以配送后再推荐。
  • 比较类别价格： 使用 /costco/categories 根据关键词确定类别 slug， 然后使用该 category 调用 /costco/search，列出符合条件的商品并比较价格／评分。
  • 购买前尽职调查： 使用 /costco/product/{id} 查看价格和库存 状态，并使用 /costco/product/{id}/reviews 汇总近期评分和 推荐意见，再决定是否购买。

注意事项和限制

  • 积分／成功后付费： 仅在响应为 2xx 时计费；免费层级每月 2,000 个积分。 在 https://crawlora.net 获取密钥。
  • 仅限公开数据 — Costco 公开页面；请遵守 Costco 的条款。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、放入查询参数或提交到代码库。
  • 可购情况仅限美国 — /costco/product/{id}/availability 需要美国的 postal_code 和两位字母的 state 代码；不支持查询美国以外的配送情况。
  • /costco/warehouses 需要一组 latitude／longitude，不能使用自由文本地址或邮编——如果只有地点名称，请先进行地理编码。

评论

支持 Markdown