trustpilot-company-info

# Trustpilot — Company Info

> Input a company domain (or list of domains) → output the company's Trustpilot profile: name, TrustScore, stars, review count, verification flags, category, contact info, and optional reply behavior metrics.

## Language

All process output to user (progress updates, process notifications) follows the user's language.

## Objective

Extract a single company's public Trustpilot profile data from `trustpilot.com/review/{domain}`. Designed to be called once per domain; chain calls or write a batch loop when enriching many domains.

## Prerequisites

- Target page is reachable on the public web: `https://www.trustpilot.com/review/{domain}`
- No login required — Trustpilot review pages are publicly accessible

## Pre-execution Checks

### 1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

## Capability Components

> This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.

### DOM: extract company profile (from SSR JSON embedded in the review page)

The Trustpilot review page is server-rendered with Next.js; the complete businessUnit record is embedded in `<script id="__NEXT_DATA__">`. Extraction reads this script directly — no separate API call required.

Steps:
1. `navigate https://www.trustpilot.com/review/{domain}` (replace `{domain}` with the company domain, e.g. `apple.com`, `shopwagandtail.com`)
2. `wait stable --timeout 30000`
3. `eval "$(python scripts/extract-company-info.py)"` — basic profile
4. `eval "$(python scripts/extract-company-info.py --include-response-metrics)"` — also include reply behavior + AI response flag

Parameters:
- `--include-response-metrics` (optional flag): adds `replyAverageDaysToReply`, `replyPercentage`, `totalNegativeReviewsCount`, `negativeReviewsWithRepliesCount`, `lastReplyToNegativeReview`, `companyUsesAIResponses`, `claimedDate`, `isAskingForReviews` to the output.

Output example (company found, with `--include-response-metrics`):
```json
{
  "isCompanyFound": true,                                    // false when domain has no Trustpilot page
  "company": "Wag + Tail",                                   // display name
  "businessUnitId": "624c24851220e2743a4d7916",              // Trustpilot internal ID
  "identifyingName": "shopwagandtail.com",                   // canonical domain on Trustpilot
  "rating": "4.7",                                           // TrustScore as string
  "trustScoreNumeric": 4.7,                                  // TrustScore as number
  "stars": 4.5,                                              // visual star rating
  "OfficialTotalReviewCount": 258,                           // total reviews (may include hidden)
  "numberOfReviewsLast12Months": 1,                          // rolling 12-month review count
  "isCompanyVerified": "yes",                                // "yes" if any verification flag is true, else "no"
  "verificationFlags": {                                     // breakdown of verification sources
    "verifiedByGoogle": false,
    "verifiedPaymentMethod": false,
    "verifiedUserIdentity": true
  },
  "isClaimed": true,                                         // claimed by the business owner
  "isClosed": false,
  "isTemporarilyClosed": false,
  "isCollectingReviews": false,
  "category": "Pet Store",                                   // primary category name
  "categoryId": "pet_store",
  "allCategories": [{ "id": "pet_store", "name": "Pet Store", "isPrimary": true }],
  "websiteUrl": "https://shopwagandtail.com",
  "websiteTitle": "shopwagandtail.com",
  "profileImageUrl": "//s3-eu-west-1.amazonaws.com/tpd/logos/624c24851220e2743a4d7916/0x0.png",
  "contactEmail": "sales@shopwagandtail.com",                // may be null
  "contactPhone": null,
  "contactCountry": "US",
  "contactCity": null,
  "contactAddress": null,
  "contactZipCode": null,
  "locationsCount": 0,
  "companyPageUrl": "https://www.trustpilot.com/review/shopwagandtail.com",
  "scrapedDateTime": "2026-06-26T04:12:17.272Z",
  "replyAverageDaysToReply": 0,                              // only when --include-response-metrics
  "replyPercentage": 0,
  "totalNegativeReviewsCount": 0,
  "negativeReviewsWithRepliesCount": 0,
  "lastReplyToNegativeReview": null,
  "companyUsesAIResponses": false,
  "claimedDate": "2022-04-05T13:54:41.000Z",
  "isAskingForReviews": false
}
```

Output example (company not found on Trustpilot):
```json
{
  "isCompanyFound": false,
  "companyPageUrl": "https://www.trustpilot.com/review/nonexistent-xyz-9999.com",
  "searchedDomain": "nonexistent-xyz-9999.com",
  "scrapedDateTime": "2026-06-26T04:13:45.151Z"
}
```

Error handling: when the `__NEXT_DATA__` script tag is missing or `businessUnit` is absent for a non-404 page, the script returns `{"error": true, "message": "..."}`. If this happens, confirm the page loaded fully (`wait stable`), then re-run. If the page is rate-limited or shows an anti-bot challenge, switch to a stealth browser with proxy and retry.

## Success Criteria

`isCompanyFound === true && company !== null && OfficialTotalReviewCount !== null && trustScoreNumeric !== null` — for an existing company; `isCompanyFound === false && searchedDomain !== null` — for a not-found domain.

## Known Limitations

- `OfficialTotalReviewCount` is Trustpilot's official count and may include reviews currently hidden by Trustpilot's filtering (deleted, flagged, machine-filtered). This is a platform-level characteristic, not a script bug.
- Reply be