mcpField
E
ebay-research

ebay-research

github.com/crawlora-org生产力139 次安装4 天前更新
代码仓库

关于 ebay-research

ebay-research 是面向电商调研的技能，通过 Crawlora API 搜索 eBay 刊登、查看商品详情并评估卖家。数据以规范化 JSON 返回，不依赖 HTML 抓取。

主要功能

  1. 01按关键词搜索商品刊登
  2. 02获取价格、成色和规格
  3. 03查看卖家资料与反馈
  4. 04分页浏览卖家店铺商品

适用场景

  1. 01比较 eBay 商品价格
  2. 02购买前核查卖家评分
  3. 03盘点卖家当前在售商品

安装

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

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

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

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

详细介绍

eBay 研究

通过 Crawlora API 搜索 eBay、获取商品详情并审核卖家——所有数据均为标准化 JSON， 无需抓取 HTML。

何时使用此技能

  • “X 在 eBay 上卖多少钱？”或“在 eBay 上查找 X 的商品。”
  • “获取这件 eBay 商品的详情”（价格、成色、规格）。
  • “这位 eBay 卖家可信吗？”/“获取卖家的反馈和评分。”
  • “这位 eBay 卖家的店铺里有什么？”
  • 针对 eBay 的竞品定价或商品信息研究。

设置（一次性）

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

工作原理

  1. 搜索 — 使用包含 keyword 的扁平 JSON 请求体调用 POST /ebay/search，按关键词查找候选商品。
  2. 商品详情 — 使用 GET /ebay/item/{item_id} 获取特定商品的价格、成色和规格。
  3. 卖家资料 — 使用 GET /ebay/seller/{seller} 获取卖家的简介资料，并使用 GET /ebay/seller/{seller}/about 获取统计数据、顶级卖家状态和店铺类别。
  4. 卖家反馈 — 使用 GET /ebay/seller/{seller}/feedback（通过 page/per_page 分页）获取反馈摘要、详细评分和近期评价卡片。
  5. 卖家店铺 — 使用 GET /ebay/seller/{seller}/shop（通过 page 分页）列出卖家当前正在出售的所有商品。

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

调用 API

# Search eBay (POST, JSON body):
scripts/crawlora.sh -X POST /ebay/search '{"keyword":"mechanical keyboard"}' | jq '.'

# Item detail:
scripts/crawlora.sh /ebay/item/1234567890 | jq '.data'

# Seller feedback (paginated):
scripts/crawlora.sh /ebay/seller/some-seller/feedback page=1 per_page=20 | jq '.'

所有请求均使用 scripts/crawlora.sh；这样 API 密钥不会出现在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 eBay 端点（方法、路径、参数、说明）。

示例

  • 价格查询： 使用 {"keyword":"..."} 调用 POST /ebay/search，收集某个关键词对应的候选商品及其价格。
  • 卖家尽职调查： 结合 /ebay/seller/{seller}/about 和 /ebay/seller/{seller}/feedback，在购买前总结卖家的顶级卖家状态、评分明细和近期反馈。
  • 店铺审查： 使用 /ebay/seller/{seller}/shop（通过 page 分页）列出卖家当前正在出售的所有商品。

说明与限制

  • 额度 / 成功后计费： 仅在返回 2xx 时计费；免费套餐每月有 2,000 个额度。 在 https://crawlora.net 获取密钥。
  • 仅限公开数据 — 公开的商品和卖家页面；请遵守 eBay 的条款。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、作为查询参数传递或提交到代码库。
  • /ebay/search 使用扁平字段（如 keyword、page 和 limit）进行 POST 请求；MCP 参数名 option 并非 REST JSON 包装对象。
  • 反馈和店铺商品采用分页方式——传入 page（反馈还需传入 per_page）以获取第一页之后的内容。

评论

支持 Markdown