x-research について
x-researchは、マーケティングやクリエイター、オーディエンス、競合、キャンペーン、ローカライズの判断に向け、Xの公開情報を範囲を限定して集めるスキルです。用途に応じた調査手順へ案内し、情報源や不確実性を明示します。
主な機能
- 01用途別のX調査手順への振り分け
- 02公開投稿・プロフィール・返信の収集
- 03追加検索とクレジット利用の制限
- 04証拠リンクと不確実性の記録
- 05表示指標と成果の区別
活用シーン
- 01競合アカウントの動向比較
- 02公開返信から意見や異議を把握
- 03協業候補のクリエイター探し
- 04X上の市場や言語の比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill x-researchインストール後、Claude Code で/x-researchを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/account-and-competitor-audit.mdaudience-voice.mdcampaign-scout.mdcreator-discovery.mdmarket-localization-scout.mdorganic-benchmark.mdshared-contract.md詳細
X リサーチ
マーケティング、クリエイター、オーディエンス、競合、キャンペーン、またはローカライズの判断に役立つ公開情報が必要な場合は、X リサーチのエントリーポイントとして使用してください。
リファレンス索引
リクエストに一致するルートリファレンスだけを読みます。プラットフォームの対象範囲が不明な場合は、ローカルの仕様を補足情報として参照できます。
| ユーザーの依頼 | 適用するもの |
|---|---|
| 既知のアカウント、競合アカウント、アカウント比較 | references/account-and-competitor-audit.md |
| 公開投稿、フック、形式、トピック、競合のコンテンツ | references/organic-benchmark.md |
| 返信、オーディエンスの声、異議、FAQ、フレーズ集 | references/audience-voice.md |
| クリエイター、専門家、実務担当者、パートナー、プロフィールの確認 | references/creator-discovery.md |
| ローンチ、ハッシュタグ、メンション、ブランドまたは競合のキャンペーン | references/campaign-scout.md |
| 市場、地域、言語、または越境比較 | references/market-localization-scout.md |
| プロフィール情報のみ | 既知のアカウントには x-profiles、再検索には x-user-search を使用します |
| 非公開アカウント、DM、非公開の分析データ、フォロワーの全グラフ、広告費、ターゲティング、コンバージョン、または ROAS | 中止するか、対応可能な公開 X の範囲を尋ねます |
| 複数プラットフォームにまたがる依頼 | ここでは X の範囲だけを実行し、他のプラットフォームは引き継ぎます |
最初の質問
回答によってプラットフォーム、ルート、公開/非公開の境界、初回調査の範囲、または出力形式が変わる場合に限り、質問を 1 つだけします。
| 不足している情報 | 質問 |
|---|---|
| プラットフォーム | まずどのプラットフォームを使えばよいですか? |
| X の手がかり | X の手がかりを 1 つ教えてください。キーワード、ハッシュタグ、ハンドル、プロフィール/投稿 URL、競合、キャンペーン用語、またはクリエイターの条件を指定できます。 |
| アカウント監査の対象アカウント | X のハンドル/プロフィール URL を送るか、再検索の手がかりとして使うブランドと最も近い競合を教えてください。 |
| スレッドがない状態でのオーディエンスの声の調査 | 公開 X 投稿の URL を送るか、まず 1~3 件のスレッドを候補として絞り込むための検索クエリを指定してください。 |
| 手がかりがない状態でのクリエイター発見 | ニッチ、トピック、製品、競合、オーディエンス、またはコラボレーションの目標を 1 つ指定してください。 |
| 市場が不明なローカライズ調査 | まずどの市場または言語を比較すればよいですか? |
認証情報、実装方法、スキーマ、非公開フィールド、非公開のエクスポートデータ、Cookie、または再試行方法は尋ねないでください。
実行上のルール
- 上の表に従ってリクエストのルートを決めます。
- 選択したワークフローのリファレンスだけを読みます。
- 初回調査に回答できる、最小限の収集チェーンを実行します。
- 初回調査の後は停止し、調査範囲、根拠、制限事項、次のアクションを報告します。
限定されたサンプルを、プラットフォーム全体の実態として提示しないでください。選択したルートに示された公開フィルターのみを使用してください。
公開コマンドの境界
- 準備状況の診断:
postplus doctor --skill x-research。 - ルートの意味フラグがまだ明らかでない場合に限り、
postplus research run <route> --helpでルートを確認します。 postplus research run <route> --<query/handle/url flags> --limit <n> --wait --output <result.json>を実行します。- 選択したルートに示された意味フラグのみを使用します。
- 保留中の実行は
postplus research run --resume-from <result.json>で再開します。チェックポイントに保存された不透明なハンドルを抽出したり、書き換えたりしてはいけません。 - 初回調査の範囲は限定してください。実行中の PostPlus スキルで認められた範囲内の限定的な復旧を試した後もコマンドが失敗する場合は、正確なエラーを報告して停止します。情報源を黙って差し替えたり、不足データを捏造したりしてはいけません。
- 依頼されたタスクでは、現在の価格と残高を確認した後、既存の PostPlus クレジットを使用します。見積もりのみの依頼では実行しません。クレジットが不足している場合は停止します。チャージ、サブスクリプションの購入、または結果が不確かな有料操作の再実行はしないでください。
コマンドの選択
| 目的 | ルート | フラグ |
|---|---|---|
| 投稿、タイムライン、直接 URL、返信 | x-posts | query/handle/URL を繰り返し指定、sort、limit |
| 既知のアカウントの事実 | x-profiles | handle を繰り返し指定、limit |
| キーワードによるアカウント検索 | x-user-search | query を繰り返し指定、limit |
プラットフォームのスコープやエビデンスの解釈が依然として不明確な場合にのみ、 プラットフォーム契約を参照してください。これは事前確認ではありません。
エビデンスの品質
- エビデンスが投稿、返信、プロフィールのいずれであるかを確認してください。検索スニペットでは、会話全体の内容を立証できません。
- 直接の公開 URL または検証済みの handle を優先してください。検索でヒットしない場合は、裏付けのある query、日付、言語の制約を 1 つ変更してください。
- 成功したものの結果が不十分だった場合、承認されたスコープと予算の範囲内で、変更を加えた追加入力は最大 2 回までにしてください。同一のリクエストを繰り返したり、失敗した操作や保留中の操作を隠したりしないでください。
- 十分な結果が得られたとき、上限に達したとき、または追加の入力が役に立たないときは停止してください。有用なエビデンスと不確実性を報告し、生の結果とソースリンクを保持してください。
表示される指標は観測値であり、リーチやコンバージョンではありません。アカウント検索の検索結果は、検証済みの身元ではありません。
完全な機械可読フィールドは postplus research schema --route <route> --json に属します。
処理に必要な場合にのみ参照し、毎回のリクエストの前に参照しないでください。
postplus research run x-posts \
--query "example topic" \
--wait \
--output ./result.json
CLI の構造化された結果と報告された次のアクションに従ってください。フリーテキストのメッセージから復旧を推測しないでください。 要求されたスコープと最大コストをすでにカバーしている明示的なユーザーの承認を再利用してください。それ以外の場合は、見積もりを確定する前に承認を取得してください。タスクだけから支出の承認を推測しないでください。 返されたチェックポイントまたはアクションを通じて同じ操作を再開してください。不確実な作業を再送信したり、尽くした復旧を繰り返したり、障害を回避するためにプロバイダーを切り替えたりしないでください。