x-research

X リサーチ

X/Twitter 上で汎用的なエージェント型リサーチを行います。リサーチの質問を対象を絞った検索に分解し、反復的に精度を高め、スレッドを追い、リンク先のコンテンツを詳しく調査して、出典付きのブリーフィングにまとめます。

X API の詳細（エンドポイント、演算子、レスポンス形式）については、references/x-api.md をお読みください。

CLI ツール

すべてのコマンドは、このスキルのディレクトリから実行します。

cd ~/clawd/skills/x-research
source ~/.config/env/global.env

検索

bun run x-search.ts search "<query>" [options]

オプション：

• --sort likes|impressions|retweets|recent — 並べ替え順（デフォルト：likes）
• --since 1h|3h|12h|1d|7d — 期間フィルター（デフォルト：過去 7 日間）。分単位（30m）または ISO タイムスタンプも指定できます。
• --min-likes N — いいね数の最小値で絞り込み
• --min-impressions N — インプレッション数の最小値で絞り込み
• --pages N — 取得するページ数、1～5（デフォルト：1、1 ページあたり 100 件のツイート）
• --limit N — 表示する結果の最大数（デフォルト：15）
• --quick — クイックモード：1 ページ、結果は最大 10 件、自動ノイズフィルター（-is:retweet -is:reply）、キャッシュ期間 1 時間、コストの概要
• --from <username> — クエリ内の from:username の簡略表記
• --quality — エンゲージメントの低いツイートを除外（いいね数 10 件以上、取得後に適用）
• --no-replies — 返信を除外
• --save — 結果を ~/clawd/drafts/x-research-{slug}-{date}.md に保存
• --json — JSON をそのまま出力
• --markdown — リサーチ文書用の Markdown 形式で出力

クエリにすでに -is:retweet が含まれていない限り、自動的に追加します。すべての検索で API コストの推定値が表示されます。

例：

bun run x-search.ts search "BNKR" --sort likes --limit 10
bun run x-search.ts search "from:frankdegods" --sort recent
bun run x-search.ts search "(opus 4.6 OR claude) trading" --pages 2 --save
bun run x-search.ts search "$BNKR (revenue OR fees)" --min-likes 5
bun run x-search.ts search "BNKR" --quick
bun run x-search.ts search "BNKR" --from voidcider --quick
bun run x-search.ts search "AI agents" --quality --quick

プロフィール

bun run x-search.ts profile <username> [--count N] [--replies] [--json]

特定のユーザーの最近のツイートを取得します（デフォルトでは返信を除外します）。

スレッド

bun run x-search.ts thread <tweet_id> [--pages N]

ルートツイート ID を指定して、会話スレッド全体を取得します。

単一のツイート

bun run x-search.ts tweet <tweet_id> [--json]

ウォッチリスト

bun run x-search.ts watchlist                       # Show all
bun run x-search.ts watchlist add <user> [note]     # Add account
bun run x-search.ts watchlist remove <user>          # Remove account
bun run x-search.ts watchlist check                  # Check recent from all

ウォッチリストは data/watchlist.json に保存されています。ハートビートとの連携に使い、重要なアカウントが何か重要な投稿をしたかを確認します。

キャッシュ

bun run x-search.ts cache clear    # Clear all cached results

有効期間は 15 分です。同一クエリの再取得を避けます。

リサーチの反復プロセス（エージェント型）

詳細なリサーチを行う場合（簡易検索だけではない場合）は、次の手順に従います。

1. 質問をクエリに分解する

X の検索演算子を使い、リサーチの質問をキーワードクエリ 3～5 件に変換します。

• 中心となるクエリ：トピックに関する直接的なキーワード
• 専門家の見解：既知の専門家を指定する from:
• 課題：(broken OR bug OR issue OR migration) などのキーワード
• 肯定的な兆候：(shipped OR love OR fast OR benchmark) などのキーワード
• リンク：url:github.com または特定のドメインを指定する url:
• ノイズの削減：-is:retweet（自動追加）。必要に応じて -is:reply も追加します。
• 暗号資産関連のスパム：暗号資産の話題にスパムが多い場合は、-airdrop -giveaway -whitelist を追加します。

2. 検索して抽出する

各クエリを CLI で実行します。実行後、次の点を確認します。

• 有益な情報か、ノイズか。演算子を調整します。
• from: を指定して個別に検索する価値のある重要な発信者はいるか。
• thread コマンドで追う価値のあるスレッドはあるか。
• web_fetch で詳しく調査する価値のあるリンク先のリソースはあるか。

3. スレッドを追う

エンゲージメントが高いツイートや、スレッドの起点となるツイートがある場合：

bun run x-search.ts thread <tweet_id>

4. リンク先のコンテンツを詳しく調査する

ツイートに GitHub リポジトリ、ブログ記事、ドキュメントへのリンクがある場合は、web_fetch で取得します。次のリンクを優先します。

• 複数のツイートで参照されているもの
• エンゲージメントの高いツイートに含まれているもの
• 質問に直接関連する技術リソースを示すもの

5. まとめる

クエリごとではなく、テーマごとに調査結果をまとめます。

### [Theme/Finding Title]

[1-2 sentence summary]

- @username: "[key quote]" (NL, NI) [Tweet](url)
- @username2: "[another perspective]" (NL, NI) [Tweet](url)

Resources shared:
- [Resource title](url) — [what it is]

6. 保存する

--save フラグを使うか、~/clawd/drafts/x-research-{topic-slug}-{YYYY-MM-DD}.md に手動で保存します。

検索を改善するためのヒント

• ノイズが多すぎる場合：-is:reply を追加し、--sort likes を使って、キーワードを絞り込みます。
• 結果が少なすぎる場合：OR を使って範囲を広げ、制限の強い演算子を削除します。
• 暗号資産関連のスパムがある場合：-$ -airdrop -giveaway -whitelist を追加します。
• 専門家の見解だけを調べる場合：from: または --min-likes 50 を使います。
• 話題性より実質的な内容を重視する場合：has:links を使って検索します。

ハートビートとの連携

ハートビート時に watchlist check を実行して、重要なアカウントに注目すべき投稿があったかを確認できます。本当に興味深い、または対応が必要な内容だけを Frank に知らせてください。日常的なツイートは報告しないでください。

ファイル構成

skills/x-research/
├── SKILL.md           (this file)
├── x-search.ts        (CLI entry point)
├── lib/
│   ├── api.ts         (X API wrapper: search, thread, profile, tweet)
│   ├── cache.ts       (file-based cache, 15min TTL)
│   └── format.ts      (Telegram + markdown formatters)
├── data/
│   ├── watchlist.json  (accounts to monitor)
│   └── cache/          (auto-managed)
└── references/
    └── x-api.md        (X API endpoint reference)