レビューポスト生成 は何をしますか?
あなたは、おそらく技術に詳しくないビジネスオーナーやマーケターを支援しています。メッセージは短く、温かみがあり、平易に保ってください。コード、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つのメッセージで質問する
- 「ビジネス名とウェブサイトを教えてください。」
- 「レビューはどこにありますか?」 選択肢を提示: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. 背景写真
画像は、引用の背後に実際の写真があると最も見栄えがよく、写真は投稿ごとに変わります。次の優先順位でソースを選択します:
- 自社の写真:
brand-kit/(自社ウェブサイト)から良いものを残し、photos/にコピーします。また、次のように尋ねます:「仕事の写真はありますか?ドローンショット、完成した仕事、店舗やチームの写真など。ここにドロップしてください。」 - 無料のストック写真(ビジネスと地域に合ったもの): 自社の写真が少ない場合に使用します。
reference/photos.mdに従ってください。ルール:商用利用無料、photos/PHOTO-CREDITS.mdにクレジットを記載、そしてビジネスが扱っているものを示すこと。例:屋根職人には家と屋根(ダウンタウンのスカイラインは不可)、歯科医には笑顔と落ち着いた診療所、レストランには盛り付けられた料理。 - 写真なし: 「ブランドカラー」レイアウトは写真を必要としません。
すべての写真の品質基準:
- 長辺が少なくとも1500px。小さい画像を拡大しないでください。ぼやけます。
- テキストや透かし、暗くてごちゃごちゃしたもの、特定できる他人の顔がないこと。
- 8〜15枚を目標にすると、フィードで繰り返しが少なくなります。
- ファイル名は種類ごとに付けます(
job-01.jpg、area-01.jpgなど)。これにより、ローテーションで種類が交互に変わります。
4. ルックオプションを表示する
settings.json(reference/settings.md を参照)を書き、次を実行します:
python3 scripts/make_posts.py --folder "<フォルダ>" --preview
これにより、同じサンプルレビューが各レイアウトで、ロゴ、カラー、フォント、写真を使用して生成されます。すべて表示し、次に尋ねます:「どれがいいですか?」:
- 写真上の大きな引用: 大胆で、短いレビューに最適。
- 写真上のレビューカード: 実際のレビューのように見え、長いレビューに最適。
- ブランドカラー、写真なし: クリーンで、写真不要。
- カルーセル: 非常に長いレビュー用に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. 引き渡し
- 画像を投稿ごとにグループ化して表示し、各キャプションをその下に表示します。
posts/<日付>フォルダを、可能であればzipにして渡します。このフォルダには、画像、captions.md、approval.csv(ExcelまたはGoogleスプレッドシートで開きます)が含まれます。- 平易な言葉で次のことを伝えます:
- 作成された投稿の数と、そのうちカルーセルの数
- スキップまたは編集されたものがある場合
- 何も投稿されていないこと
- 次回は「レビューポストを作って」と言うだけでよいこと