X (Twitter) セットアップ
X (Twitter) API セットアップガイド¶
MarionetteとX (Twitter)を連携するには、X Developer Portalでプロジェクトとアプリを作成し、API Key・API Secret・Access Token・Bearer Tokenを取得する必要があります。
このページでは、その手順を最初から説明します。
1. X Developer Portal にアクセス¶
X Developer Portal にアクセスし、Xアカウントでログインしてください。
API 利用について
X API は従量課金制です。利用開始にはクレジットカードの登録と最低 $5 程度の前払いが必要な場合があります。
2. プロジェクトとアプリを作成¶
- 「Sign up for Free Account」 または 「Projects & Apps」 から新規作成
- プロジェクト名 を入力（例:
Marionette） - Use case を選択（例: Making a bot）
- アプリ名 を入力（例:
Marionette Bot） - アプリ名は世界中で一意である必要があります
3. 認証方式の設定¶
- アプリの 「Settings」 → 「User authentication settings」 を開く
- 「Set up」 をクリック
- App permissions で 「Read and write and Direct message」 を選択
- 「Save」 をクリック
4. API Key と API Secret を取得¶
- アプリの 「Keys and tokens」 タブを開く
- Consumer Keys セクションで 「Generate」 をクリック
- API Key と API Key Secret をコピー
- API Key Secret は再表示できないため、必ず保存してください
5. Access Token と Access Token Secret を取得¶
- 同じ 「Keys and tokens」 タブで
- Access Token and Secret セクションの 「Generate」 をクリック
- 表示された Access Token と Access Token Secret をコピー
- これらも再表示できないため、必ず保存してください
6. Bearer Token を取得¶
- 同じ 「Keys and tokens」 タブで
- Bearer Token セクションの 「Generate」 をクリック
- 表示された Bearer Token をコピー
トークンの取り扱い
すべてのトークンは**パスワードと同等の機密情報**です。
他人に共有したり、Git にコミットしたりしないでください。
7. Marionette に設定を入力¶
管理画面の左メニュー 「外部連携」→「Bot管理」 を開き、X (Twitter)を選択します。
接続設定¶
| 項目 | 入力する値 |
|---|---|
| API Key | 手順4で取得した API Key (Consumer Key) |
| API Secret | 手順4で取得した API Key Secret |
| Access Token | 手順5で取得した Access Token |
| Access Token Secret | 手順5で取得した Access Token Secret |
| Bearer Token | 手順6で取得した Bearer Token |
入力後、「設定保存」 をクリックしてから 「接続」 ボタンを押してください。
ステータスが「接続中」に変われば成功です。
8. 動作確認¶
- X 上で Bot アカウントをメンション
- または DM を送信
- Bot が応答すれば成功