成果を最大化するX自動運用の全体像
X(Twitter)の自動運用は、情報発信を効率化し、SNS副業を自律化するための最も強力な手段の1つです。
しかし、多くの初心者が「何から始めればいいのか」「どのツールをどう設定すれば安全に動くのか」という壁にぶつかります。
このとき、私たちが手動で何百行ものプログラムコードを暗記して書き上げる必要は一切ありません。
「Claude Code」や「Cursor」といったPCのファイルを直接操作・実行できる「自律型AIエージェント」に対して、自然言語で適切な指示(プロンプト)を与えるだけで、AIが自動的にスクリプトの作成、テスト、実行、そして環境構築までを自律的に完了させてくれます。
本稿では、自動化システムの構築において「AIエージェントにどのような指示を出せば、意図通りのシステムが自動的に構築されるのか」というプロンプト設計の実例をステップバイステップで解説します。
手法1:APIを一切使わないブラウザ自動化(スクレイピング投稿)
Xの有料APIを使用せず、ブラウザテストツールであるPlaywrightを利用して自動でXにログインし、ポストを実行する手法です。
この手法は、クローズドな自動化実証実験において実際に運用検証が行われた技術的アプローチです。
この仕組みをAIエージェントに自動構築させるためには、ターミナルでAIエージェントを起動し、以下の指示を入力するだけで完了します。
AI PROMPT / CONFIG
Node.jsとPlaywright、そして環境変数を管理するdotenvを使用して、X(Twitter)に自動投稿するスクリプトを構築してください。
以下の仕様をすべて満たすファイルを自動で作成・配置してください。
1. 毎回パスワード入力を行うとボット検知や二要素認証(2FA)に引っかかるため、ログインセッションを維持する仕組み(Cookie)を作ります。
- まず「save_auth.js」を作成してください。ブラウザ(ヘッド有り)でXのログイン画面を開き、手動ログインが完了してターミナルでEnterを押したら、セッション状態を「auth_state.json(Cookie)」に保存して終了する設計にします。
2. 次に「post_x.js」を作成してください。保存された「auth_state.json(Cookie)」を読み込んでバックグラウンド(ヘッドレスモード)で起動し、環境変数または変数で指定した任意のテキストをXの入力欄に自動で入力してポストを送信する設計にします。
3. 必要なライブラリのインストール(npm init -y や npm install playwright dotenv、npx playwright install chromium)もAI側で自動実行しておいてください。この指示を受けたAIエージェントは、自動的にプロジェクトディレクトリ of 初期化とライブラリのインストールコマンドを実行し、さらにログイン状態を保存するためのスクリプト(Cookie保存用のコード)と、そのCookieを再利用してバックグラウンドで投稿を完了させるスクリプト(自動投稿用のコード)を自動で作成して配置してくれます。
1初回手動ログイン & 保存・Playwright でブラウザ起動
・手動でXに通常ログインを完了
・セッションCookieを auth_state.json へ保存→2セッション自動復元・自動化プログラム実行時に
・auth_state.json を読み込む
・ログインパスワード入力なしで認証済み画面を再現→3自動投稿 & 凍結回避・新規ポスト送信画面へ直接移動
・本文自動入力 ➔ ボタン自動クリック
・15秒〜45秒のジッター(待機)で機械的動作を隠蔽図解: PlaywrightによるCookie保存とXブラウザ自動投稿の仕組み
・手動でXに通常ログインを完了
・セッションCookieを auth_state.json へ保存→2セッション自動復元・自動化プログラム実行時に
・auth_state.json を読み込む
・ログインパスワード入力なしで認証済み画面を再現→3自動投稿 & 凍結回避・新規ポスト送信画面へ直接移動
・本文自動入力 ➔ ボタン自動クリック
・15秒〜45秒のジッター(待機)で機械的動作を隠蔽図解: PlaywrightによるCookie保存とXブラウザ自動投稿の仕組み
⚠️ [最重要警告] 利用規約違反とシャドウバン(凍結)回避
このブラウザ自動化手法は、Xの利用規約(自動化に関するポリシー)に明確に違反しています。
そのため、発覚した場合はアカウントの一時停止やシャドウバン、あるいは永久凍結処分を受ける致命的なリスクが常に伴います。
もし実験的に運用する場合は、AIエージェントに対して「ボット検知を回避するための安全対策」を必ずプロンプトに含めて指示してください。
具体的には、以下の3つの防御柵をコード内に設計させます。
1. ランダム待機(ジッター)の徹底:
投稿のクリックや入力の前に、必ず15秒〜45秒のランダムな待機時間(`Math.random()`)を挿入させます。
機械的な等間隔のアクセスは、Xの不正検知システムによって即座にボットと判定されます。
2. 1日あたりの投稿数制限:
投稿頻度は1日に最大3回〜5回程度に留めるように制限させます。
短時間での過剰な連投は即座にスパム判定のフラグが立ちます。
3. ユーザーエージェントの偽装:
デフォルトのPlaywrightのヘッダー情報はボットであることを明示しているため、通常のブラウザのUser-Agent文字列をコンテキスト設定に偽装して追加させます。
PROMPT / ADVICE💡 : AIにPlaywrightの安全対策コードを作らせるAIエージェントに「作成したpost_x.jsに、人間らしいスクロール動作やランダムなキー入力をシミュレートする処理を追加して。また、デフォルトのUser-Agentを一般的なWindows Chromeのヘッダーに偽装してボット判定を防ぐコードにリライトして」と指示を追加することで、より強固な回避スクリプトが自律的に完成します。
手法2:正規のX API (v2) を用いた安全な自律運用
リスクのある規約違反の手法を卒業し、公式に提供されている「X API (v2)」を使用して、規約に準拠した安全かつ堅牢な自動投稿システムを構築する手順です。
※現在、X API経由での自動投稿(Writeアクション)には、有料プランである Basicプラン(月額$100 / 月10,000ポストまで)以上の契約が必須 となっており、以前存在していた自動投稿用の無料枠は廃止されています。
1公式API登録 & 発行・Developer Portal でアプリ登録
・権限を Read and Write に変更
・4つの API認証キーを発行→2安全な環境変数管理・キー群をコードに直接書かない
・ローカルの .env ファイルに格納
・環境変数として安全にロード→3二段階自動投稿(スレッド)・まず「親ポスト」を API 投稿
・返却された Tweet ID を取得
・IDを指定して「補足・リンク」を返信しスレッド化図解: 正規X API (v2) と環境変数を用いたスレッド自動投稿の仕組み
・権限を Read and Write に変更
・4つの API認証キーを発行→2安全な環境変数管理・キー群をコードに直接書かない
・ローカルの .env ファイルに格納
・環境変数として安全にロード→3二段階自動投稿(スレッド)・まず「親ポスト」を API 投稿
・返却された Tweet ID を取得
・IDを指定して「補足・リンク」を返信しスレッド化図解: 正規X API (v2) と環境変数を用いたスレッド自動投稿の仕組み
ステップ1:X Developer Portal でのアプリ登録と設定
正規APIを使用するためには、人間がブラウザで X Developer Portal(developer.x.com)にアクセスし、開発者アカウントの申請とアプリ登録を行います。
設定時に必ず以下の情報を入力してください。
- App permissions: `Read and Write`(書き込み権限)に変更します(デフォルトはRead-Onlyなので、ここを変えないと投稿時にエラーになります)。
- Type of App: `Web App, Automated App or Bot` を選択します。
- Callback URI: `http://localhost:8080/callback`(ローカル環境でのOAuth認証用リダイレクト先)を設定します。
- Website URL: 自身のブログやプロフィールのURLを入力します。
設定が完了すると、クライアントIDとクライアントシークレット、およびAPIキーが発行されます。
これらを安全に管理するため、ルートディレクトリに `.env` という設定ファイルを作成し、以下のように記述して保存します。
AI PROMPT / CONFIG
env
X_API_KEY=your_consumer_key
X_API_SECRET=your_consumer_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_SECRET=your_access_token_secretステップ2:API投稿スクリプトの自律構築
環境変数の設定ファイル(.env)を作成したら、AIエージェントに以下のように指示を投げて、自動でAPI投稿プログラムを書いてもらいます。
AI PROMPT / CONFIG
Pythonと、X APIを扱う標準ライブラリのtweepy、そして環境変数読み込み用のpython-dotenvを使用して、安全に自動投稿を行うスクリプトを作成してください。
仕様:
1. キー情報を直接コードに直書きせず、.env ファイルから X_API_KEY などを読み込んで X API v2 のクライアント(tweepy.Client)を初期化する設計にしてください。
2. ツイートテキストを引数として受け取り、client.create_tweet(text=...) を実行してツイートし、成功したらツイートIDをターミナルに出力するプログラムにしてください。
3. 画像ファイルを指定して自動投稿する機能(tweepy.APIのmedia_uploadでメディアIDを取得してから、v2 APIで画像を紐づけてcreate_tweetする2段階の画像付きポストコード)も追加してください。
4. 必要なライブラリのインストール(pip install tweepy python-dotenv)も自動で実行してください。このプロンプトを与えるだけで、AIは自動的にPython環境に必要なライブラリをインストールし、テキスト投稿および画像添付投稿に必要な2段階API連携を含んだ「post_api.py」を自律的に構築してくれます。
PROMPT / ADVICE💡 : Tweepyスクリプトの作成をAIに任せるX APIのキー設定やエラー処理を完璧にした「画像添付付き自動ポストスクリプト」のベースコードをAIに自動生成させましょう。「画像ファイルを指定したディレクトリからランダムに1枚選び、それに対応するテキストを読み込んで投稿するPythonコードを書いて」と指示するだけで、ローテーション投稿プログラムも簡単に作れます。
AIエージェントに「X Algorithm」ソースコードをスキャン・自律学習させる方法
最新のXの評価ロジックを学習させるために、人間がわざわざ何万行もの複雑なプログラムコードを手動でダウンロードして1ファイルずつ解読する必要は一切ありません。
X(Twitter)社がGitHubで一般公開している推薦アルゴリズムのリポジトリURL( https://github.com/twitter/the-algorithm )をコピーして、AIエージェントのチャット欄にそのまま貼り付けるだけで完了します。
AIエージェント(Webブラウジングやリポジトリの解析に対応したモデル)に対して、以下のように自然言語で指示を出します。
AI PROMPT / CONFIG
[AIへの指示プロンプト:アルゴリズムの加点・減点ロジック抽出]
このX公式の推薦アルゴリズムのソースコード( https://github.com/twitter/the-algorithm )を読み込み、以下の3点について具体的な加点・減点ルールを抽出した詳細な日本語のレポートを作成してください。
1. いいね、リポスト、リプライ、滞在時間(Dwell Time)がそれぞれタイムラインの評価において何倍の係数で加点されているか
2. 外部サイトへのリンク(URL)を直接ツイートに貼った場合に、インプレッションに課されるペナルティ減点ロジックの有無と詳細
3. 同じリンクの連投や、ボット判定によるスパムフィルタリング(インプレゾンビ等)を検知・除外するロジックの概要これだけで、AIエージェントが自動的にGitHub上のScalaやPythonで書かれたソースコード(重み付けランク判定を行う heavy-ranker など)を直接スキャンし、「いいねは+30点、リポストは+20点、リプライは+75点、直接の外部リンク付き投稿はスコアが0.2倍(80%減点)にペナルティ判定される」といった推薦アルゴリズムのロジックを自動で抽出して要約してくれます。
この要約テキストをあなたのメモ帳やObsidianにコピペして蓄積するだけで、最新のアルゴリズムに基づいた極めて効率的な投稿設計が可能になります。
PROMPT / ADVICE💡 : 最新のGrok対応アルゴリズムを分析させるxAI社が公開している最新アルゴリズム「x-algorithm」リポジトリ(Grok-1など)に対しても同様の手法が使えます。「xAI社が公開しているアルゴリズムリポジトリ( https://github.com/xai-org/grok-1 )のURLを貼り付け、Grok AIを用いたセマンティック検索と、ポストの関連性評価ロジックがどこで処理されているかスキャンして要約して」とAIに指示するだけで、最新のトレンドを常に先取りできます。
自律型SNSアフィリエイト:バズ収集・分析・投稿生成サイクル
アルゴリズムを理解した上で、実際にSNS副業(アフィリエイト)で利益を生み出すための「バズ収集 ➔ 分析 ➔ 生成 ➔ 二段階ポスト」の完全自律サイクルを設計します。
1. トレンド・バズ情報の自動クローリング
AIエージェントに、ターゲット層にバズっている投稿のキーワードやエンゲージメントデータをスクレイピングするPythonスクリプトを構築させます。
AI PROMPT / CONFIG
特定のハッシュタグやキーワードで検索し、リツイート(RT)数が1000以上の人気のあるバズ投稿のテキスト情報を抽出して、ローカルの「00_inbox/」フォルダに1件ずつMarkdownファイルとして自動保存するPythonスクリプト(buzz_crawler.py)を作成してください。
(相手サーバーの負荷にならないよう、リクエスト間隔に3秒以上のスリープを挟むように設計してください)2. 収集したバズデータのAI分析と学習
次に、収集したMarkdownファイルをAIエージェントに読み込ませて、バズる要因を自律学習させます。
AI PROMPT / CONFIG
「00_inbox/」に保存されている競合のバズ投稿データをすべて読み込んでください。
これらの投稿が「なぜ多くのリツイートを獲得できたのか」、心理フック、文章の構成パターン(例:1行目の問題提起 ➔ 2行目のギャップ提示 ➔ 3行目の箇条書き解説)、文字数、使われている記号などを詳細に分解・分析し、その共通の「バズ法則テンプレート」を抽出してください。
結果は「20_sources/buzz_analysis_report.md」に保存してください。3. アフィリエイト商材と掛け合わせたドラフト自動生成
分析レポートが作成されたら、アフィリエイト商材の紹介文をAIに自律生成させます。
AI PROMPT / CONFIG
「20_sources/buzz_analysis_report.md」のバズ法則テンプレートを基に、私のアフィリエイト商材である「ビジネスマン向けクラウド勤怠管理システム(紹介URL:https://example-affiliate.com/attendance)」のプロモーションツイートのドラフト案を3パターン作成してください。
条件:
- 各パターンは140文字以内に収めること。
- 親ポストにはアフィリエイトリンク(URL)を絶対に含めないこと(外部リンク直接添付によるペナルティを避けるため)。
- 代わりに、ポストの最後に「※詳細は補足リプ欄のリンクを参照」と明記すること。
- 出力されたドラフトは「10_projects/drafts/post_candidates.md」に保存してください。4. アフィリエイトリンク補足リプライ(二段階投稿)の実装
Xのペナルティを回避するアフィリエイトの手法として、「「親ポストは有益なテキストのみ」」「「リンクはリプライツリー(返信)にぶら下げる」」という二段階投稿(スレッド返信機能付き自動ポスト)を API で自動実行する Python スクリプトをAIエージェントに作成させます。
AI PROMPT / CONFIG
tweepy(Python)を使用して、Xのペナルティを回避するための二段階自動投稿スクリプトを作成してください。
仕様:
1. まず、アフィリエイトリンクを含まない有益テキストのみの「親ポスト」を投稿します。
2. 親ポストの投稿に成功したら、その投稿ID(parent_id)を取得します。
3. 5秒間の待機時間を入れた後、その親ポストIDに対してアフィリエイトリンクを含んだ「リプライ(返信ポスト)」を自動で紐づけて投稿する設計にしてください。
4. 親ポストのテキストと、リプライのリンクテキストは環境変数または関数の引数から安全に渡せるように設計してください。このプロンプトを与えることで、AIは自動で二段階投稿(スレッド返信機能付き自動ポスト)スクリプトを構築してくれます。
X APIにおける「スレッド投稿」の実装とコスト比較
公式のX API(v2)を使用する場合、親ポストの投稿レスポンスから`id`(ツイートID)を受け取り、それを子ポストの `in_reply_to_tweet_id` パラメータに指定して実行することで、最初からツリー状(スレッド)に繋がった状態で投稿を送信することができます。
この「スレッド型投稿」と「親ポストにリンクを直接含む通常投稿」には、API利用枠の消費(コスト)とアカウントの安全面において明確なトレードオフが存在します。
1. 直接リンク投稿(1回リクエスト)
- APIコスト: 1回の投稿につきAPIリクエスト消費は 1回 のみ。
- メリット: 有料のBasicプラン(月額$100 / 月10,000ポストまで)の投稿制限枠を最大限に長持ちさせることができます。
- デメリット: 外部リンクを直接含むため、アルゴリズムの減点対象となり、インプレッションが極端に減衰するリスクやシャドウバンを受けやすくなります。
2. ツリー型スレッド投稿(2回リクエスト)
- APIコスト: 1回の発信で「親ポストの送信」と「リプライの送信」の 計2回 のAPIリクエストを消費します。
- メリット: 外部リンクをリプライ欄に隔離できるため、インプレッションの減衰を防ぎ、アカウントの健全性を保つことができます。
- デメリット: Basicプラン(月10,000ポスト制限)の投稿制限枠を 2倍のスピードで消費(月最大5,000スレッドまで)するため、発信頻度が高い場合はさらに上位のプラン(Proプランなど)への契約が必要になり、実質的なコストが上昇します。
運用の発信ボリュームと予算を考慮し、AIエージェントに最適な手法のスクリプトを自律構築させましょう。
PROMPT / ADVICE💡 : アフィリエイト自動投稿スクリプトの調整親ポストを投稿した後に、リプライを即時に投稿すると不自然なボット動作と見なされる場合があります。親ポストの投稿成功後、`import time; time.sleep(5)` を挿入して、5秒〜10秒ほど間隔を空けてからリプライリンクを自動送信するようにスクリプトを調整することで、アカウントの健全性を高めることができます。
運用の「見える化」と外部情報蓄積:ダッシュボード・Notion・NotebookLM連携
運用のステータスを可視化して管理するダッシュボードの構築方法、およびデータを外部にエクスポートして資産化する手法を解説します。
ステップ1:Notion API を用いた投稿管理ダッシュボード
Notionで「X投稿管理カレンダー」データベースを作成します。
カラムには、`タイトル`、`投稿テキスト(リッチテキスト)`、`投稿ステータス(セレクト:下書き / 承認済み / 投稿完了)`、`投稿予約日時` を設けます。
Notionのマイインテグレーション(developers.notion.com)からAPIトークンを発行し、データベースのページ共有設定でこのインテグレーションを許可します。
この状態から、AIエージェントに対して「NotionとX APIの連携自動化スクリプト」の作成を以下のように命じます。
AI PROMPT / CONFIG
Pythonを使って、Notionデータベースから投稿候補を取得してXに自動ポストし、Notion側のステータスを自動更新するスクリプトを作成してください。
仕様:
1. Notion APIを使用して、指定されたデータベースIDから「投稿ステータス」が「承認済み」になっているレコードを検索して取得します。
2. 取得したレコードの「投稿テキスト」カラムの中身を抽出し、X API(tweepy)を使用してXに投稿を実行します。
3. Xへの投稿が成功したら、即座にNotion APIを叩いて、該当レコードの「投稿ステータス」を「投稿完了」に自動更新する設計にしてください。
4. Notionトークン、データベースID、X APIキーなどの認証情報はすべて環境変数(.env)から安全に読み込む設計にしてください。AIエージェントはこのプロンプト通りに動作する連携プログラム(Notion APIのクエリおよびパッチ更新処理を含むコード)を自動生成し、テスト実行まで完了してくれます。
ステップ2:NotebookLM を用いた外部脳ナレッジの構築
自動投稿の履歴や、アルゴリズムの解析レポート、競合のバズ分析Markdownデータは、蓄積するだけでは宝の持ち腐れです。
これらを Google の NotebookLM(notebooklm.google.com)にエクスポートしてソースとして登録することで、あなた専用の「超強力なSNSマーケティング相談役」を瞬時に立ち上げることができます。
1. データの書き出し:
あなたのObsidian内にある `20_sources/competitors/` や `20_sources/buzz_analysis_report.md` などのMarkdownファイルをPDFやテキスト形式で書き出します(NotionのデータベースをCSVエクスポートしても構いません)。
2. NotebookLM へのアップロード:
NotebookLMを開き、「新しいノートブック」を作成。
ソースとして、書き出したファイルをドラッグ&ドロップで追加します。
3. AIによる対話型Q&Aの実行:
ソース追加が完了すると、NotebookLMはあなたのアップロードした情報だけをソースにした信頼性の高いAIへと変化します。
チャット欄で、以下の質問を投げてみてください。
- 「過去の投稿履歴から、最もインプレッションが高かった投稿ジャンルの傾向を教えて」
- 「X Algorithmの減点ロジックに違反しない形で、来週の投稿スケジュール案を5件考えて」
- 「このナレッジベースを元に、新しいアフィリエイト商材をバズらせるための導入フックのアイデアを提案して」
これにより、ネット上の曖昧な情報ではなく、「あなたの実体験と実績」をベースにした、世界で唯一の自走型X運用コンサルAIが手に入ります。
自動化スクリプトで手を動かす時間を減らし、NotebookLMとの対話で戦略を練る
講義の要点:X自動運用と自律パイプラインまとめ
今回の講義の最重要ポイントを振り返りましょう。
1. API不要のブラウザ自動化(Playwright)
有料APIを使用せず、Cookieセッション(auth_state.json)を使い回してヘッドレスブラウザからポストを自動送信する手法を構築できます。
2. ボット検知と凍結リスクの徹底回避
機械的な規則動作を避けるため、投稿前に15秒〜45秒のランダム待機(ジッター)を入れ、二段階スレッド(返信欄にリンク添付)などのペナルティ回避を設計します。
3. アルゴリズムはURL貼り付けでAIに自律スキャンさせる
リポジトリをGitダウンロードする手間を省き、GitHub of URLをAIエージェントに直接読み込ませることで、最新の評価係数を自動分析させます。
4. NotionとNotebookLMで運用を資産化する
Notionで投稿カレンダーを管理し、蓄積されたバズデータや運用レポートをNotebookLMに読み込ませて、あなた専用の自走型X運用コンサルAIを立ち上げます。
「ディレクター」としての知的生産活動へシフトしていきましょう。
PROMPT / ADVICE💡 : Notion/NotebookLM連携スクリプトの作成Notion上のデータベース変更を検知して、自動でNotebookLM(またはローカルのMarkdownナレッジ)と差分同期するスクリプトをAIに構築させましょう。「Notion APIで前日増えた新規の完了投稿のみを抽出し、その要約をローカルのMarkdownファイルに追記するPythonプログラムを書いて」とAIに指示するだけで、毎日の自動同期処理が完成します。