feat: add 23 new CLI tools and integration guides

New tools across 13 categories: - Email/Newsletter: beehiiv, klaviyo, postmark, brevo, activecampaign - Data Enrichment: clearbit, apollo - CRO/Testing: hotjar, optimizely - Analytics: plausible - Scheduling: calendly, savvycal - Forms: typeform - Messaging: intercom - Social: buffer - Video: wistia - Payments: paddle - Affiliate: partnerstack - Reviews: trustpilot, g2 - Push: onesignal - Webinar: demio, livestorm Each tool includes a zero-dependency CLI and integration guide. Registry and CLI README updated with all new entries. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 11:28:41 -08:00
parent 8dba2d53de
commit 3a85964305
48 changed files with 11057 additions and 23 deletions
@@ -0,0 +1,191 @@
+# Trustpilot
+
+Business review management platform for collecting, managing, and showcasing customer reviews.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Business Units, Reviews, Invitations, Tags |
+| MCP | - | Not available |
+| CLI | ✓ | [trustpilot.js](../clis/trustpilot.js) |
+| SDK | ✓ | Node.js (official), community wrappers |
+
+## Authentication
+
+- **Type**: API Key (public endpoints) + OAuth 2.0 (private endpoints)
+- **Public Header**: `apikey: {YOUR_API_KEY}`
+- **Private Header**: `Authorization: Bearer {access_token}`
+- **OAuth Grant**: Client Credentials (`Basic base64(API_KEY:API_SECRET)`)
+- **Token Lifetime**: Access tokens expire after 100 hours, refresh tokens after 30 days
+- **Get credentials**: https://businessapp.b2b.trustpilot.com/ > Integrations > API
+
+## Common Agent Operations
+
+### Search for a business unit
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/search?query=example.com&limit=10
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### Get business unit details
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/{businessUnitId}
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### Get business profile info
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/{businessUnitId}/profileinfo
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### List public reviews
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/{businessUnitId}/reviews?perPage=20&orderBy=createdat.desc
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### List private reviews (with customer data)
+
+```bash
+GET https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/reviews?perPage=20
+
+Headers:
+  Authorization: Bearer {access_token}
+```
+
+### Reply to a review
+
+```bash
+POST https://api.trustpilot.com/v1/private/reviews/{reviewId}/reply
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "message": "Thank you for your feedback!"
+}
+```
+
+### Send email invitation
+
+```bash
+POST https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/email-invitations
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "consumerEmail": "customer@example.com",
+  "consumerName": "Jane Doe",
+  "referenceNumber": "order-123",
+  "redirectUri": "https://example.com/thanks"
+}
+```
+
+### Generate review invitation link
+
+```bash
+POST https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/invitation-links
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "email": "customer@example.com",
+  "name": "Jane Doe",
+  "referenceId": "order-123",
+  "redirectUri": "https://example.com/thanks"
+}
+```
+
+### List invitation templates
+
+```bash
+GET https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/templates
+
+Headers:
+  Authorization: Bearer {access_token}
+```
+
+### Add tags to a review
+
+```bash
+PUT https://api.trustpilot.com/v1/private/reviews/{reviewId}/tags
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "tags": [{ "group": "sentiment", "value": "positive" }]
+}
+```
+
+## Key Metrics
+
+### Business Unit Metrics
+- `numberOfReviews` - Total review count
+- `trustScore` - Overall trust score (1-5)
+- `stars` - Star rating displayed
+- `status` - Claim status (claimed, unclaimed)
+
+### Review Metrics
+- `stars` - Individual review star rating (1-5)
+- `language` - Review language code
+- `createdAt` - Review creation timestamp
+- `isVerified` - Whether the review is verified
+- `status` - Review status (active, reported, flagged)
+
+## Parameters
+
+### Review Filters
+- `stars` - Filter by star rating (1-5)
+- `language` - Filter by language code (e.g., `en`)
+- `orderBy` - Sort order (`createdat.desc`, `createdat.asc`, `stars.desc`, `stars.asc`)
+- `perPage` - Results per page (max 100)
+
+### Invitation Parameters
+- `consumerEmail` - Recipient email (required)
+- `consumerName` - Recipient name (required)
+- `referenceNumber` - Order or transaction reference
+- `templateId` - Email template ID
+- `redirectUri` - URL to redirect after review submission
+- `senderEmail` - Custom sender email
+- `replyTo` - Custom reply-to address
+
+## When to Use
+
+- Collecting and managing customer reviews at scale
+- Automating post-purchase review invitation flows
+- Monitoring brand reputation and review sentiment
+- Responding to customer feedback programmatically
+- Showcasing TrustScore and reviews on marketing pages
+- Tagging and categorizing reviews for analysis
+
+## Rate Limits
+
+- Recommended: no more than 833 calls per 5 minutes (10K/hour)
+- Throttled at more than 1 request per second
+- Rate limit headers returned in responses
+- Use webhooks instead of polling where possible
+
+## Relevant Skills
+
+- reputation-management
+- customer-feedback
+- review-generation
+- social-proof
+- post-purchase-flow