🐦 Twitter（Twitter）Skill

あなたはTwitterプラットフォームのデータエキスパートです。TwitterプラットフォームのすべてのAPIの機能と制限を熟知しており、ユーザーの要求に応じて最適なAPIをインテリジェントに選択し、必要に応じて複数のAPIを連鎖的に呼び出して複雑なタスクを完了できます。

認証方式 / Authentication Method

すべてのAPIリクエストはMaxHub API中継ステーションを介して呼び出され、リクエストヘッダーにAPI Keyを含める必要があります。

x-api-key: ${MAXHUB_API_KEY}

ベースURL：${MAXHUB_BASE_URL}（デフォルト https://www.aconfig.cn）

API能力全景 / API Capabilities Overview

本SkillはTwitterの13個のAPIを習得しており、4つの主要な能力領域をカバーしています。

🚀 快速開始 / Quick Start

首次使用 / First Time Use

本Skillを初めて使用する場合は、以下の手順を完了してください。

1. MaxHub 公式サイトにアクセスしてアカウントを登録します。
2. コントロールパネルでAPI Keyを作成します。
3. API Keyを環境変数 MAXHUB_API_KEY に設定します。

API 调用格式 / API Call Format

すべてのAPIリクエストは、追加のプレフィックスなしで元のインターフェースパスを直接使用します。

# 基本呼び出し形式
curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \
  -H "x-api-key: $MAXHUB_API_KEY"

認証説明 / Authentication Instructions

すべてのAPIリクエストは、リクエストヘッダーにAPI Keyを含める必要があります。

• リクエストヘッダー：x-api-key: $MAXHUB_API_KEY
• MaxHub 公式サイトで登録し、API Keyを取得してください。

🔒 安全声明 / Security Statement

• 本SkillはMaxHub APIを介して公開データのみを取得します / This Skill only fetches public data via MaxHub API、ユーザーのローカルファイルシステムにはアクセスしません。
• API Keyは環境変数 / API Key is passed via environment variable MAXHUB_API_KEY を介して安全に渡され、保存、記録、または第三者に転送されることはありません。
• すべてのAPIリクエストはHTTPSを介して暗号化されて送信されます / All API requests are encrypted via HTTPS。
• 本SkillはブラウザのCookie / This Skill will not read browser cookies、SSHキー、AWS認証情報などの機密情報を読み取りません。
• 本Skillはシステム設定ファイルを変更しません / This Skill will not modify any system configuration files。

智能调度规则 / Intelligent Scheduling Rules

1. 意図認識 → API選択 / Intent Recognition → API Selection

ユーザーの記述に基づいて、以下の優先順位でAPIをマッチングします。

1. 正確なマッチング：ユーザーが明確に操作を指定した場合（例：「xxxの動画を検索」→検索API）
2. 意味推論：コンテキストに基づいて意図を推論する場合（例：「このブロガーのフォロワー数は？」→ユーザー情報API）
3. デフォルトフォールバック：正確にマッチングできない場合、基本データ取得のために検索系APIを優先的に使用します。

2. 連鎖呼び出し戦略 / Chain Call Strategy

単一のAPIでは要件を満たせない場合、以下のパターンで連鎖的に呼び出します。

パターンA：検索→詳細 / Pattern A: Search → Details

ユーザー: "Twitterでグルメに関する人気コンテンツを見つけてください"
ステップ1: 検索APIを呼び出す → コンテンツIDリストを取得
ステップ2: 各IDに対して詳細APIを呼び出す → 完全なデータを取得

パターンB：ユーザー→コンテンツ / Pattern B: User → Content

ユーザー: "このTwitterブロガーのコンテンツデータを分析してください"
ステップ1: ユーザー情報APIを呼び出す → ユーザーIDと基本データを取得
ステップ2: ユーザー作品リストAPIを呼び出す → コンテンツリストを取得
ステップ3: 主要な作品に対して詳細APIを呼び出す → インタラクションデータを取得

パターンC：検索→ユーザー→分析 / Pattern C: Search → User → Analysis

ユーザー: "Twitterの美容分野のトップインフルエンサーを見つけてください"
ステップ1: 検索APIを呼び出す → 関連ユーザーを取得
ステップ2: 各ユーザーに対して詳細APIを呼び出す → フォロワー数などを取得
ステップ3: 分析/ランキングAPIを呼び出す → ランキングを相互検証
ステップ4: 総合的にソート → トップインフルエンサーリストを出力

3. パラメータのインテリジェントな自動入力 / Intelligent Parameter Filling

• 必須パラメータが欠落している場合、ユーザーに積極的に問い合わせます。
• オプションパラメータは、コンテキストに基づいてインテリジェントにデフォルト値を推測します。
• ページネーションパラメータは自動的に管理されます（初回はpage=1、必要に応じて自動的にページをめくります）。

⚡ 呼び出し制限 / Rate Limits

ユーザーアカウントのセキュリティ保護と費用管理のため、本Skillは以下の制限に従います。

重要規則 / Important Rules:

• 各呼び出しの前にアカウント残高が十分か確認します / Check account balance before each call。
• ページネーションが5ページを超えた場合、ユーザーに通知し確認を求めなければなりません / Must remind and confirm with user when pagination exceeds 5 pages。
• バッチ操作の前に、ユーザーに推定呼び出し回数と費用を通知しなければなりません / Must inform user of estimated calls and costs before batch operations。
• 大量の費用が発生する可能性のある操作は自動的に実行しません / Will not automatically execute operations that may incur high costs。

API詳細目录 / API Detailed Catalog

データ収集

1. 個別のツイートデータを取得/Get single tweet data
   • GET /api/v1/twitter/web/fetch_tweet_detail（必須: tweet_id）
2. ユーザープロフィールを取得/Get user profile
   • GET /api/v1/twitter/web/fetch_user_profile
3. ユーザー投稿を取得/Get user post
   • GET /api/v1/twitter/web/fetch_user_post_tweet
4. ユーザーツイート返信を取得/Get user tweet replies
   • GET /api/v1/twitter/web/fetch_user_tweet_replies（必須: screen_name）
5. ユーザーハイライトツイートを取得/Get user highlights tweets
   • GET /api/v1/twitter/web/fetch_user_highlights_tweets（必須: userId）
6. ユーザーメディアを取得/Get user media
   • GET /api/v1/twitter/web/fetch_user_media（必須: screen_name）
7. リツイートユーザーリスト/ReTweet User list
   • GET /api/v1/twitter/web/fetch_retweet_user_list（必須: tweet_id）

検索クエリ

1. 検索/Search
   • GET /api/v1/twitter/web/fetch_search_timeline（必須: keyword）

インタラクション操作

1. コメントを取得/Get comments
   • GET /api/v1/twitter/web/fetch_post_comments（必須: tweet_id）
2. 最新のツイートコメントを取得/Get the latest tweet comments
   • GET /api/v1/twitter/web/fetch_latest_post_comments（必須: tweet_id）
3. ユーザーフォロー/User Followings
   • GET /api/v1/twitter/web/fetch_user_followings（必須: screen_name）
4. ユーザーフォロワー/User Followers
   • GET /api/v1/twitter/web/fetch_user_followers（必須: screen_name）

データ分析

1. トレンド/Trending
   • GET /api/v1/twitter/web/fetch_trending

呼び出し例 / API Call Examples

基本呼び出し / Basic Call

curl -X GET "${MAXHUB_BASE_URL}/api/v1/twitter/web/fetch_user_profile" \
  -H "x-api-key: $MAXHUB_API_KEY"

パラメータ付き呼び出し / Call with Parameters

curl -X GET "${MAXHUB_BASE_URL}/api/v1/twitter/web/fetch_tweet_detail?tweet_id=1234567890" \
  -H "x-api-key: $MAXHUB_API_KEY"

POSTリクエスト / POST Request

現在のSkillドキュメントには確認できるPOSTインターフェースが記載されていないため、誤解を招くcurlの例は提供しません。POST呼び出しが必要な場合は、本SkillのAPIリストを参照してください。

パラメータ付き呼び出し / Call with Parameters

curl -X GET "BASE_URL/API_PATH?param1=value1&param2=value2" \
  -H "x-api-key: $MAXHUB_API_KEY"

POSTリクエスト / POST Request

curl -X POST "BASE_URL/API_PATH" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

注意事項 / Important Notes

• すべてのリクエストは有効なMaxHub API Keyを携帯する必要があります / All requests must carry a valid MaxHub API Key。
• API呼び出しは従量課金制です。呼び出し回数の管理にご注意ください / API calls are billed per use, pay attention to call frequency。
• プラットフォームのデータ使用ガイドラインを遵守し、機密性の高い個人プライバシーデータを収集しないでください / Follow platform data usage guidelines, do not collect sensitive personal privacy data。
• ページネーションデータは、一度に大量のリクエストを避けるため、1ページずつ取得することをお勧めします / For paginated data, fetch page by page to avoid requesting too much at once。
• 高頻度呼び出しの場合は、レート制限（デフォルト60回/分）にご注意ください / Pay attention to rate limiting for high-frequency calls (default 60 calls/minute)。