tweetapi/agent-skill

TweetAPI 読み取り専用ワークフロー

公開のTwitter/Xデータを読み取り専用で操作するためにTweetAPIを使用します。認証情報はサーバー側に保持し、クォータの消費は明示的に管理します。

安全境界を徹底する

• 公開データまたは公開ドキュメントを取得する操作のみを許可します。
• 投稿、返信、削除、いいね、リツイート、ブックマーク、フォロー、アンフォロー、またはプロフィール・リスト・コミュニティの状態変更は行いません。
• ダイレクトメッセージ、受信箱、通知、プライベートアカウント分析、課金、APIキー管理、管理、内部エンドポイントにはアクセスしません。
• Twitter/Xへのログインやセッション自動化は行いません。
• パスワード、クッキー、authToken、ct0、TOTPコード、プロキシ認証情報、プライベートメッセージのコンテンツを決して要求、受け入れ、保存、転送しません。
• それらのシークレットを必要とするエンドポイント（たとえ公開APIドキュメントに記載されていても）を決して呼び出しません。
• HTTPメソッドだけを安全性の証拠として扱わないでください。操作の効果と必須フィールドを確認してください。
• X Corp.との提携を主張しないでください。TweetAPIはサードパーティサービスです。

要求されたタスクがこの境界を越える場合は、除外されたアクションを説明し、読み取り専用の代替案を提案してください。より広範なTweetAPI製品がより多くの操作をサポートしているという理由だけで、境界を緩めてはいけません。

実行パスを選択する

ユーザーがエージェントにドキュメントを参照させたり、範囲を限定した公開データの検索をさせたい場合は、ホスト型MCPサーバーを使用してください。OAuthフローを優先することで、APIキーが会話に含まれるのを防ぎます。クライアントを設定したりライブツールを呼び出す前に、references/hosted-mcp.mdをお読みください。

アプリケーションを変更する場合は、サーバーサイドRESTまたは公式SDKを使用してください。統合コードを書く前に、references/integration.mdをお読みください。

ドキュメントのみの質問の場合は、ライブデータリクエストを行わずに、公式の公開ソースを参照してください。エンドポイント名、パラメータ、レスポンスフィールド、インストール手順が最新である必要がある場合は、references/sources.mdを参照してください。

ワークフローに従う

1. リクエストがドキュメントのみ、ライブ検索、アプリケーション統合のいずれであるかを特定します。
2. エンドポイントまたはツールを選択する前に、操作を安全境界に照らして確認します。
3. コピーされたエンドポイントカタログに頼るのではなく、現在の公開ドキュメントを参照します。
4. エージェント使用の場合はMCP OAuthを、アプリケーションコードの場合はサーバーサイドAPIキーを選択します。
5. ライブリクエストの前に、クォータを消費することを明示します。
6. デフォルトでは、最大1回のライブツール呼び出しを行い、1ページのみ取得します。
7. 自動的にページネーションを追跡するのではなく、返されたページネーションカーソルを公開します。次のページの前に確認を取ります。
8. HTTP 2xxのレスポンスのみを成功として扱います。認証、クォータ、検証の失敗は明確に表示します。
9. アプリケーションの変更はモックやフィクスチャで検証します。ユーザーが明示的に許可しない限り、セットアップやテスト中にライブクォータを使用しないでください。

クォータとページネーションを制御する

すべてのライブデータリクエストはクォータを消費します。再試行や後続のページは追加のクォータを消費する可能性があります。

• 自動ページネーションは行わないでください。
• ライブリクエストを黙って再試行しないでください。
• 設定を確認するためだけにライブの「スモークテスト」を実行しないでください。
• 最初のページで停止し、返されたカーソルを公開してください。
• ユーザーが明示的にマルチページアプリケーション動作を要求する場合は、ページ数、アイテム数、総リクエスト数に設定可能な最大値を実装してください。無制限のページネーションヘルパーは決して使用しないでください。

認証情報を保護する

• TWEETAPI_API_KEYはサーバー専用の環境変数またはシークレットマネージャーに保持してください。
• ブラウザコード、モバイルバンドル、ソース管理、ログ、サンプル、プロンプトに埋め込まないでください。
• YOUR_API_KEYはドキュメントのプレースホルダーとしてのみ使用してください。
• 互換性のあるエージェントクライアントには、https://mcp.tweetapi.com/mcpを使用したOAuthを優先してください。
• ログに記録する前に、機密性の高いユーザー入力が含まれる可能性がある場合は、レスポンスデータを編集してください。

ソースの正確性を維持する

公開製品ドキュメントは、このスキルよりも広範な製品をカバーしています。ドキュメントに記載されているすべてのエンドポイントがここで許可されていると推測しないでください。OpenAPI URL、Postmanコレクション、SDKメソッド、またはMCPツール名をでっち上げないでください。ソースリファレンスから現在の詳細を確認してください。

ソース間で矛盾がある場合は、その矛盾を報告し、解決されるまでライブ呼び出しを避けてください。