Twitter スキル（読み取り専用）

opencli を使用してTwitter/Xから金融調査用データを読み取ります。opencliはブラウザセッション再利用を通じてWebサービスをターミナルに接続するユニバーサルCLIツールです。

このスキルは読み取り専用です。 金融調査向けに設計されています：市場議論の検索、アナリストツイートの閲覧、感情追跡、Twitter/Xの金融ニュース監視。投稿、いいね、リツイート、返信、またはその他の書き込み操作はサポートしていません。

重要：opencliはChromeの既存ログインセッションを再利用します — APIキーやクッキー抽出は不要です。x.comにChromeでログインし、Browser Bridge拡張機能がインストールされていることを確認してください。

---

ステップ1：opencliがインストールされており準備完了であることを確認

現在の環境ステータス：

!`(command -v opencli && opencli doctor 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

上記のステータスが READY と表示される場合はステップ2にスキップしてください。NOT_INSTALLED の場合はまずインストールしてください：

# opencliをグローバルにインストール
npm install -g @jackwener/opencli

SETUP_NEEDED の場合は、ユーザーにセットアップを案内してください：

セットアップ

opencliはNode.js >= 21とBrowser Bridge拡張機能がインストールされたChromeブラウザが必要です：

1. Browser Bridge拡張機能をインストール：
   • GitHubリリースページから最新の opencli-extension-v{version}.zip をダウンロード
   • 解凍後、Chromeで chrome://extensions を開き、デベロッパーモード を有効化
   • パッケージ化されていない拡張機能を読み込む をクリックして、解凍したフォルダを選択
2. Chromeでx.comにログイン — opencliはブラウザセッションを再利用します
3. 接続を確認：

opencli doctor

これでデーモンが自動起動され、拡張機能の接続が確認され、セッションヘルスがチェックされます。

一般的なセットアップの問題

症状	解決策
Extension not connected	ChromeにBrowser Bridge拡張機能をインストールして有効化してください
Daemon not running	opencli doctor を実行してください — デーモンが自動起動します
No session for twitter.com	Chromeでx.comにログインして、再度試してください
CSRF token missing	Chromeでx.comをリフレッシュしてct0クッキーを再生成してください

---

ステップ2：ユーザーの必要内容を特定

ユーザーのリクエストを以下の読み取りコマンドと対応させ、references/commands.md から対応するコマンドを使用します。

ユーザーのリクエスト	コマンド	主要フラグ
セットアップ確認	opencli twitter timeline	—
ホームフィード / タイムライン	opencli twitter timeline	--type for-you|following, --limit N (デフォルト 20)
ツイート検索	opencli twitter search "QUERY"	--filter top|live, --limit N (デフォルト 15)
トレンドトピック	opencli twitter trending	--limit N (デフォルト 20)
ブックマーク	opencli twitter bookmarks	--limit N (デフォルト 20)
ユーザーからの最新ツイート	opencli twitter tweets USERNAME	--limit N (デフォルト 20)
特定のスレッドを表示	opencli twitter thread TWEET_ID	--limit N (デフォルト 50)
Twitterアーティクル	opencli twitter article TWEET_ID	—
ユーザープロフィール	opencli twitter profile USERNAME	— (ログイン中のユーザーをデフォルト)
フォロワー	opencli twitter followers USERNAME	--limit N (デフォルト 50)
フォロー中	opencli twitter following USERNAME	--limit N (デフォルト 50)
通知	opencli twitter notifications	--limit N (デフォルト 20)

---

ステップ3：コマンドを実行

一般的なパターン

# 構造化出力の場合は -f json または -f yaml を使用
opencli twitter timeline -f json --limit 20
opencli twitter timeline --type following --limit 20

# 特定のユーザーからの最新ツイート
opencli twitter tweets elonmusk --limit 20 -f json

# 金融トピックの検索
opencli twitter search "$AAPL earnings" --filter live --limit 10 -f json
opencli twitter search "Fed rate decision" --limit 20 -f yaml

# トレンドトピック
opencli twitter trending --limit 20 -f json

主要ルール

1. セットアップを確認してから — 接続に不確実な場合は他のコマンドを実行する前に opencli doctor を実行
2. データをプログラムで処理する場合は -f json または -f yaml を使用
3. ユーザーが表計算互換の出力を必要とする場合は -f csv を使用
4. 結果数を制御するには --limit N を使用 — ユーザーがさらに多くを求めない限り10～20から開始
5. 検索では --filter を使用 — top (デフォルト) は関連性、live は最新ツイート
6. 書き込み操作は実行しない — このスキルは読み取り専用です。投稿、いいね、リツイート、返信、引用、フォロー、削除をしないでください

出力形式フラグ (-f)

形式	フラグ	最適な用途
テーブル	-f table (デフォルト)	人間が読めるターミナル出力
JSON	-f json	プログラム処理、LLMコンテキスト
YAML	-f yaml	構造化出力、読み取り可能
Markdown	-f md	ドキュメント、レポート
CSV	-f csv	表計算エクスポート

出力列

ツイート一覧コマンド (timeline, search, thread) には以下が含まれます：id, author, text, created_at, likes, retweets, replies, views, url, has_media, media_urls。

tweets (ユーザー別投稿) には is_retweet も含まれます。

bookmarks 列：author, text, likes, retweets, bookmarks, url。

trending 列：rank, topic, tweets, category。

プロフィール (profile) 列：screen_name, name, bio, location, url, followers, following, tweets, likes, verified, created_at。

followers / following 列：screen_name, name, bio, followers。

notifications 列：id, action, author, text, url。

---

ステップ4：結果を提示

データ取得後、金融調査向けに明確に提示します：

1. 主要コンテンツを要約 — ユーザーの金融調査に最も関連するツイートを強調
2. 帰属表示を含める — @username、ツイートテキスト、エンゲージメント指標（いいね、ビュー）を表示
3. ユーザーが全スレッドを読みたい場合はツイートURLを提供
4. 検索結果の場合、関連性別にグループ化し、主要テーマ、感情、市場シグナルを強調
5. ユーザープロフィールの場合、フォロワー数、バイオ、注目すべき最近のアクティビティを提示
6. 感情にフラグを付ける — 強気/弱気の感情、コンセンサスと反対意見を注記
7. セッションをプライベートとして扱う — ブラウザセッション詳細を公開しない

---

ステップ5：診断

何かがうまく機能していない場合は、実行してください：

opencli doctor

これはデーモンステータス、拡張機能接続、ブラウザセッションヘルスをチェックします。

---

エラーリファレンス

エラー	原因	解決策
Extension not connected	Browser Bridgeがインストール/有効化されていない	拡張機能をインストールしてChromeで有効化
No session	x.comにログインしていない	Chromeでx.comにログイン
CSRF token missing	クッキーの有効期限切れまたはページをリフレッシュ必要	Chromeでx.comをリフレッシュ
レート制限	リクエストが多すぎる	数分待ってから再試行

---

リファレンスファイル

• references/commands.md — 全読み取りコマンドリファレンス、すべてのフラグ、調査ワークフロー、使用例
• references/schema.md — 出力形式ドキュメント、列定義

正確なコマンド構文、調査ワークフローパターン、出力詳細が必要な場合は、リファレンスファイルを読んでください。