Fable 5でバズリサーチ|XとYouTubeの分析手順
- 更新日: 2026年7月3日
- 読了目安: 約15分
- 作業時間: 約30分
Claude Fable 5を使えば、XとYouTubeのバズ投稿・バズ動画をデータでリサーチできます。XはSocialData.tools(最低チャージ$5、1,000ツイート$0.20)、YouTubeはYouTube Data API v3(無料枠1日10,000クォータ)を使います。
プログラミングの知識は不要です。人間がやるのは、画面の通りに登録して、利用するための合鍵(APIキー)という文字列をコピペするだけ。途中で出てくるAPIという言葉も、「サービス同士をつなぐ入口」くらいの意味で読めば大丈夫です。環境構築そのものも、Fable 5に頼めば一緒にやってくれます。
登録からAPIキー設定、コピペで使えるリサーチプロンプト、企画への落とし込みまで、この記事1本で確認できます。作業時間は両方合わせて30分前後です。
この記事で分かること
「バズ リサーチ 方法」「X バズ投稿 分析」「YouTube 伸びてる動画 調べ方」で検索している人が知りたいのは、たぶんツール名だけではありません。
無料でどこまでできるのか。カード登録は必要なのか。APIキーはどこで取るのか。取ったデータをどう投稿や動画企画につなげるのか。そして、なぜChatGPTに聞くだけではダメなのか。
この記事通りに進めれば、XはSocialData.tools、YouTubeはYouTube Data API v3で、Fable 5にバズリサーチを任せられる環境が作れます。
この記事のフローは、運営のhashshnetが社内勉強会(第2回・通称「帰れない会」)で実際に組んで実演したものです。机上の紹介ではなく、実際に回した手順をそのまま公開しています。
最初に送るプロンプト
先に、環境をまとめて作るプロンプトを置いておきます。
Claude Code(モデルはFable 5)を起動して、これを貼れば、XとYouTube両方のリサーチ環境が一度に組み上がります。フォルダ作りもスクリプト作りも、全部Fable 5がやってくれます。自分でコードを書く場面は1つもありません。
人間の作業は、利用するための合鍵(APIキー)を各サービスの画面で取ってきて貼ることだけです。その取り方は、この後の章を見ながら進めてください。
バズリサーチ用の作業環境を作ってください。
## 目的
XとYouTubeのバズ投稿・バズ動画をAPI経由で取得して、傾向分析までできる環境を作る。
## 前提
- 作業ツール: Claude Code(モデルはFable 5)
- 私はプログラミング初心者です。専門用語は都度短く説明してください
- SocialData.toolsのAPIキーとYouTube Data API v3のAPIキーは、あとで私が.envに貼ります
## 作ってほしいもの
1. buzz-research/ フォルダ
2. .env(SOCIALDATA_API_KEY= と YOUTUBE_API_KEY= の空欄テンプレート)
3. .gitignore(.envを必ず入れる)
4. X検索用スクリプト
- SocialData.toolsのsearch-tweetsエンドポイントを使う
- 参考: https://docs.socialdata.tools/reference/search-tweets
- キーワード・期間・最低いいね数を引数で変えられるようにする
5. YouTube検索用スクリプト
- search.listで動画IDを集めてからvideos.listで詳細を取る2段構成
- 初期値は「直近30日・viewCount順・20件・regionCode=JP」
6. 結果をMarkdown表で保存するresults/フォルダ
## 秘密のキーの扱い(必ず守る)
- APIキーは.envからだけ読み込む。コードやログに直接書かない
- .envの中身を画面に表示しない
- .envをGitにコミットしない
## 確認手順
1. .envの2つのキーが読み込めているかを、キーの中身を表示せずに確認する方法を用意して実行する
2. Xは「AI ツール min_faves:1000 lang:ja -filter:replies」で1回テスト検索する
3. YouTubeは「AI 副業」で1回テスト検索する
4. どちらもresults/にMarkdown表で保存されたら完成
## コストの事前確認
- 実行前に「今回どのAPIを何回叩くか」を先に教えてください
- Xは1,000ツイートあたり$0.20、YouTubeはsearch.list 1回で100クォータ消費が目安です
## エラーが出たら
エラー全文を読んで、原因の候補を3つまで挙げて、直す手順を1つずつ提案してください。
勝手に別のAPIサービスへ切り替えないでください。
このプロンプトの中身は、この後の章で1つずつ分解して説明します。「なぜこの条件なのか」が分かると、自分のジャンルに合わせて調整できるようになります。
Fable 5のバズリサーチとは?長文コンテキストが効く理由
Fable 5のバズリサーチとは、XやYouTubeの伸びている投稿・動画をAPIで大量に取得し、Claude Fable 5に読ませて「なぜ伸びたのか」の傾向を出させる分析手法です。
Claude Fable 5は、Anthropicが2026年6月に出したClaude 5ファミリー最初のモデルで、Opusより上位の「Mythosクラス」という新しいティアです。一時提供停止がありましたが、2026年7月1日にセーフガード強化版として再デプロイされています。
なぜバズリサーチにFable 5なのか。理由はシンプルで、この作業の本質が「大量のテキストを一度に読んで、パターンを抜き出すこと」だからです。
Fable 5は100万トークン級のコンテキスト(一度に読み込める文章量)を持ち、数百万トークンにわたって集中を維持できます。バズ投稿を100件、競合チャンネルの動画30本分のタイトルと数字、そういうデータを丸ごと1回で読ませて、「共通する型はこれ」と抽象化させる。ここが短いコンテキストのモデルとの決定的な差です。
しかも公式の説明では、タスクが長く複雑なほど他モデルとの性能差が大きくなるとされています。「200件の投稿から傾向を5つに整理して、自分のジャンル向けに企画10本」のような複合タスクは、まさにFable 5の得意領域です。
感覚のリサーチとの違いも整理しておきます。
- タイムラインを眺める: 自分のフォロー欄に偏る。伸びた理由は勘
- 手動で検索して目視: 30件見るのが限界。記録が残らない
- API + Fable 5: 条件を固定して数百件取得。表で残り、傾向が言語化される
「AIで作る / AIでバズる / AIで運営する」がAI駆動倶楽部の考え方です。この記事は「AIでバズる」の入口、つまりバズを再現可能なデータ作業に変えるパートです。
準備するもの(Fable 5の利用条件と料金)
- Claudeの有料プラン: Pro(月20ドル)/ Max / Team のどれか。無料プランではFable 5は使えません
- Claude Code: バージョン2.1.170以降。
claude --versionで確認し、古ければclaude update - モデル切り替え: Claude Code起動後に
/modelでFable 5を選ぶ - SocialData.toolsのアカウント: X検索用。登録無料・カード不要
- Googleアカウント: YouTube Data API v3のキー取得用
- チャージ用のカード: SocialData.toolsのクレジット購入時だけ必要(最低$5)
2026年7月1日〜7月7日は、週間利用枠の50%までFable 5を無料で使える期間限定プロモーション中です。7月8日以降はUsage Credits(従量クレジット)でのみ利用になります。
週間枠は「別枠」ではなく「内数」です。Fable 5を使った分だけ、SonnetやOpusで使える枠も減ります。大量データの傾向分析だけFable 5、細かい修正はSonnetのような使い分けが現実的です。
API利用の場合の料金は、Fable 5が100万トークンあたり入力$10 / 出力$50です。比較すると、Opus 4.8は入力$5 / 出力$25、Sonnet 5は入力$2 / 出力$10。料金や提供条件は変わる可能性があるので、最新は公式料金ページで確認してください。
Claude Codeのセットアップ自体がまだの人は、シリーズのまとめ記事から順番に進めるのが早いです。
X編:SocialData.toolsの登録とAPIキー設定
Xのバズ投稿を取るには、SocialData.toolsを使います。
SocialData.toolsとは、Xの投稿を検索・取得できる外部のAPIサービスです。X公式のAPIは有料プランのハードルが高いので、少額から従量で使えるこのサービスが個人のリサーチ用途では現実的です。
ここからの3ステップは人間の作業ですが、やることは「登録する→チャージする→キーをコピペする」だけです。不安なら、Fable 5に「今からSocialData.toolsのAPIキーを取ります。手順を隣で案内して」と頼んで、聞きながら進めても大丈夫です。
無料登録する(カード不要)
約3分SocialData.toolsのサイトでアカウントを作ります。登録は無料で、この時点ではカード情報も要りません。メールアドレスで登録して、ダッシュボードに入れればOKです。
クレジットをチャージする(最低$5)
約3分ダッシュボードのBillingからAdd Creditsでチャージします。最低チャージは$5です。
料金の目安は、1,000ツイートの取得で$0.20。つまり$5で約25,000件の投稿を取れます。週1回、100〜200件のリサーチをする使い方なら、$5で数ヶ月持つ計算です。まず$5で十分です。
料金は変わる可能性があるので、チャージ前に画面の表示を確認してください。
APIキーを取得して.envに保存する
約5分ダッシュボードでAPI Keyを発行してコピーします。
APIキーとは、サービスを利用するための合鍵にあたる秘密の文字列です。合鍵なので、人に見せたり、SNSやAIチャットに貼ったりしてはいけません。
保存先は、作業フォルダ直下の .env というファイルです。.envは、秘密のキーを書いておくメモ帳のようなファイルだと思えばOKです。Claude Codeに「.envを作って」と頼んでもいいですし、自分で作るならこの1行を書きます。
SOCIALDATA_API_KEY=ここに取得したキーを貼る
Macで、文字で指示を送る黒い画面(ターミナル)から読み込む場合は、このコマンドを使います。1行コピペしてEnterを押すだけです。
export $(cat .env | xargs)
- SocialData.toolsにログインできる
- 残高に$5入っている
- .envにSOCIALDATA_API_KEYの行がある
1つでも当てはまらない場合は、下のエラー対処へ進んでください。
X編:バズ投稿をリサーチさせるプロンプトとクエリ例4種
環境ができたら、Fable 5にリサーチを頼みます。
ポイントは、条件を全部プロンプトに書くことです。テーマ、期間、いいね数の下限、言語、除外条件、出力形式。ここが曖昧だと、雑多な投稿が混ざってクレジットだけ減ります。
リサーチプロンプト(コピペOK)
SocialData.toolsのAPI(.envのSOCIALDATA_API_KEY)を使って、Xのバズ投稿をリサーチしてください。
## 条件
- テーマ: AIツール
- 期間: 直近30日
- いいね1,000以上
- 日本語の投稿のみ(lang:ja)
- リプライと広告は除外
- 使うエンドポイントの仕様: https://docs.socialdata.tools/reference/search-tweets
## 出力
- 投稿本文 / いいね数 / リポスト数 / 投稿日時 / ユーザー名 をMarkdown表にする
- いいね数の多い順に並べる
- 表の最後に「バズった理由の傾向」を3行でまとめる
テーマの「AIツール」を自分のジャンルに変えるだけで、そのまま使えます。いいね1,000は激戦ジャンル向けの数字なので、ニッチなジャンルなら500や300に下げてください。
検索クエリ例4種
クエリとは、検索の絞り込み条件を1行にまとめた書き方のことです。記号だらけで呪文に見えますが、日本語に直すと「いいね1,000以上」「日本語だけ」のような普通の条件です。
SocialData.toolsの検索は、Xの検索演算子(絞り込み用の記号)がほぼそのまま使えます。よく使う4パターンを表にしました。
| クエリ例 | 何が取れるか |
|---|---|
AI ツール min_faves:1000 lang:ja -filter:replies |
「AI ツール」を含む、いいね1,000以上の日本語投稿。リプライ除外 |
副業 min_faves:500 lang:ja -filter:replies since:2026-05-01 |
2026年5月1日以降の「副業」投稿で、いいね500以上 |
url:x.com/i/article min_faves:1000 |
X記事(長文記事機能)でいいね1,000以上のもの。長文ニーズの調査に |
from:アカウント名 min_faves:500 |
特定アカウントの投稿のうち、いいね500以上の「当たり投稿」だけ |
記号を日本語に読み下すと、こうなります。
| 記号 | 日本語でどういう意味か |
|---|---|
min_faves:1000 |
いいね1,000以上の投稿だけに絞る |
lang:ja |
日本語の投稿だけ |
-filter:replies |
返信(リプライ)は除く |
from:アカウント名 |
このアカウントの投稿だけ |
since:2026-05-01 |
この日付以降の投稿だけ |
覚えるのは実質この表だけです。この組み合わせで、リサーチの9割は回ります。丸暗記しなくても、Fable 5に「いいね500以上の日本語投稿だけにして」と日本語で頼めば、クエリはAIが組んでくれます。
結果の見方
Fable 5が返すMarkdown表は、そのままファイルに保存させてください。「results/フォルダに日付入りのファイル名で保存して」と一言足すだけです。
保存する理由は、あとで複数回分をまとめて読ませるためです。4週間分のリサーチ結果を全部読ませて「今月伸びた型の変化」を出させる。ここで長文コンテキストが効いてきます。
YouTube編:YouTube Data API v3のキー取得とクォータ
次はYouTubeです。こちらはGoogle公式のYouTube Data API v3を使います。
YouTube Data APIとは、YouTubeの動画情報(タイトル、再生回数、チャンネル情報など)をプログラムから取得できるGoogle公式の仕組みです。無料枠だけで、個人のリサーチには十分な量を使えます。
Google Cloud Consoleでプロジェクトを作る
約3分Google Cloud Console(console.cloud.google.com)にGoogleアカウントでログインして、新しいプロジェクトを作ります。名前は「buzz-research」など、分かればなんでもOKです。
Google Cloud Consoleは画面が英語混じりで身構えますが、大丈夫です。画面が英語で表示されても、押すボタンは「プロジェクト作成」→「API有効化」→「キー発行」の3つだけ。この順番さえ守れば迷いません。
もし途中で迷子になったら、画面左上の三本線メニュー→「APIとサービス」を押せば、いつでも同じ場所に戻れます。それでも分からなくなったら、下の「AIに聞くためのプロンプト集」のGoogle Cloud Console用プロンプトを貼れば、今開いている画面から案内してもらえます。
YouTube Data API v3を有効化する
約2分「APIとサービス」→「ライブラリ」から「YouTube Data API v3」を検索して、有効にするを押します。
APIキーを取得して.envに保存する
約3分「APIとサービス」→「認証情報」→「認証情報を作成」→「APIキー」で発行し、コピーします。
.envに追記します。
YOUTUBE_API_KEY=ここに取得したキーを貼る
これでX用とYouTube用、2つのキーが.envにそろいました。
クォータ(1日の利用枠)を先に知っておく
YouTube Data APIには、1日に使える回数の上限(クォータ)があります。ゲームのスタミナのようなもので、使い切っても翌日にはまた回復します。無料枠は1日10,000です。
| 操作 | 消費クォータ | 無料枠での回数目安 |
|---|---|---|
| search.list(キーワード検索) | 100 / 回 | 約100回 / 日 |
| videos.list(動画の詳細取得) | 1 / 回 | 実質気にしなくてよい |
| 無料枠合計 | 10,000 / 日 | 検索だけなら約100回 |
重い操作はsearch.listだけです。1回の検索で100消費するので、無料枠だと1日約100回。個人のリサーチなら十分ですが、Fable 5に「10キーワード×毎時間チェックして」のような頼み方をすると昼に枯れます。
hashshnetも勉強会の準備中、検索条件を試行錯誤して1日でクォータを使い切ったことがあります。search.listは1回100消費。テスト段階では「まず1キーワードで1回だけ」を徹底してください。枠は日本時間の夕方(太平洋時間の午前0時)にリセットされます。
- Google CloudのプロジェクトでYouTube Data API v3が有効になっている
- .envにSOCIALDATA_API_KEYとYOUTUBE_API_KEYの2行がある
1つでも当てはまらない場合は、下のエラー対処へ進んでください。
YouTube編:バズ動画リサーチのプロンプト
キー設定が終わったら、Fable 5に頼みます。使うプロンプトは2種類です。
キーワード検索プロンプト(伸びている動画を探す)
YouTube Data API v3(.envのYOUTUBE_API_KEY)で、バズ動画をリサーチしてください。
## 条件
- キーワード: AI 副業
- 期間: 直近30日
- 並び順: 再生回数順(order=viewCount)
- 件数: 20件
- 地域: 日本(regionCode=JP)
- 手順: search.listで動画IDを集めてから、videos.listで再生数・高評価数・チャンネル名を取得する
## 出力
- タイトル / チャンネル名 / 再生回数 / 高評価数 / 公開日 / URL をMarkdown表にする
- 再生回数の多い順に並べる
- 最後に「伸びている動画の共通点」を3行でまとめる
## 注意
- search.listは1回100クォータ消費。実行前に、今回何回叩くかを先に教えてください
search.list→videos.listの2段構成にしているのは、search.listだけでは再生回数などの詳細が取れないからです。検索で動画IDを集めて、詳細をまとめて取りに行く。この順番はテンプレとして固定でOKです。
regionCode=JPは忘れやすい割に効きます。hashshnetが最初に試したとき、これを付け忘れて英語圏の動画が20件返ってきて、クォータ100を1回無駄にしました。日本向けの企画を作るなら必ず入れてください。
チャンネル分析プロンプト(競合の当たり動画を探す)
YouTube Data API v3で、競合チャンネルを分析してください。
## 対象
- チャンネル名(またはチャンネルURL): ここに貼る
## 手順
1. channels.listでチャンネルID・登録者数・総再生数を取得する
2. search.listでそのチャンネルの直近30本の動画を取得する
3. videos.listで各動画の再生数・高評価数・動画の長さを取得する
## 出力
- チャンネル概要(登録者数・総再生数・動画本数)
- 動画一覧をMarkdown表(タイトル / 再生回数 / 公開日 / 長さ)
- 再生回数がチャンネル平均の2倍以上ある「当たり動画」をピックアップする
- 当たり動画の共通点を3行でまとめる
チャンネル分析で見るべきは、総再生数ではなく「平均の何倍伸びたか」です。登録者1万人のチャンネルで平均5,000再生、その中に10万再生が1本ある。その1本のタイトルと構成にこそ、ジャンルの需要が出ています。
- Xのリサーチ表が1枚、results/に保存されている
- YouTubeのリサーチ表が1枚、results/に保存されている
ここまで来たら、環境構築は完了です。あとは毎週回すだけです。
リサーチ結果を投稿と動画企画に落とし込む
リサーチは、表を眺めて終わりにしたら意味がありません。ここからが本番です。
流れはこうです。
- 週1回、XとYouTubeのリサーチを回す(合計10分程度)
- 結果の表をresults/に貯める
- Fable 5に全部読ませて、傾向を「型」に整理させる
- 型を自分のジャンルに当てはめた企画案を出させる
- 人間が選んで、作って、投稿する
3〜4を一発でやるプロンプトがこれです。
results/フォルダのリサーチ結果(Markdown表)を全部読んで、私のアカウント用の企画を作ってください。
## 私のアカウント
- ジャンル:
- フォロワー数・チャンネル登録者数:
- 投稿できる頻度:
- 出せるもの(顔出し / 声 / 画面収録 など):
## やってほしいこと
1. バズ投稿・バズ動画の傾向を「型」として5つに整理する
(例: 比較型、失敗告白型、手順全公開型、ビフォーアフター型、警告型)
2. その型を私のジャンルに当てはめて、投稿・動画の企画案を10本出す
3. 各企画に、タイトル案 / 冒頭の1行 / 狙う型 / 参考にした元投稿 を付ける
4. 10本を「今の私がすぐ作れる順」に並べ替える
大事なのは「型に整理させてから当てはめる」の2段構成です。バズ投稿をそのまま真似ると劣化コピーになりますが、型まで抽象化してから自分のジャンルに置き直すと、オリジナルの企画になります。この抽象化の精度が、Fable 5クラスのモデルを使う一番の理由です。
動画企画が固まったら、制作は同シリーズの動画パイプライン記事にそのままつながります。リサーチ→企画→制作まで、Fable 5で一気通貫です。
バズリサーチでやってはいけないこと・注意点
先に釘を刺しておきます。ここを外すと、アカウントもお金も失います。
リサーチ結果から投稿文を量産して自動投稿する構成は技術的には作れますが、アカウントBanのリスクがあり、責任が取れないため推奨しません。
おすすめ範囲は「リサーチ→企画→下書きまでAI、投稿は人間が確認して手動」です。
- APIキーを公開しない: .envはGitにコミットしない。スクショにキーが写り込んでいないか確認する。AIチャットにキーそのものを貼らない
- バズ投稿の丸パクリをしない: 本文コピーは規約違反・信用毀損のリスク。参考にするのは「型」まで
- 料金の前提を固定しない: SocialData.toolsの単価、YouTube APIのクォータ、Fable 5の料金・提供条件はすべて変わる可能性があります。最新は各公式ページで確認してください
- 取得データの扱いに注意: リサーチ結果は自分の企画作りのための内部資料に留める。他人の投稿データをまとめて再配布するような使い方はしない
「確実にバズる方法」はこの記事にも存在しません。あるのは、伸びたものをデータで観測して、打率を上げる仕組みだけです。そこは正直に書いておきます。
よくあるエラーと対処法
エラー文は失敗ではなく、直す場所を教えてくれるヒントです。しかもこの手順で出るエラーの大半は、「キーの貼り間違い」か「使いすぎ」のどちらかで、壊れるものは何もありません。
画面に出た英語のエラー文は、全文をコピーしてFable 5に貼れば、大半はその場で解決します。ただし、APIキーそのものは貼らないでください。
401エラー・APIキーが無効と言われる
症状: 実行すると 401 Unauthorized や API key not valid と表示され、データが返ってこない。日本語にすると「キー(合鍵)が正しくありません」という意味です。
原因: キーのコピーミス(前後の空白、1文字欠け)、.envの変数名のスペルミス、YouTube側でキーを発行したプロジェクトと有効化したプロジェクトが別。
確認すること: .envの行が「変数名=キー」の形で余計な引用符や空白がないか。YouTubeの場合、キーを発行したプロジェクトでYouTube Data API v3が有効になっているか。
対処: 各サービスの画面からキーをコピーし直して.envに貼り直す → Google Cloud Consoleでプロジェクト名を確認してからAPI有効化とキー発行をやり直す → それでもダメならキーを再発行する。
quotaExceeded・クォータ切れと言われる
症状: YouTube検索の途中で quotaExceeded というエラーが出て、それ以上検索できなくなる。日本語にすると「今日使える回数を使い切りました」という意味で、故障ではありません。
原因: search.list(1回100消費)を回しすぎて、1日の無料枠10,000を使い切った。ループ処理で気づかないうちに大量に検索していた。
確認すること: Google Cloud Consoleの「APIとサービス」→「YouTube Data API v3」の利用量グラフ。Fable 5に頼んだ内容が「複数キーワード×繰り返し」になっていなかったか。
対処: その日は待つ(クォータは太平洋時間の午前0時、日本時間の夕方16時か17時ごろにリセット)→ 翌日から「実行前に消費クォータを申告して」の一文をプロンプトに入れる → 恒常的に足りない場合だけ増枠申請を検討する。
検索結果が0件になる
症状: エラーは出ないのに、返ってくる投稿・動画が0件。
原因: 条件が厳しすぎる(ニッチなテーマにmin_faves:1000など)、クエリの書き方ミス、期間指定が狭すぎる。
確認すること: 同じキーワードをXやYouTubeの通常の検索窓に入れて、そもそも投稿があるか。クエリの演算子部分に余計な空白や全角文字が入っていないか。
対処: min_favesを1000→300→100と段階的に下げる → 期間を直近30日→90日に広げる → キーワードを1語減らして、当たりが出てから絞り込む。
日本語の投稿・動画が取れない
症状: 検索は成功するのに、英語の投稿や海外の動画ばかり返ってくる。
原因: Xのクエリに lang:ja を入れ忘れている。YouTubeのパラメータに regionCode=JP を入れ忘れている。キーワードが英単語だけ。
確認すること: プロンプトに書いた条件が実際のクエリに反映されているか(Fable 5に「実行したクエリを見せて」と聞く)。
対処: Xは lang:ja を追加して再実行 → YouTubeは regionCode=JP を追加し、必要なら relevanceLanguage=ja も足す → キーワードに日本語を1語入れる。
残高不足・クレジットが足りないと言われる
症状: SocialData.toolsの実行時に insufficient credits や残高エラーが出て取得が止まる。日本語にすると「残高(クレジット)が足りません」という意味です。
原因: チャージした$5を使い切った。1回のリサーチで想定より大量のツイートを取得していた。
確認すること: SocialData.toolsのダッシュボードで残高。1回のリサーチで何件取っているか(1,000件で$0.20が目安)。
対処: BillingのAdd Creditsから追加チャージする(最低$5)→ プロンプトに「最大200件まで」のような上限を書く → min_favesを上げて対象を絞る。
.envのキーが読み込まれない
症状: .envにキーを書いたのに、「キーが設定されていません」という趣旨のエラーが出る。
原因: .envの置き場所が作業フォルダと違う。変数名のスペルミス。ターミナルで読み込みコマンドを実行していない。
確認すること: .envがbuzz-research/フォルダの直下にあるか。変数名が SOCIALDATA_API_KEY / YOUTUBE_API_KEY と完全一致しているか。
対処: Macならターミナルで読み込みコマンドを実行する。
export $(cat .env | xargs)
それでもダメなら、Fable 5に「.envの読み込み部分を確認して。キーの中身は表示しないで」と頼みます。ファイル名が .env.txt になっていないかも確認してください(メモアプリで作るとよく起きます)。
AIに聞くためのプロンプト集
詰まったら、状況を整理してAIに渡すのが一番早いです。
秘密のキー(APIキー)、パスワード、顧客情報、決済情報は貼らないでください。エラー文にキーが含まれている場合は、その部分をxxxxに置き換えてから貼ります。どっちから始めるか迷った時
XとYouTubeのバズリサーチ環境を作ろうとしています。
私の状況:
- 主に運用しているSNS:
- リサーチしたいジャンル:
- 使えるお金の目安:
- プログラミング経験: なし / 少しある
XのSocialData.toolsとYouTube Data API、どちらから始めるべきか、理由付きで初心者向けに教えてください。
SocialData.toolsの画面で迷った時
SocialData.toolsの設定で止まっています。
今開いている画面:
やりたいこと: チャージ / APIキー取得
画面に表示されている内容(分かる範囲で):
次にどのメニューを押せばいいか、順番に教えてください。
Google Cloud Consoleで迷った時
YouTube Data API v3のAPIキーを取ろうとして、Google Cloud Consoleで迷子になっています。
今開いている画面:
終わっている手順: プロジェクト作成 / API有効化 / まだ何も
今分からないこと:
キー取得まで、画面の名前つきで手順を教えてください。
エラーが出た時
バズリサーチのスクリプト実行でエラーが出ました。
実行した内容:
表示されたエラー全文(秘密のキー部分はxxxxに置き換え済み):
直前に変更したこと:
原因の候補を3つまで挙げて、確認する順番と直し方を教えてください。
リサーチ結果の読み方が分からない時
バズリサーチの結果表はできましたが、どう読めばいいか分かりません。
この下に結果の表を貼ります。
私のジャンル:
知りたいこと: なぜ伸びたのか / 自分に真似できる要素はどれか
表から言える傾向を5つ、初心者向けの言葉で説明してください。
根拠になった投稿も添えてください。
企画への落とし込みで迷った時
バズの傾向は分かりましたが、自分の投稿にどう落とすか迷っています。
分かった傾向:
私のアカウント(ジャンル・規模・出せるもの):
今週作れる本数:
傾向を活かした投稿案を、今週作れる本数ぶんだけ、優先度順に提案してください。
バズ投稿の丸パクリにならないよう、表現は変えてください。
バズリサーチの実務活用事例12選
環境を作ったあと、実務でどう回すか。hashshで実際に使っている用途も含めて12個並べます。
レポート納品と投稿カレンダーは、そのまま副業・受託の商品になります。指示の出し方に迷ったら、プロンプト集と組み合わせると、リサーチ→企画→納品までの指示が型で回せます。
よくある質問
Claude Fable 5は無料で使えますか?
Claude Fable 5は無料プランでは使えません。Pro(月20ドル)、Max、Teamプランが対象です。2026年7月1日〜7月7日は週間利用枠の50%までFable 5を無料で使えるプロモーション期間で、7月8日以降はUsage Credits(従量クレジット)での利用になります。条件は変わる可能性があるため、最新は公式ページで確認してください。
SocialData.toolsの料金はいくらかかりますか?
SocialData.toolsは登録無料・カード不要で、使う分だけクレジットをチャージする方式です。最低チャージは$5、ツイート取得は1,000件あたり$0.20なので、$5で約25,000件取得できます。個人のリサーチなら$5で数ヶ月使える計算です。単価は変わる可能性があるので、チャージ前に画面で確認してください。
YouTube Data APIは無料で使えますか?
YouTube Data API v3は無料枠だけで使い始められます。1日10,000クォータが無料で、キーワード検索(search.list)は1回100消費なので、1日約100回検索できます。個人のバズリサーチ用途なら無料枠で十分です。
リサーチ結果をそのまま自動投稿してもいいですか?
自動投稿はおすすめしません。アカウントBanのリスクがあり、責任が取れないためです。この記事で推奨する範囲は、リサーチ・傾向分析・企画・下書きまでをAIに任せ、投稿は人間が内容を確認して手動で行う運用です。
SonnetやOpusでもバズリサーチはできますか?
SonnetやOpusでも同じ手順は動きます。差が出るのは、数百件の投稿をまとめて読ませる傾向分析の部分です。Fable 5は100万トークン級の長文コンテキストを持ち、タスクが複雑なほど他モデルとの差が広がるため、分析だけFable 5、環境構築や小さい修正はSonnetという使い分けがコスパの良い構成です。
プログラミング知識がなくてもできますか?
プログラミング知識がなくても進められます。スクリプトを書くのはFable 5で、人間の作業はサービス登録、APIキーの取得、.envへの貼り付けだけです。エラーが出たら、エラー文をそのままFable 5に貼れば解決策を出してくれます。ただしAPIキーそのものをチャットに貼らないことだけは守ってください。
Xの公式APIを使わなくて大丈夫ですか?
X公式APIは有料プランの費用が高く、個人のリサーチ用途にはオーバースペックになりがちです。SocialData.toolsのような外部サービスは少額の従量課金で検索でき、この記事の用途には現実的です。ただし外部サービスの仕様や提供状況は変わる可能性があるため、業務で使う場合は最新の利用条件を確認してください。
まとめ
バズリサーチは、センスの作業ではなく環境構築の作業です。一度作れば、あとは週10分で回ります。
- SocialData.toolsに無料登録して、$5チャージとAPIキー取得
- Google Cloud ConsoleでYouTube Data API v3のキーを取得
- .envに2つのキーを貼る
- Claude CodeでFable 5に切り替えて、最初に送るプロンプトを貼る
- 自分のジャンルで1回リサーチを回して、傾向3行を見てみる
最初のリサーチ結果が出た瞬間、タイムラインの見え方が変わります。「なんとなく伸びてる」が「この型だから伸びてる」に変わる。そこからが、AIでバズるの本番です。
詰まったら、そこで止まらなくて大丈夫です。
この記事を読んでも分からなかった人は、公式LINEまでお問い合わせください。30分無料で面談したり、一緒に画面を見ながら作業したりすることも可能です。
更新履歴
- 2026-07-03: 初心者向けに説明を見直し。
- 2026-07-02: 記事公開。