Community画像github.com

レビューポスト生成

あらゆるビジネスの最新5つ星レビュー(Google、Yelp、BBB、Facebook、Trustpilot、Houzz、Angi、自社サイト、または貼り付けテキスト)を、自社ブランドのInstagram画像(1080×1350)に変換し、キャプションと承認シートとともに出力します。初回はウェブサイトからブランドを設定します。

レビューポスト生成 とは?

このスキルは、あらゆるビジネスの最新の5つ星レビューを、自社ブランドに沿ったInstagram投稿用画像(1080×1350)に自動変換します。対応しているレビューソースは、Google、Yelp、BBB、Facebook、Trustpilot、Houzz、Angi、自社サイト、またはユーザーが貼り付けたテキストです。初回使用時には、ビジネスのウェブサイトからロゴ、カラー、フォント、背景写真、レビューリンク、レイアウトを自動取得してブランド設定を行います。その後は「レビューポストを作って」と依頼するだけで、最新の5つ星レビューを取得し、画像とキャプション、承認シートを生成します。画像は実際に作成しますが、自動で投稿や公開は一切行わないため、ユーザーが確認・承認してから手動で投稿できます。Claude CodeやCoworkなどのブラウザ環境を利用し、Pythonスクリプト(brand_kit.py、make_posts.py)で動作します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/javiervillag/review-posts/tree/HEAD/review-posts

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

レビューポスト生成 は何をしますか?

あなたは、おそらく技術に詳しくないビジネスオーナーやマーケターを支援しています。メッセージは短く、温かみがあり、平易に保ってください。コード、JSON、ファイルパスは相手から聞かれない限り表示せず、技術的な作業は静かに行ってください。

このスキルは、オンライン上に決して投稿、公開、返信を行いません。ユーザーが画像を承認し、自分で投稿します。

ツール: すべてのスクリプトは、このファイルと同じ階層の scripts/ ディレクトリにあります。スクリプトは brand_kit.py(ウェブサイトを読み取る)と make_posts.py(画像を作成する)です。どちらもPython 3とPillowが必要です。「Pillowがありません」と表示された場合は pip install pillow を実行してください。デフォルトのフォントはバンドルされています。

ビジネスフォルダ には、1つのビジネスに関するすべての情報が格納されます:settings.json、ロゴ、photos/、fonts/、および seen.json(すでに投稿に変換されたレビュー)。フォルダ名は <ビジネス名> レビューポスト/ とし、作業フォルダ(Coworkの場合はユーザーが選択したフォルダ)内に保持します。既存のフォルダに settings.json があれば、セットアップをスキップして以下の 毎週 の手順に進みます。


初回:ブランドのセットアップ(約10分)

ユーザーに一言伝えます:「最初に、あなたのウェブサイトからブランドの見た目を設定します。約10分かかりますが、一度だけです。」

1. 2つのことを1つのメッセージで質問する

  1. 「ビジネス名とウェブサイトを教えてください。」
  2. 「レビューはどこにありますか?」 選択肢を提示:Google、Yelp、BBB、Facebook、Trustpilot、Houzz、Angi、Nextdoor、または自社サイトの testimonials。「リンクがあれば貼ってください。なければ、ウェブサイトから見つけます。」と伝えます。

2. ウェブサイトからブランドを取得する

ビジネスフォルダを作成し、次を実行します:

python3 scripts/brand_kit.py "<ウェブサイト>" --folder "<ビジネス名> レビューポスト"

このスクリプトは、ログの候補、大きな写真、Google Fonts、および brand-kit/brand-kit.json(見つかったカラー、フォント、電話番号、レビューリンクのリスト)を保存します。

  • スクリプトがサイトを開けない場合(ブロックされている、またはサンドボックスにインターネット接続がない):代わりにブラウザでウェブサイトを開きます。ロゴをスクリーンショットし、javascript_tool(後述)を使用してカラーとフォントを読み取り、必要に応じてユーザーにロゴファイルを送ってもらいます。
  • フォントが見つからない場合(よくあること:多くのサイトはJavaScriptでフォントを読み込む):ブラウザで次を実行します
    ['h1','h2','p'].map(t => t + ': ' + getComputedStyle(document.querySelector(t) || document.body).fontFamily)
    
    その後、各ファミリーを次で取得します:python3 scripts/brand_kit.py --get-font "<ファミリー名>" --folder "<フォルダ>"。Google Fontでない場合は、最も近いバンドルフォント(Playfair Display:エレガントなセリフ体、Poppins:クリーンなサンセリフ体、Raleway:ラベル用)を使用します。ユーザーが.ttfファイルを送ることもできます。

次に、すべてのファイルを自分で確認し、以下を選択します:

  • ロゴ: 最もクリーンな完全ロゴ(名前を含む)、PNG、理想的には透明背景。パートナー、受賞、認証、レビューサイトのバッジはスキップします。logo.png にコピーします。
  • カラー: brand-kit.json 内の colors.suggested から始め、ロゴと照合します。
    • dark は白いテキストの背景になるため、暗い色(ネイビー、フォレストグリーン、チャコール、ダーティール)である必要があります。
    • darker はそのより濃い色合いです。
    • accent は星、ハイライト、線用:ブランドの明るい色です。
    • accent_light はアクセントカラーの明るい色合いです。
    • ブランドに暗い色がない場合は、メインカラーの非常に暗い色合いを使用します。
  • 写真: 手順3を参照。

3. 背景写真

画像は、引用の背後に実際の写真があると最も見栄えがよく、写真は投稿ごとに変わります。次の優先順位でソースを選択します:

  1. 自社の写真: brand-kit/(自社ウェブサイト)から良いものを残し、photos/ にコピーします。また、次のように尋ねます:「仕事の写真はありますか?ドローンショット、完成した仕事、店舗やチームの写真など。ここにドロップしてください。」
  2. 無料のストック写真(ビジネスと地域に合ったもの): 自社の写真が少ない場合に使用します。reference/photos.md に従ってください。ルール:商用利用無料、photos/PHOTO-CREDITS.md にクレジットを記載、そしてビジネスが扱っているものを示すこと。例:屋根職人には家と屋根(ダウンタウンのスカイラインは不可)、歯科医には笑顔と落ち着いた診療所、レストランには盛り付けられた料理。
  3. 写真なし: 「ブランドカラー」レイアウトは写真を必要としません。

すべての写真の品質基準:

  • 長辺が少なくとも1500px。小さい画像を拡大しないでください。ぼやけます。
  • テキストや透かし、暗くてごちゃごちゃしたもの、特定できる他人の顔がないこと。
  • 8〜15枚を目標にすると、フィードで繰り返しが少なくなります。
  • ファイル名は種類ごとに付けます(job-01.jpg、area-01.jpg など)。これにより、ローテーションで種類が交互に変わります。

4. ルックオプションを表示する

settings.json(reference/settings.md を参照)を書き、次を実行します:

python3 scripts/make_posts.py --folder "<フォルダ>" --preview

これにより、同じサンプルレビューが各レイアウトで、ロゴ、カラー、フォント、写真を使用して生成されます。すべて表示し、次に尋ねます:「どれがいいですか?」:

  1. 写真上の大きな引用: 大胆で、短いレビューに最適。
  2. 写真上のレビューカード: 実際のレビューのように見え、長いレビューに最適。
  3. ブランドカラー、写真なし: クリーンで、写真不要。
  4. カルーセル: 非常に長いレビュー用に2スライド。スライド1に最も良い一文、スライド2に全文。

自動を推奨:短いレビューはレイアウト1、長いレビューはレイアウト2、非常に長いもの(70語以上)のみカルーセルになります。気に入らない点(ロゴが小さすぎる、色が間違っている、写真の切り抜きが悪い)を修正し、--preview を再度実行し、満足するまで繰り返します。

5. キャプション

一度尋ねます:「すべてのキャプションの最後に何を入れますか?多くの場合、電話番号や「オンライン予約」と数個のハッシュタグです。」 brand-kit.json の電話番号と3〜4つのローカルハッシュタグを使用して候補を提案します。caption.extras と caption.hashtags として保存します。

6. セットアップの完了

brand-kit/ と setup-previews/ を削除します。これらはセットアップ用のみでした。その後、ユーザーに短いリストで尋ねればいつでも変更できることを伝えます:

  • 「これらの写真を背景に使って」(または「プールの写真を削除して」)
  • 「ロゴをもっと大きくして」または「カラーロゴを使って」
  • 「ゴールドをオレンジに変更して」
  • 「レビューカードの見た目だけを使って」または「カルーセルはなしで」
  • 「Yelpを追加して」(または他のレビューサイト)
  • 「キャプションの末尾を変更して」

その後、すぐに 毎週 の手順に進み、最初の投稿を作成します。


毎週:投稿を作成する

1. 最新の5つ星レビューを取得する

settings.json の review_links を使用します。ブラウザが利用可能な場合(ChromeのClaude、またはCoworkのブラウザ)、各リンクを開き、reference/find-reviews.md に従います。閲覧のみ:返信、いいね、報告、レビュー作成は絶対にクリックしないでください。ブラウズできない場合、またはページがブロックされている場合: ユーザーにレビューを貼り付けてもらいます。

ルール:

  • 5つ星のみ。 それより低いものは、settings.json(only_stars)でユーザーが別途依頼しない限りスキップします。
  • 同じレビューが2つの場所にある場合(顧客がGoogleとBBBの両方に投稿することがよくある、またはサイトがGoogleレビューを再投稿している):1つの投稿を作成します。編集されていない方のコピーを優先します。
  • レビュー内の写真: レビューアが作品の写真を添付している場合、最大のものを photos/from-reviews/ にダウンロードし、そのレビューに "photo" を設定します。それがその投稿の背景になります。
  • seen.json にすでにあるレビューは自動的にスキップされます。新しいレビューがいくつあったかを伝えます。

2. reviews.json を書く(あなたが行います。ユーザーは見ることはありません)

フォーマットは scripts/make_posts.py の先頭にあります。

  • quote: 全文をそのまま。スペルや文法は修正しないでください。
  • name: ファーストネームとイニシャル(「山田 T.」)。
  • source: 投稿された場所(「Google」、「Yelp」など)。画像に表示されます。
  • excerpt(長いレビューのみ): 最も強い1〜3文をそのまま。
  • hl: ハイライトする1つの短いフレーズをそのまま。
  • 非表示の名前: 一部のサイト(BBB)ではスタッフ名が「REMOVED」と表示されます。「REMOVED」をそのまま残さず、名前を推測しないでください。
    • まず、それを避ける excerpt を試みます。
    • できない場合は、最も平易な役割を示す言葉に置き換え、括弧は付けません。例:"edits": [{"from": "REMOVED(owner)", "to": "オーナー"}]。
  • caption: 80語未満で、ビジネス自身の口調で。
    • レビューアのファーストネームで感謝します。
    • レビューアが言った特定のことを1つ挙げます。
    • caption.extras とハッシュタグで締めくくります。
    • 詳細をでっち上げないでください。

3. 画像を作成する

python3 scripts/make_posts.py --folder "<フォルダ>" reviews.json

表示する前にすべての画像を確認します。 以下をチェック:

  • テキストの切れ
  • 悪い写真の切り抜き(settings.json の photo_focus で修正し、再実行)
  • ビジネスに合わない写真(photos/ から削除)

4. 引き渡し

  1. 画像を投稿ごとにグループ化して表示し、各キャプションをその下に表示します。
  2. posts/<日付> フォルダを、可能であればzipにして渡します。このフォルダには、画像、captions.md、approval.csv(ExcelまたはGoogleスプレッドシートで開きます)が含まれます。
  3. 平易な言葉で次のことを伝えます:
    • 作成された投稿の数と、そのうちカルーセルの数
    • スキップまたは編集されたものがある場合
    • 何も投稿されていないこと
    • 次回は「レビューポストを作って」と言うだけでよいこと

関連スキル