casualize-names

カジュアルネーム変換ワークフロー

目的

フォーマルな名前（名、会社名、都市名）を、コールドメールの文面に適したカジュアルで親しみやすい表現に変換します。

スクリプト

• ./scripts/casualize_batch.py - メインスクリプト（3つのフィールドすべてを一度に処理）
• ./scripts/casualize_company_names_batch.py - 会社名のみ
• ./scripts/casualize_first_names_batch.py - 名のみ
• ./scripts/casualize_city_names_batch.py - 都市名のみ

クイックスタート

# Process all three fields at once (recommended, 3x faster)
python3 -u ./scripts/casualize_batch.py "GOOGLE_SHEET_URL"

# Re-process existing (overwrite)
python3 -u ./scripts/casualize_batch.py "GOOGLE_SHEET_URL" --overwrite

仕組み

1. 50件ずつのバッチでレコードを処理します
2. 5つのワーカーを並列で使用します
3. Claude が1回の API 呼び出しで3つすべてのフィールドを変換します
4. 結果を Google Sheet にバッチ更新します
5. メールアドレスがある行のみを処理します

パフォーマンス：毎秒約35件（3,000件で約90秒）

カジュアル化のルール

名

• よく使われる愛称を使用します：「William」→「Will」、「Jennifer」→「Jen」
• 一般的な愛称がない場合は、元の名前を維持します
• プロフェッショナルな印象を保ちます

会社名

• 先頭の「The」を削除します
• 法人種別の接尾辞（LLC、Inc、Corp、Ltd）を削除します
• 一般的な単語（Realty、Group、Solutions、Services）を削除します
• ブランド名の核となる部分は維持します
• あまりに一般的な名前には「you guys」を使用します

例：

• 「Keller Williams Realty Inc」→「Keller Williams」
• 「The Teal Umbrella Family Dental Healthcare」→「Teal Umbrella」

都市名

• 現地で使われる愛称を使用します：「San Francisco」→「SF」、「Philadelphia」→「Philly」
• 一般的な愛称がない場合は、元の名前を維持します

出力

次の3つの新しい列を作成します：

• casual_first_name
• casual_company_name
• casual_city_name

環境

ANTHROPIC_API_KEY=your_key

---

スキーマ

入力

名前	型	必須	説明
sheet_url	文字列	はい	リードデータを含む Google Sheet の URL
overwrite	真偽値	いいえ	既存のカジュアル化済みの名前を再処理するかどうか

出力

名前	型	説明
sheet_url	文字列	casual_first_name、casual_company_name、casual_city_name 列が追加された同じシート

認証情報

名前	ソース
ANTHROPIC_API_KEY	.env

組み合わせ可能なツール

このツールとうまく連携するスキル：scrape-leads、gmaps-leads、instantly-campaigns

コスト

毎秒約35件、API コストは最小限