mcpField
T
twitter

twitter

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

twitter について

twitter-cliを使ってTwitter/Xを調査する読み取り専用スキルです。ブラウザーセッションで認証し、投稿、フィード、プロフィール、ブックマーク、リストを検索・閲覧できます。

主な機能

  1. 01条件を指定した投稿検索
  2. 02フィード・ブックマーク・リストの閲覧
  3. 03投稿と記事の表示
  4. 04プロフィールと活動の確認
  5. 05JSON・YAML形式での出力

活用シーン

  1. 01株式や市場イベントの議論を追跡
  2. 02アナリストの投稿を確認
  3. 03ユーザーの最近の活動を監視
  4. 04金融調査用の投稿を収集

インストール

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

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

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

同梱ファイル

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

README.md
references/
commands.md
schema.md

詳細

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

ブラウザーの Cookie 認証で Twitter にアクセスするコマンドラインツール、twitter-cli を使用して、金融調査のために Twitter/X を読み取ります。

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

重要：このツールはブラウザーのセッション Cookie を使用します。API キーは不要です。ログイン済みのブラウザーセッション（Chrome、Arc、Edge、Firefox、Brave）を介して認証します。

ステップ 1：twitter-cli がインストールされ、認証済みであることを確認する

現在の環境の状態：

!`(command -v twitter && twitter status --yaml 2>&1 | head -5 && echo "AUTH_OK" || echo "AUTH_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

上記の状態が AUTH_OK の場合は、ステップ 2 に進んでください。NOT_INSTALLED の場合は、先にインストールしてください。

# Install (requires Python 3.10+)
uv tool install twitter-cli

AUTH_NEEDED の場合は、ユーザーに次の手順を案内してください。

認証方法

方法 A：ブラウザー Cookie の抽出（推奨）

ユーザーが Arc／Chrome／Edge／Firefox／Brave で x.com にログインしていることを確認してください。twitter-cli が Cookie を自動的に抽出します。次のコマンドで確認してください。

twitter whoami

Chrome の複数プロフィールはすべて自動的にスキャンされます。特定のプロフィールを指定するには、次を実行します。

TWITTER_CHROME_PROFILE="Profile 2" twitter feed

方法 B：環境変数

export TWITTER_AUTH_TOKEN="<auth_token from browser>"
export TWITTER_CT0="<ct0 from browser>"
twitter whoami
よくある認証の問題
症状対処方法
No Twitter cookies foundブラウザーで x.com にログインするか、環境変数を設定します
Cookie expired (401/403)x.com に再ログインして、再試行します
Unable to get key for cookie decryption（macOS）SSH の場合は security unlock-keychain ~/Library/Keychains/login.keychain-db を実行するか、「キーチェーンアクセス」で Terminal を許可します

ステップ 2：ユーザーが必要としているものを特定する

ユーザーのリクエストを以下の読み取りコマンドに照らし合わせ、references/commands.md に記載されている対応するコマンドを使用します。

ユーザーのリクエストコマンド主なフラグ
認証の確認twitter status--yaml
自分のアカウント情報twitter whoami--json、--yaml
ホームフィード／タイムラインtwitter feed-t following、--max N、--full-text、--filter
ツイートの検索twitter search "QUERY"-t Latest、--from USER、--since DATE、--lang、--exclude retweets、--has links、--max N
ブックマークtwitter bookmarks--max N、--full-text
特定のツイートを表示twitter tweet TWEET_ID_OR_URL--full-text
直近のリストからツイートを開くtwitter show N--full-text、--json
Twitter 記事twitter article ID_OR_URL--markdown、--output FILE、--json
リストのタイムラインtwitter list LIST_ID--full-text、--max N
ユーザープロフィールtwitter user USERNAME--json
ユーザーのツイートtwitter user-posts USERNAME--max N、--full-text、-o FILE
ユーザーのいいねtwitter likes USERNAME自分のアカウントのみ（2024年6月以降非公開）
フォロワーtwitter followers USERNAME--max N
フォロー中twitter following USERNAME--max N

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

基本パターン
# Use --yaml for structured output, -c for compact (token-efficient)
twitter feed --yaml --max 20
twitter -c feed --max 10              # Compact: ~80% fewer tokens than --json

# Searching for financial topics
twitter search "$AAPL earnings" -t Latest --max 10 --full-text --yaml
twitter search "Fed rate decision" --since 2026-03-01 --max 20 --yaml
twitter search "market crash" --exclude retweets --has links --max 15
主なルール
  1. 最初に認証を確認する — 他のコマンドを実行する前に twitter status --yaml を実行します
  2. データをプログラムで処理する場合は、--yaml または --json を使用する — 構造化された出力を取得できます
  3. トークン効率が重要な場合（LLM のコンテキスト）は、-c／--compact を使用する
  4. ユーザーがツイートの内容全体を求めている場合は、--full-text を使用する — リッチテーブルでは、既定でテキストが省略されます
  5. 結果を制限するには --max N を使用する — ユーザーがそれ以上を求めていない限り、10～20 件から始めます
  6. 検索ではフィルターを使用する — --from、--since、--lang、--exclude retweets、--has links
  7. ツイート ID と URL — どちらも使用できます：twitter tweet 1234567890 または twitter tweet https://x.com/user/status/1234567890
  8. 直近のリスト出力からツイート #N を参照するには、twitter show N を使用する
  9. 書き込み操作は絶対に実行しない — このスキルは読み取り専用です。投稿、いいね、リツイート、返信、引用、フォロー、削除を行わないでください
出力フラグ（すべての読み取りコマンド）
フラグ用途
--jsonJSON 出力
--yamlYAML 出力（非 TTY でのデフォルト）
--full-textツイート全文を表示（リッチテーブルのみ）
-c / --compact最小限のフィールド。LLM のコンテキストに最適です
-o FILE / --output FILE出力をファイルに保存
--input FILE以前に保存した JSON から読み込み
構造化出力エンベロープ

すべての --yaml および --json 出力では、このエンベロープが使用されます（references/schema.md を参照）。

ok: true
schema_version: "1"
data: ...          # tweet/user lists or single objects

エラーレスポンス：

ok: false
schema_version: "1"
error:
  code: api_error
  message: "..."

ステップ 4：結果を提示する

データを取得したら、金融調査に役立つよう、次の点を明確に提示します。

  1. 主要な内容を要約する — ユーザーの金融調査に最も関連するツイートを取り上げます
  2. 投稿者を明記する — @username、ツイート本文、エンゲージメント指標（いいね、リツイート）を示します
  3. 必要に応じてツイート ID／URL を提示する — ユーザーがスレッド全体を読みたい場合に備えます
  4. 検索結果の場合 — 関連度ごとに分類し、主要なテーマ、センチメント、市場シグナルを取り上げます
  5. ユーザープロフィールの場合 — フォロワー数、自己紹介、注目すべき最近の活動を提示します
  6. センチメントを示す — 強気／弱気のセンチメントや、コンセンサスと逆張りの見解を記載します
  7. Cookie を秘密情報として扱う — Cookie の値を stdout に出力しないでください

ステップ 5：診断

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

twitter doctor

バージョン、OS、ブラウザーの検出結果、キーチェーンの状態、Cookie の抽出結果を報告します。

任意のコマンドで詳細な診断を行うには、-v を追加します。

エラーリファレンス

エラー原因対処方法
No Twitter cookies found認証されていませんブラウザーで x.com にログインするか、環境変数を設定してください
HTTP 401/403Cookie の有効期限が切れていますx.com に再ログインして、もう一度お試しください
HTTP 404QueryId のローテーション再試行してください（自動フォールバックが組み込まれています）
HTTP 429レート制限15 分以上待ってから、もう一度お試しください

プロキシ設定

export TWITTER_PROXY=http://127.0.0.1:7890
# or
export TWITTER_PROXY=socks5://127.0.0.1:1080

リファレンスファイル

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

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

コメント

Markdown 対応