tweetapi/agent-skill

Workflows en lecture seule TweetAPI

Utilisez TweetAPI pour les données publiques Twitter/X tout en maintenant l'opération en lecture seule, les identifiants côté serveur, et l'utilisation du quota explicite.

Appliquer la frontière de sécurité

• Autorisez uniquement les opérations qui récupèrent des données publiques ou de la documentation publique.
• Ne publiez pas, ne répondez pas, ne supprimez pas, n'aimez pas, ne retweetez pas, ne mettez pas en signet, ne suivez pas, ne vous désabonnez pas, et ne modifiez pas l'état du profil, des listes ou de la communauté.
• N'accédez pas aux messages directs, boîtes de réception, notifications, analyses de comptes privés, facturation, gestion des clés API, administration, ou aux points de terminaison internes.
• N'effectuez pas de connexion ou d'automatisation de session Twitter/X.
• Ne demandez, n'acceptez, ne stockez et ne transmettez jamais de mots de passe, cookies, authToken, ct0, codes TOTP, identifiants de proxy, ou contenu de messages privés.
• N'appelez jamais un point de terminaison qui requiert l'un de ces secrets, même s'il apparaît dans la documentation publique plus large.
• Considérez la méthode HTTP comme une preuve insuffisante de sécurité. Confirmez l'effet de l'opération et les champs requis.
• Ne revendiquez pas d'affiliation avec X Corp. TweetAPI est un service tiers.

Si une tâche demandée franchit cette frontière, expliquez l'action exclue et proposez une alternative en lecture seule. N'affaiblissez pas la frontière simplement parce que le produit TweetAPI plus large prend en charge davantage d'opérations.

Choisir un chemin d'exécution

Utilisez le serveur MCP hébergé lorsque l'utilisateur souhaite qu'un agent inspecte la documentation ou effectue une recherche de données publiques limitée. Préférez son flux OAuth afin qu'aucune clé API n'entre dans la conversation. Lisez references/hosted-mcp.md avant de configurer un client ou d'invoquer un outil en direct.

Utilisez REST côté serveur ou un SDK officiel lors de la modification d'une application. Lisez references/integration.md avant d'écrire du code d'intégration.

Pour les questions purement documentaires, lisez les sources publiques canoniques sans effectuer de requête de données en direct. Lisez references/sources.md à chaque fois que les noms de points de terminaison, paramètres, champs de réponse ou instructions d'installation doivent être à jour.

Suivre le workflow

1. Identifiez si la requête est purement documentaire, une recherche en direct, ou une intégration d'application.
2. Vérifiez l'opération par rapport à la frontière de sécurité avant de sélectionner un point de terminaison ou un outil.
3. Consultez la documentation publique actuelle au lieu de vous fier à un catalogue de points de terminaison copié.
4. Choisissez OAuth MCP pour une utilisation avec un agent ou une clé API côté serveur pour le code d'application.
5. Indiquez avant une requête en direct qu'elle consomme du quota.
6. Effectuez au plus un appel d'outil en direct et récupérez une page par défaut.
7. Retournez tout curseur de pagination au lieu de le suivre automatiquement. Demandez avant une autre page.
8. Considérez uniquement les réponses HTTP 2xx comme un succès. Signalez clairement les échecs d'authentification, de quota et de validation.
9. Validez les modifications d'application avec des simulations ou des jeux de données. Ne dépensez pas de quota en direct pendant la configuration ou les tests, sauf si l'utilisateur l'autorise explicitement.

Contrôler le quota et la pagination

Chaque requête de données en direct consomme du quota. Les tentatives et les pages suivantes peuvent consommer du quota supplémentaire.

• N'auto-paginez pas.
• Ne réessayez pas silencieusement une requête en direct.
• N'effectuez pas de "test de fumée" en direct simplement pour prouver la configuration.
• Arrêtez-vous après la première page et exposez le curseur retourné.
• Si l'utilisateur demande explicitement un comportement multi-page pour une application, implémentez un maximum configurable pour les pages, les éléments et le nombre total de requêtes. N'utilisez jamais un outil de pagination sans limite.

Protéger les identifiants

• Conservez TWEETAPI_API_KEY dans une variable d'environnement ou un gestionnaire de secrets côté serveur uniquement.
• Ne l'intégrez jamais dans du code navigateur, des bundles mobiles, le contrôle de source, des journaux, des exemples ou des prompts.
• Utilisez YOUR_API_KEY uniquement comme espace réservé dans la documentation.
• Préférez OAuth avec https://mcp.tweetapi.com/mcp pour les clients agents compatibles.
• Rédigez les données de réponse avant de les journaliser si elles peuvent contenir des entrées utilisateur sensibles.

Préserver la précision des sources

La documentation publique du produit couvre un produit plus large que cette compétence. Ne déduisez pas que chaque point de terminaison documenté est autorisé ici. N'inventez pas d'URL OpenAPI, de collection Postman, de méthode SDK ou de nom d'outil MCP. Vérifiez les détails actuels à partir de la référence des sources.

Lorsque les sources sont en désaccord, signalez le conflit et évitez un appel en direct jusqu'à résolution.