mcpField
T
twitter-reader

twitter-reader

github.com/himself65生産性3.5k3.2k 回インストール4 日前に更新
リポジトリ

twitter-reader について

twitter-readerは、Twitter/X上の市場の議論やセンチメント、金融ニュースを調べる読み取り専用スキルです。opencliで既存のChromeログインセッションを再利用し、APIキーやCookieの抽出を必要としません。

主な機能

  1. 01ツイート検索とタイムライン表示
  2. 02プロフィール、スレッド、記事の閲覧
  3. 03トレンド、ブックマーク、通知の確認
  4. 04構造化形式での結果出力
  5. 05既存のChromeセッションの再利用

活用シーン

  1. 01市場テーマのセンチメント追跡
  2. 02アナリストの最近の投稿の確認
  3. 03金融ニュースやトレンドの監視

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/himself65/finance-skills --skill twitter-reader

インストール後、Claude Code で/twitter-readerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
commands.md
schema.md

詳細

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

ホスト側で以下のシェルプローブがまだ実行されていない場合（たとえば Codex）、セットアップ方法を選ぶ前に、シェルツールを使って ! で囲まれたコマンドを実行してください。実際の出力を使用してください。シェルにアクセスできない場合は、その制限を伝えてください。

opencli を使用して、金融調査のために Twitter/X を読み取ります。opencli は、ブラウザーセッションを再利用してウェブサービスをターミナルにつなぐ汎用 CLI ツールです。

このスキルは読み取り専用です。 金融調査を目的としており、マーケットに関する議論の検索、アナリストのツイートの閲覧、センチメントの追跡、Twitter/X 上の金融ニュースの監視に使用できます。投稿、いいね、リツイート、返信などの書き込み操作には対応していません。

重要：opencli は既存の Chrome ログインセッションを再利用するため、API キーや Cookie の抽出は不要です。Chrome で x.com にログインし、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 の場合は、まずインストールしてください。

# Install opencli globally
npm install -g @jackwener/opencli

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

セットアップ

opencli の使用には Node.js >= 20 と、Browser Bridge 拡張機能をインストールした Chrome ブラウザーが必要です。

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

このコマンドはデーモンを自動的に起動し、拡張機能が接続されていることを確認して、セッションの状態をチェックします。

よくあるセットアップの問題
症状対処方法
Extension not connectedChrome に Browser Bridge 拡張機能をインストールし、有効になっていることを確認します
Daemon not runningopencli doctor を実行します。デーモンは自動的に起動します
No session for twitter.comChrome で x.com にログインしてから、再試行します
CSRF token missingChrome で x.com を更新して、ct0 Cookie を再生成します

ステップ 2：ユーザーのニーズを特定する

ユーザーのリクエストに対応する読み取りコマンドを以下から選び、references/commands.md に記載された対応するコマンドを使用してください。

ユーザーのリクエストコマンド主なフラグ
セットアップの確認opencli doctor—
ホームフィード／タイムライン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：コマンドを実行する

一般的なパターン
# Use -f json or -f yaml for structured output
opencli twitter timeline -f json --limit 20
opencli twitter timeline --type following --limit 20

# Recent tweets from a specific user
opencli twitter tweets elonmusk --limit 20 -f json

# Searching for financial topics
opencli twitter search "$AAPL earnings" --filter live --limit 10 -f json
opencli twitter search "Fed rate decision" --limit 20 -f yaml

# Trending topics
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. 読み取り専用です — opencli で一部のコマンドを使用できても、投稿、いいね、リツイート、返信、引用、フォロー、削除は行わないでください
出力形式フラグ（-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：結果を提示する

生データをそのまま並べるのではなく、ユーザーの調査上の疑問にとって重要な情報から示します。各ツイートには、投稿者（@handle）、本文、いいねや閲覧数などの反応、ユーザーがスレッド全体を確認する可能性がある場合は URL を付けます。検索結果はテーマごとに分類し、強気または弱気の傾向や、見解がコンセンサスなのか逆張りなのかを示します。プロフィールについては、フォロワー数、プロフィール文、最近の注目すべき活動を伝えます。ブラウザーのセッション情報は非公開にしてください。

ステップ 5：診断

問題が発生した場合は、次を実行します。

opencli doctor

デーモンの状態、拡張機能の接続状況、ブラウザーセッションの状態を確認します。

エラーのリファレンス

エラー原因対処方法
Extension not connectedBrowser Bridge がインストールされていないか、無効になっています拡張機能をインストールし、Chrome で有効にします
No sessionx.com にログインしていませんChrome で x.com にログインします
CSRF token missingCookie の有効期限が切れているか、ページの再読み込みが必要ですChrome で x.com を再読み込みします
Rate limitedリクエストが多すぎます数分待ってから再試行します

リファレンスファイル

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

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

コメント

Markdown 対応