# X自動集客ツール｜はじめての方へ 操作ガイド

> このガイドは、初めてこのツールを使う方向けに、**セットアップから日常の操作手順まで**をわかりやすく説明します。

---

## このツールでできること

| 機能 | 自動? | 説明 |
|---|---|---|
| ターゲットの検索 | ✅ 自動 | 設定したキーワードでXを検索し、対象ユーザーを見つける |
| いいね | ✅ 自動 | 対象ツイートに自動でいいねする |
| フォロー | ✅ 自動 | 対象ユーザーを自動でフォローする |
| AIリプライ案の生成 | ✅ 自動 | Gemini AIがリプライ文案を自動作成し、スプレッドシートに書く |
| リプライの送信 | 🔶 半自動 | あなたがOKした分だけ次回起動時に送信する |

> ⚠️ **ツールは起動した時だけ動きます。放っておいて勝手に動くわけではありません。**

---

## 【初回のみ】セットアップ手順

### 1. Pythonのインストール確認

コマンドプロンプトを開いて以下を実行し、バージョンが表示されればOKです。

```
python --version
```

### 2. 必要なライブラリのインストール

コマンドプロンプトで以下を1行コピー&ペーストして実行してください。

```
pip install tweepy gspread google-genai requests python-dotenv
```

### 3. スプレッドシートへの認証情報の入力

Google スプレッドシート「**GTwitterBot_V2_202603**」を開き、  
**👥アカウント管理** シートの設定欄に以下を入力してください。

| 変数名 | 入力する値 | 入手先 |
|---|---|---|
| `api_key` | APIキー | X Developer Portal |
| `api_key_secret` | APIシークレットキー | 同上 |
| `access_token` | アクセストークン | 同上 |
| `access_token_secret` | アクセストークンシークレット | 同上 |

> ✅ `bearer_token` は入力不要です（APIキーから自動生成されます）

### 4. .env ファイルの確認

`01_X運用/20260311.env` ファイルに `GEMINI_API_KEY=xxxxx` が記載されているか確認してください。

---

## 【毎回の操作】日常の使い方

### STEP 1｜ツールを起動する

エクスプローラーで `01_X運用` フォルダを開き、  
アドレスバーに `cmd` と入力してEnterキーを押します（コマンドプロンプトが開きます）。

```
python x_main.py
```

と入力してEnterを押すと起動します。  
**完了まで数分かかることがあります（Gemini APIのレート制限のため）。**

### STEP 2｜スプレッドシートで結果を確認する

ツールが終了したら、スプレッドシートを開いて確認します。

**📋 ツイート管理シート**

| 確認する列 | 内容 |
|---|---|
| J列「AIコメント案」 | ツールが自動生成したリプライ案 |
| K列「対象FLG②」 | ここを `TRUE` にするとリプライが送信される |
| L列「リプライ実行結果」 | 実際に送信された結果 |

### STEP 3｜リプライ案を確認・承認する

1. **J列のAIコメント案**を読んで内容を確認する
2. 問題なければ**K列「対象FLG②」** のセルに `TRUE` と入力する
3. 内容を変えたい場合はJ列のテキストを直接書き直してからTRUEにする
4. 次回ツールを起動すると、TRUEにした行のリプライが自動送信される

---

## スプレッドシートの設定変更方法

「検索するキーワードを変えたい」「いいねの上限を変えたい」などは、  
スプレッドシートの **設定欄（E列）** の値を変更するだけでOKです。

### よく変更する設定

**👥 アカウント管理シート**

| 変数名 | 変更方法 | 説明 |
|---|---|---|
| `search_keywords` | キーワードをカンマ区切りで入力 | 例: `発達障害,生きづらい,仕事 限界` |
| `ng_words` | NGワードをカンマ区切りで入力 | 例: `副業,アフィリ,PR` |
| `like_limit_per_run` | 数字を入力 | 1回の起動でいいねする最大件数 |
| `follow_limit_per_run` | 数字を入力 | 1回の起動でフォローする最大件数 |
| `pause_follow` | `TRUE` / `FALSE` | TRUEにするとフォロー処理を一時停止 |

**📋 ツイート管理シート**

| 変数名 | 変更方法 | 説明 |
|---|---|---|
| `ai_prompt` | 文章を入力 | AIリプライ生成時の指示文 |
| `pause_tweet` | `TRUE` / `FALSE` | TRUEにするといいね・リプライを一時停止 |

---

## 緊急停止の方法

### すぐに止めたい場合（起動中）
コマンドプロンプトで `Ctrl + C` を押すと即座に停止します。

### 当面の間、動かしたくない場合
スプレッドシートの設定欄で：

- **フォローを止める** → `pause_follow` を `TRUE` に変更
- **いいね・リプライを止める** → `pause_tweet` を `TRUE` に変更

---

## よくある質問

**Q. 「AIエラー: 手動で作成してください」とスプレッドシートに表示された**  
A. Gemini APIのレート制限（利用上限）に達しました。少し時間をおいてから再度ツールを起動してください。J列のセルを手動で書き直せばリプライは送信できます。

**Q. 検索結果が0件になる**  
A. `search_keywords`（検索キーワード）が空欄になっていないか確認してください。

**Q. いいねやフォローが実行されない**  
A. 以下を確認してください：
- `pause_follow` や `pause_tweet` が `TRUE` になっていないか
- `like_limit_per_run` / `follow_limit_per_run` が `0` になっていないか
- `like_mode` / `follow_mode` が「自動」になっているか

**Q. エラーが出て起動しない**  
A. コマンドプロンプトのエラーメッセージをコピーして担当者（Antigravity）に共有してください。

---

## ファイル構成（参考）

```
01_X運用/
├── x_main.py         ← 起動するファイル（これだけ覚えればOK）
├── x_api_client.py   │
├── x_sheets_writer.py│← 自動で使われるファイル（触らなくてOK）
├── comment_generator.py
├── 20260311.env      ← GEMINI_API_KEY が入っている設定ファイル
└── x_automation.log  ← 実行ログ（エラー調査時に使用）
```