mcpField
T
twitter-monitor

twitter-monitor

github.com/kangarookingデータ・データベース688199 回インストール7 週間前に更新
リポジトリ

twitter-monitor について

twitter-monitorは、X/Twitterアカウントの投稿を一度取得し、JSONまたはCSVで出力するスキルです。アカウントとAPIキーの設定を案内し、取得後にFeishuへの同期や定期実行も選べます。

主な機能

  1. 01複数アカウントの投稿取得
  2. 02JSONまたはCSVでの出力
  3. 03APIキーとページ数の設定
  4. 04Feishu同期と定期実行（任意）

活用シーン

  1. 01指定したX/Twitterアカウントの投稿収集
  2. 02確認用のアカウント投稿データ出力
  3. 03取得記録のFeishu Bitableへの追加
  4. 04試験取得後の定期監視設定

インストール

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

$npx skills add https://github.com/kangarooking/kangarooking-skills --skill twitter-monitor

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

同梱ファイル

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

assets/
accounts.example.json
env.example
references/
feishu-output.md
scheduling.md
twitterapi-setup.md
scripts/
twitter_monitor.py

詳細

Twitter モニター

ワークフロー

このスキルは、長時間稼働するデーモンではなく、実行ワークフローとして使用します。まず一度だけデータを取得し、その後、必要な場合にのみ Feishu への同期やスケジュール設定を提案します。

  1. X/Twitter のアカウント ID が指定されていない場合は、確認します。sama、@sama、プロフィール URL、またはカンマ区切りの複数の ID を受け付けます。
  2. TWITTER_API_KEY が利用できない場合は、twitterapi.io の API キーを提供または設定するようユーザーに依頼します。API キーをリポジトリにコミットされるファイルに書き込まないでください。
  3. ページネーションの深さを確認します。デフォルトは --pages 1 です。ユーザーがより多くの履歴を求める場合、または API の使用量が増えることを了承した場合にのみ、大きい数を使用します。
  4. scripts/twitter_monitor.py を実行し、JSON または CSV の出力を生成します。
  5. ユーザーが Feishu/Lark Bitable への出力を希望する場合は、references/feishu-output.md に従います。
  6. 一度だけのコマンドが正常に動作した後、定期実行を希望するか確認します。希望する場合は、適切に OpenClaw を含め、references/scheduling.md に従います。

クイックスタート

このスキルのディレクトリから実行します。

export TWITTER_API_KEY="..."
python scripts/twitter_monitor.py --accounts sama --pages 1 --format json

複数のアカウントの場合：

python scripts/twitter_monitor.py --accounts sama,elonmusk,OpenAI --pages 1 --format csv

JSON のアカウントリストの場合：

python scripts/twitter_monitor.py --accounts-file assets/accounts.example.json --pages 1

ユーザーが API キーの設定、アカウント入力の例、またはコマンドのバリエーションを必要とする場合は、references/twitterapi-setup.md を参照してください。

出力スキーマ

スクリプトは、ツイートごとに次のフィールドを含むレコードを 1 件出力します。

  • 推文内容
  • 日期
  • 推文链接
  • 推文ID
  • 作者
  • 作者ID
  • 阅读量
  • 点赞数
  • 转发数
  • 评论数
  • 收藏数
  • 是否回复
  • 抓取时间

永続的な保存先に追加する前に、推文ID で重複を除去してください。

Feishu

通常のデータ取得で Feishu の設定を必須にしないでください。Feishu/Lark Bitable へのレコードの書き込み、追加、または同期をユーザーが希望する場合にのみ、Feishu ワークフローを開始します。

ハードコードされた Feishu アプリの認証情報よりも feishu-cli を優先してください。feishu-cli がない場合は、インストールして設定するかどうかを確認します。フィールドのマッピングと同期ルールについては、references/feishu-output.md を参照してください。

スケジュール設定

一度だけのデータ取得が成功した後、またはユーザーが明示的に継続的なモニタリングを求めた場合にのみ、スケジュール設定を提案します。

エージェントが管理する定期ジョブをユーザーが希望する場合、またはすでに OpenClaw を使用している場合は、OpenClaw を優先します。それ以外の場合は、実行環境に応じて Codex automations、cron、または launchd を選択します。references/scheduling.md を参照してください。

安全性

実際の API キー、Feishu トークン、非公開のモニタリングデータを含む出力ファイル、またはローカルのステータスキャッシュを、絶対にコミットしないでください。シークレットは、環境変数、シークレットマネージャー、またはユーザーが既に使用している CLI 認証に保管してください。

コメント

Markdown 対応