pp-trustpilot

Trustpilot — Printing Press CLI

前提条件：CLI をインストールする

このスキルは trustpilot-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールします。

1. Printing Press インストーラーを使ってインストールします。デフォルトのバイナリ配置先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install trustpilot --cli-only
   

2. 確認します：trustpilot-pp-cli --version
3. 表示されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を使った直接インストールに切り替えます（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/marketing/trustpilot/cmd/trustpilot-pp-cli@latest

インストール後に --version が「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場合

エージェントやリサーチャーが、企業のドメインまたは名前を指定して消費者レビューを取得する必要がある場合は、Trustpilot CLI を利用してください。調査内容に最近の良いレビューと悪いレビューの両方を加えてバランスの取れた情報を提供する、TrustScore の経時的な変化を追跡する、1 回の呼び出しで複数の企業を比較する、または同期済みレビューを星評価や日付で絞り込んで用語（refund、chargeback）を検索する用途に最適です。ストーリーの情報を補強する場合は、last30days と組み合わせると便利です。

この CLI を使用しない場合

作成、更新、削除、公開、コメント、賛成投票、招待、注文、メッセージ送信、予約、購入、またはリモート状態の変更が必要なリクエストには、この CLI を使用しないでください。この印刷版 CLI が提供するのは、調査、エクスポート、同期、分析のための読み取り専用コマンドです。

独自の機能

この API に対して、これらの機能を利用できるほかのツールはありません。

last30days エージェントブリッジ

• top-recent — ある企業について、最も新しい星 4～5 のレビューを N 件、最も新しい星 1～2 のレビューを N 件、1 回の呼び出しで取得します。これにより、エージェントは別々に 2 回スクレイピングすることなく、バランスの取れた見解を引用できます。

  過去 30 日間に消費者が企業についてどのような意見を述べているかをエージェントが要約する場合、バランスの取れた引用可能なサンプルを返すのはこのコマンドだけです。

  trustpilot-pp-cli top-recent thriftbooks.com --window 30d --good 5 --bad 5 --json
  

• agent-bundle — 企業のメタデータ、TrustScore、Trustpilot 独自の AI 要約、最近の良いレビューと悪いレビューの上位レビュー、および 5 区分の評価ヒストグラムをまとめた単一の JSON ペイロードを返します。外部エージェントに必要な情報を 1 回の呼び出しですべて取得できます。

  別のエージェントから Trustpilot コマンドを 1 つだけ呼び出すなら、このコマンドを使ってください。last30days のようなストーリーの情報補強に特化しています。

  trustpilot-pp-cli agent-bundle thriftbooks.com --json --select company.trustScore,company.numberOfReviews,topRecent.good,topRecent.bad,histogram
  

蓄積されたローカル状態

• drift — ローカルに同期されたレビューから再構成した、週ごとのTrustScore、星1の割合、星5の割合、レビュー件数です。Trustpilotが公開しているのは現在のTrustScoreのみですが、この機能で履歴を確認できます。

  企業の評判が改善している、または悪化していると主張する前に使用してください。1回のクエリで、星の内訳を含む週ごとの推移を確認できます。

  trustpilot-pp-cli drift thriftbooks.com --weeks 12 --json
  

• compare — ローカルに同期されたストアから読み取った、選択した期間におけるN社のTrustScore、レビュー投稿ペース、星1／星5の割合を並べて比較します。

  ベンダーを推奨したり、比較記事を執筆したりする前の市場分析に最適なコマンドです。

  trustpilot-pp-cli compare thriftbooks.com bookshop.org powells.com --window 90d --json
  

• surge — ローカルに同期されたデータ行を対象に、Zスコアを用いて、総レビュー件数または星1の件数が移動ベースラインに対して統計的に有意な急増を検出します。

  企業について公開する前に実行してください。新たな星1レビューの急増は、見逃してしまう可能性のある見出しになります。

  trustpilot-pp-cli surge thriftbooks.com --baseline 90d --window 7d --stars 1 --json
  

• search-reviews — 同期されたレビューのタイトル、本文、企業からの返信を全文検索します。星評価、言語、日付で絞り込めます。FTS5を利用しており、オフラインで動作します。

  「過去90日間に、返金について星1のレビュー投稿者は何と言っていたか」という質問に答えられるのは、このコマンドだけです。

  trustpilot-pp-cli search-reviews thriftbooks.com 'refund' --stars 1 --window 90d --lang en --json
  

• replies — 同期されたレビューを星評価の区分ごとに集計した返信率と、--unrepliedを指定した場合は未返信の星1レビュー一覧を表示します。

  星1レビューを無視する企業は、カスタマーサポートの問題を予測する手がかりになります。これを1行で監査できるコマンドです。

  trustpilot-pp-cli replies thriftbooks.com --unreplied --stars 1 --json
  

• geo — 指定期間のレビュー投稿者の国別分布を、国ごとの件数、平均評価、星1の割合とともに表示します。

  地域によって顧客の評価が異なる場合に使用してください。国別の内訳は、地域限定の問題を示す最初の兆候になります。

  trustpilot-pp-cli geo thriftbooks.com --window 90d --json
  

• whats-new — 前回の同期以降に届いたレビューを星評価ごとに分類して一覧表示します。これにより、エージェントはすべてを再取得せずに、新しい顧客フィードバックを確認できます。

  全アーカイブではなく差分を取得したい、定期実行エージェントに最適です。

  trustpilot-pp-cli whats-new thriftbooks.com --since 2026-05-01 --json
  

Trustpilot ネイティブのエンリッチメント

• topics — Trustpilot独自の、事前計算済みトピックAIサマリー（例：「配送」「価格」「状態」）をJSON形式で表示します。

  レビュー投稿者が実際に話題にしている内容をラベル付きのクラスターで確認したい場合、Trustpilotがすでにクラスタリングを行っています。この機能でその結果を確認できます。

  trustpilot-pp-cli topics thriftbooks.com --json
  

• similar-sweep — Trustpilotが企業に対して返す「類似企業」8社を取得し、各社の情報を並列に取得して、TrustScoreとレビュー総数で順位付けします。

  指標付きで競合企業を自動検出できるため、見込み客の開拓や、まだ選定していない競合リストの作成に最適です。

  trustpilot-pp-cli similar-sweep thriftbooks.com --json
  

• category-top — Trustpilotのカテゴリー内の企業を、TrustScore順に順位付けします（レビュー数の最低基準も任意で指定できます）。

  「Trustpilotでレビューが100件以上ある、最も評価の高いオンライン書店」を探すなら、このクエリを使ってください。

  trustpilot-pp-cli category-top online-bookstore --limit 25 --min-reviews 100 --json
  

HTTP トランスポート

このCLIは、ブラウザー向けエンドポイントにChrome互換のHTTPトランスポートを使用します。通常のAPI呼び出しに常駐ブラウザープロセスは必要ありません。

コマンドリファレンス

companies — Trustpilotで企業名を検索し、正規ドメインを特定します

• trustpilot-pp-cli companies <search_build_id> — 名前に一致する企業を検索します。一致する企業のidentifyingNameドメインを返します。このドメインはreviews-fetchで使用できます

reviews — 企業のTrustpilotレビューを取得します

• trustpilot-pp-cli reviews <review_build_id> <domain> — ドメインを指定して企業のレビューを1ページ分取得します（CLIでは'reviews-fetch 'を使用してください）。認証方法は次のとおりです...

適切なコマンドを見つける

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLIに直接尋ねてください。

trustpilot-pp-cli which "<capability in your own words>"

whichは、自然言語で指定した機能に関する問い合わせを、このCLIの厳選された機能インデックスから最適なコマンドに解決します。終了コード0は1つ以上の一致があることを示し、終了コード2は確信を持って一致するものがないことを示します。その場合は--helpを使うか、より具体的な問い合わせをしてください。

レシピ

last30days の直近30日間のバランスの取れたサンプル

trustpilot-pp-cli top-recent www.thriftbooks.com --window 30d --good 5 --bad 5 --json

1回の呼び出しで、最新の好意的なレビュー5件と否定的なレビュー5件を取得できます。ストーリーに引用できる標準的なサンプルです。

1回の呼び出しでエージェント向けの情報をまとめて取得（最も効率的）

trustpilot-pp-cli agent-bundle www.thriftbooks.com --json --select company.trustScore,company.numberOfReviews,topRecent.good,topRecent.bad,histogram,aiSummary

情報、最新レビュー、AI による要約、ヒストグラムを1つのペイロードにまとめます。--select を使うと、深くネストされたフィールドを含む場合でも、レスポンスを数 KB に抑えられます。

12週間の信頼スコアと1つ星評価の推移

trustpilot-pp-cli drift www.thriftbooks.com --weeks 12 --json

同期済みのレビューから週ごとの TrustScore を再構築し、Trustpilot のサイトには表示されない変曲点を見つけます。

競合3社を比較して月曜日の市場動向を調査

trustpilot-pp-cli compare www.thriftbooks.com bookshop.org powells.com --window 90d

ローカルストアから取得した、対象グループ各社の TrustScore、レビュー投稿ペース、1つ星／5つ星の割合を並べて比較します。

同期済みの1つ星レビューから返金に関する苦情を検索

trustpilot-pp-cli search-reviews www.thriftbooks.com 'refund' --stars 1 --window 90d --lang en --json

FTS5 クエリです。同期が最新であればオフラインで動作します。--select rating,title,publishedAt,text と組み合わせると、出力を絞り込めます。

認証の設定

認証は不要です。

trustpilot-pp-cli doctor を実行して、設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ接続可能 — JSON は標準出力に、エラーは標準エラー出力に出力されます

• フィルタリング可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。出力量の多い API でコンテキストを小さく保つのに重要です。

  trustpilot-pp-cli companies mock-value --query example-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run で、リクエストを送信せずに内容を確認できます

• オフラインに対応 — 同期／検索コマンドは、ローカルの SQLite ストアが利用可能な場合に使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をデータの取得元を示すエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、ライブデータかローカルデータかの確認には .meta.source を解析してください。人間が読みやすい N results (live) の概要は、標準出力がターミナルであり、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が指定されていない場合にのみ、標準エラー出力に表示されます。パイプ／エージェントからの利用や、明示的に形式を指定した実行では、標準出力には JSON のみが出力されます。

エージェントからのフィードバック

この CLI について気になる点があれば、あなた（またはエージェント）が記録してください。

trustpilot-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
trustpilot-pp-cli feedback --stdin < notes.txt
trustpilot-pp-cli feedback list --json --limit 10

エントリは ~/.trustpilot-pp-cli/feedback.jsonl にローカル保存されます。TRUSTPILOT_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されているか、TRUSTPILOT_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1行で記録してください。積み重ねにつながるのは、そうした内容です。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて、または標準出力の代わりに、指定されたシンクに送られます。エージェントは手動でパイプ接続しなくても、コマンドの結果を振り分けられます。対応しているシンクは3種類です。

シンク	効果
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル＋名前変更）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応するスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを標準エラー出力に記録します。

名前付きプロファイル

プロファイルは、保存して繰り返し使用できるフラグ値のセットです。スケジュール実行されるエージェントが、毎回同じ設定で同じコマンドを呼び出す場合に使用します。HeyGen の「Beacon」パターンに相当します。

trustpilot-pp-cli profile save briefing --json
trustpilot-pp-cli --profile briefing companies mock-value --query example-value
trustpilot-pp-cli profile list --json
trustpilot-pp-cli profile show briefing
trustpilot-pp-cli profile delete briefing --yes

明示的に指定したフラグは、常にプロファイルの値より優先されます。プロファイルの値はデフォルト値より優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles に一覧表示するため、実行時にプロファイルを確認するエージェントが検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → trustpilot-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合 → MCP のインストール、それ以外の場合 → 上記の前提条件を参照します
3. それ以外 → 直接使用（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

この CLI の公開ライブラリエントリーまたはビルド済みリリースから MCP バイナリをインストールし、登録します：

claude mcp add trustpilot-pp-mcp -- trustpilot-pp-mcp

確認します：claude mcp list

直接使用

1. インストール済みか確認します：which trustpilot-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを指定して実行します：

   trustpilot-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：trustpilot-pp-cli <command> --help。