Trustpilot Reviews API

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install trustpilot-reviews-api
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 trustpilot-reviews-api。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Trustpilot Reviews API 将 Openclaw Skills 连接到 Scavio 的 Trustpilot 数据端点，帮助智能体以结构化 JSON 的形式获取商家评分、评论详情、已公开的联系信息、类别排名和商家资料摘要。可用于商家发现、声誉研究、竞争情报和客户之声分析。
此技能支持六种操作：搜索商家、获取完整商家资料、筛选评论页面、浏览类别、按类别查看排名商家，以及查询单条评论。每次 API 调用消耗 2 个额度；新注册的 Scavio 账户包含 50 个免费额度，可供入门使用。

应用场景

按名称、关键词或类别，在指定国家/地区查找 Trustpilot 商家。
查看公司的 TrustScore、星级评分、评论数量、评分分布和已公开的联系详情。
按星级、语言、日期范围、主题、文本、验证状态或商家回复分析评论。
衡量负面评论数量、商家回复率、平均响应时间和近期评论增长速度。
获取 Trustpilot 为商家资料提供的 AI 摘要和主题分类（如有）。
利用评论和商家资料数据比较或监控品牌及其竞争对手。
根据类别建立潜在客户名单，并在可用时包含已公开的网站、电子邮件和电话号码。
按 ID 获取特定评论，包括商家的回复及相关商家信息。

工作原理

在 SCAVIO_API_KEY 环境变量中配置 Scavio API 密钥。
按关键词和国家/地区搜索商家；如果用户已提供域名或 Trustpilot 商家资料 URL，则可跳过发现步骤。
请求商家资料，以获取评分、评论分布、回复情况、可用的 AI 摘要和主题，以及所请求语言中最新的最多 20 条评论。
请求经过筛选的评论页面以进行深入分析。按主题筛选时，使用商家资料中的主题 ID，并在翻页前检查 max_page。
进行类别研究时，获取类别树或搜索类别，然后查询所选类别中的排名商家。
如需更多详情，使用 24 个字符的 ID 获取单条评论。
返回 API 数据及其来源 URL，说明适用的限制；如果需要进行历史比较，请在外部追踪快照。

配置指南

在 https://dashboard.scavio.dev/sign-up 创建 Scavio 账户。注册可自行完成，无需银行卡，并可获得 50 个初始额度。
从控制面板的 API Keys 部分复制 API 密钥，并在智能体所用的环境中导出：
export SCAVIO_API_KEY=sk_live_your_key
向 https://api.scavio.dev 发送带有 JSON 请求体和 Bearer authorization 标头的 POST 请求。每次调用 Trustpilot 端点消耗 2 个额度。
curl -X POST https://api.scavio.dev/api/v1/trustpilot/reviews \ -H "Authorization: Bearer $SCAVIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"nordvpn.com","stars":[1,2],"language":"en"}' 可选 SDK：使用 pip install scavio==0.19.1 安装文档中说明的 Python 软件包，或使用 npm install scavio@0.19.0 安装 JavaScript 软件包。客户端会从环境中读取 SCAVIO_API_KEY。
可选 MCP 集成：安装 @scavio/mcp-server，并设置 SCAVIO_PLATFORMS，使其包含 trustpilot，从而启用 Trustpilot 工具。

数据架构

所有端点均返回一个包含 data、response_time、credits_used 和 credits_remaining 的封装对象。各端点特有的 data 载荷按如下方式组织结果：
端点 主要数据字段
搜索 查询和国家/地区元数据、分页总数，以及包含名称、域名、TrustScore、星级、评论数量、类别、网站、已公开联系详情、地址和验证状态的 businesses[]。
商家 商家资料标识信息、TrustScore、星级、评论数量、rating_distribution、语言数量、类别路径、联系详情、验证和认领状态、reply_behavior、消费者提醒、ai_summary、topics[]、类似商家，以及最多 20 条近期评论。
评论 商家标识信息、已应用的筛选条件、页面元数据、total_filtered、max_page，以及包含评论文本、评分、日期、验证详情、消费者数据和可选商家回复的 reviews[]。
类别 包含类别 ID、名称和子类别的类别树；或者按名称搜索时返回的匹配类别扁平列表。
类别商家 类别元数据、国家/地区、分页信息、已应用的筛选条件、商家数量和排名后的 businesses[]。
评论详情 单条评论对象，以及用于标识相关商家的精简商家对象。
此技能不会生成本地数据文件。如果需要历史追踪，请将 API 结果或定期的商家资料快照保存在自己的存储中；API 不提供 TrustScore 历史记录。若商家未公开联系信息，相应字段可能为 null；所请求语言的 AI 摘要或主题也可能不可用。

高级特性

组合使用星级、语言、日期范围、主题、文本、验证状态和商家回复等评论筛选条件；按最新程度或相关性排序结果。
使用日期范围筛选条件，根据
total_filtered
计算评论增长速度，无需翻阅所有匹配评论。
将商家资料快照存储在外部，以便进行可重复的监控；API 本身不提供 TrustScore 历史记录。
使用类别排名筛选条件设置排序方式、最低星级和仅显示已认领的商家资料。
通过 Scavio Python 或 JavaScript SDK、直接 HTTP 请求，或 Scavio MCP server 的六个 Trustpilot 工具进行集成。
遵守分页和预算限制：每组筛选条件的评论结果最多为 10 页，每页 20 条；每页消耗 2 个额度。按
review_id
去重重叠的日期范围。
明确处理 API 错误：401 时检查凭据，402 时检查额度，400 时检查参数；收到 429、502 或 503 响应时，等待后再重试。
使用返回的 Trustpilot 商家资料和评论 URL 进行验证；绝不可推断未公开的联系详情，也不可捏造评分、数量、评论文本或回复。

name: trustpilot-reviews-api description: Trustpilot data as structured JSON - business search with TrustScore and published contact details, full business profiles with rating distribution, reply rate and AI summary, filtered review pages, the category tree, ranked businesses per category, and single reviews. 6 endpoints, 2 credits each. version: 1.0.0
tags: trustpilot, trustpilot-api, trustpilot-reviews, trustpilot-reviews-api, trustscore, reviews, review-mining, reputation-management, brand-monitoring, voice-of-customer, sentiment-analysis, lead-generation, business-search, business-data, competitive-intelligence, agents, ai-agents, structured-data, json, mcp