fiverr-research

Fiverr 研究

搜索 Fiverr 商品，获取商品完整的定价、套餐和评分详情，并查询卖家资料——所有数据均由 Crawlora API 提供，且为规范化 JSON，无需手动抓取 Fiverr 页面。

适用场景

• “查找提供 <skill/service> 的 Fiverr 商品。”——按关键词搜索商品。
• “比较这些商品的定价和套餐。”——获取每个商品的完整详情。
• “这位 Fiverr 卖家是谁？靠谱吗？”——查询卖家资料。
• “这位卖家还提供什么服务？”——查看卖家资料中的商品列表，再获取相关商品的详情。
• “Fiverr 上 的行情价是多少？”——搜索并收集结果中的起步价。

设置（仅需一次）

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

工作原理

1. 搜索 — /fiverr/search 接受自由文本关键词（q），并返回规范化的商品摘要：标题、卖家用户名、卖家等级、评分、评价数量、起步价、类别和缩略图。使用 page 翻页。
2. 商品详情 — 获取搜索结果中的卖家用户名和商品 slug，并调用 /fiverr/gig/{username}/{slug} 获取完整页面信息：描述、定价套餐（基础版／标准版／高级版的价格和交付时间）、评分、评价数量、排队订单、标签、图库图片，以及卖家摘要（等级、评分、响应时间、语言）。
3. 卖家资料 — /fiverr/seller/{username} 返回卖家的显示名称、一句话标题、描述、国家、卖家等级、验证状态、时薪、语言、加入日期和卖家商品 ID，适用于尽职调查或列出卖家提供的所有服务。

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

调用 API

# Search gigs:
scripts/crawlora.sh /fiverr/search q="logo design" | jq '.'

# Pull one gig's full detail (username + slug from a search result):
scripts/crawlora.sh /fiverr/gig/johndoe/i-will-design-a-modern-logo | jq '.'

# Look up the seller behind a gig:
scripts/crawlora.sh /fiverr/seller/johndoe | jq '.'

所有请求都使用 scripts/crawlora.sh；该脚本不会将 API 密钥暴露在命令行参数中。

端点参考

所有本技能使用的 Fiverr 端点，请参见 reference/endpoints.md。

示例

• 比较商品： 使用 /fiverr/search 搜索服务，然后对排名靠前的结果调用 /fiverr/gig/{username}/{slug}，并排比较套餐定价、交付时间和评分，再给出推荐。
• 卖家尽职调查： 调用 /fiverr/seller/{username} 检查卖家等级、验证状态、加入日期和语言，然后对其商品列表中的商品调用 /fiverr/gig/{username}/{slug}，查看评价数量和排队订单。

备注和限制

• 积分／成功后付费： 仅对 2xx 响应计费；免费套餐每月 2,000 个积分。获取密钥：https://crawlora.net。
• 仅限公开数据 — 公开的商品和卖家页面；请遵守 Fiverr 的条款。
• 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、设为查询参数或提交到代码库。
• 商品详情需要同时提供 username 和 slug — slug 是商品 URL 中用户名之后的路径段，而不只是商品 ID；请从 /fiverr/search 结果的 seller_username 字段获取两者，不要猜测。
• /fiverr/search 的结果采用分页方式返回 — 传入 page 遍历完整列表。