mcpField
S
storyclaw-x-manager

storyclaw-x-manager

github.com/storyclaw-officialマーケティング・グロース046 回インストール今日更新
リポジトリ

storyclaw-x-manager について

storyclaw-x-manager は、X アカウントの投稿、交流、タイムライン確認、検索、分析を行うスキルです。ユーザーごとの認証情報管理とキーワードによる自動返信に対応します。

主な機能

  1. 01投稿と長文の分割
  2. 02いいね、返信、リポスト
  3. 03ユーザー投稿とタイムラインの取得
  4. 04投稿の検索
  5. 05キーワード自動返信の設定

活用シーン

  1. 01X アカウントへのお知らせ投稿
  2. 02アカウントのタイムライン確認や投稿検索
  3. 03指定キーワードへの返信自動化

インストール

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

$npx skills add https://github.com/storyclaw-official/talenthub --skill storyclaw-x-manager

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

同梱ファイル

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

.gitignore
credentials/
example.json
scripts/
get_timeline.py
get_user_tweets.py
like_tweet.py
post_tweet.py
reply_tweet.py
retweet.py
search_tweets.py

詳細

X マネージャー - Twitter/X アカウント管理

X（旧 Twitter）アカウントを管理します。投稿、エンゲージメント、タイムライン、分析に対応しています。

マルチユーザーアーキテクチャ

各ユーザーの認証情報は credentials/{USER_ID}.json に保存されます。

{
  "twitter": {
    "api_key": "",
    "api_secret": "",
    "access_token": "",
    "access_token_secret": "",
    "bearer_token": ""
  }
}

ユーザーに設定済みの Twitter 認証情報がない場合は、まず X アカウントを連携するよう促してください。

または、環境変数を設定します：TWITTER_API_KEY、TWITTER_API_SECRET、TWITTER_ACCESS_TOKEN、TWITTER_ACCESS_TOKEN_SECRET、TWITTER_BEARER_TOKEN。

対応する操作

1. ツイートを投稿
python3 {baseDir}/scripts/post_tweet.py <USER_ID> "<tweet content>" [--media <image_path>]

最大 280 文字です。これより長いツイートは、Premium／Enterprise アカウントの場合、自動的に分割されます。

2. エンゲージメント

いいね：

python3 {baseDir}/scripts/like_tweet.py <USER_ID> <tweet_id>

返信：

python3 {baseDir}/scripts/reply_tweet.py <USER_ID> <tweet_id> "<reply content>"

リツイート：

python3 {baseDir}/scripts/retweet.py <USER_ID> <tweet_id>
3. データ取得

ユーザーのツイート：

python3 {baseDir}/scripts/get_user_tweets.py <USER_ID> <twitter_handle> [--count <n>]

タイムライン：

python3 {baseDir}/scripts/get_timeline.py <USER_ID> [--count <n>]

検索：

python3 {baseDir}/scripts/search_tweets.py <USER_ID> "<keywords>" [--count <n>]

自動インタラクションのワークフロー

state/{USER_ID}.json で設定します。

{
  "auto_reply": {
    "enabled": true,
    "keywords": ["keyword1", "keyword2"],
    "reply_template": "Thanks {username} for {keyword}!"
  }
}

エラー処理

  • API のレート制限：待ってから再試行するようユーザーに促します
  • 認証エラー：X アカウントを再連携するようユーザーに促します
  • ツイートが長すぎる：自動的に分割するか、短くするようユーザーに促します

Twitter API のプラン

  • Free：読み取り専用。投稿はできません
  • Premium（$100/月）：投稿＋分析
  • Enterprise：より高い制限

コメント

Markdown 対応