Que fait trader-analyst ?
Les résultats font bouger les actions plus que tout autre événement du calendrier, et le communiqué de presse est rédigé pour mettre le meilleur chiffre en avant. Cette compétence lit les chiffres que l'entreprise a effectivement déposés auprès de la SEC, les aligne trimestre par trimestre, et dit clairement ce qui a changé. Pour un trader actif, elle répond à deux questions avant une transaction : qu'a dit le dernier rapport, et le prochain est-il dans la durée de cette transaction ?
Outil dans ce dossier (Python de la bibliothèque standard, aucune clé API) :
python3 "${CLAUDE_SKILL_DIR}/facts.py" --help
Il nécessite le User-Agent de la SEC (sec_user_agent dans trader/config.json, ou SEC_USER_AGENT) : "Votre Nom [email protected]" avec le vrai nom et l'email de l'utilisateur. Il refuse d'appeler la SEC sans cela.
Ce qu'il lit et écrit
- Lit
https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json(tous les chiffres que l'entreprise a balisés dans ses dépôts), la liste des soumissions de l'entreprise (pour le 10-Q ou 10-K le plus récent et le 8-K le plus récent avec l'élément 2.02, « Résultats des opérations »), et le dossier de ce 8-K pour trouver le communiqué de presse (la pièce EX-99.1). - Écrit
trader/metrics.jsonavec--metrics: une ligne par entreprise (chiffre d'affaires TTM, résultat net et BPA dilué, les dernières marges et la croissance), pour vos notes ou un tableur.metrics.example.jsondans ce dossier est un véritable run pour AAPL, AXP, GOOGL, KO et BAC le 2026-10-13. - Appels de résultats : l'outil ne récupère pas les transcriptions. Si l'utilisateur en colle une (ou si la page RI de l'entreprise l'a), lisez-la et résumez ce que la direction a dit qui a changé : perspectives, marges, demande, tout ce qu'elle a refusé de répondre.
- La date du prochain rapport ne figure pas dans les données de la SEC. Cherchez-la dans les titres de
/trader-newsou sur la page des relations investisseurs de l'entreprise, et dites d'où elle vient.
Les règles
- Les chiffres déposés en premier. Le tableau provient des faits XBRL que l'entreprise a déposés. Utilisez le communiqué de presse pour le contexte (perspectives, détails par segment), et dites quels chiffres viennent d'où.
- Comparez ce qui est comparable. La croissance se fait par rapport au même trimestre un an plus tôt. Les variations d'un trimestre à l'autre sont indiquées, mais de nombreuses entreprises ont une activité saisonnière (le trimestre de décembre d'Apple est toujours son plus gros).
- Dites ce qui est dérivé. Les entreprises ne déposent pas de 10-Q pour le quatrième trimestre. Le quatrième trimestre est l'année du 10-K moins les trois trimestres qu'il contient, et est marqué « dérivé » ; le BPA dérivé est approximatif.
- Dites quand les données sont en retard. L'API des faits de la SEC peut accuser un retard par rapport à un dépôt. Lorsque le 10-Q le plus récent est plus récent que le trimestre le plus récent dans les faits, l'outil imprime une NOTE avec le lien : lisez le 10-Q lui-même avant de résumer.
- Signalez les éléments ponctuels. Lorsque le résultat net est supérieur au résultat opérationnel, les gains hors activité (réévaluations d'investissements, éléments fiscaux) sont inclus. L'outil le dit. Les banques et les assureurs n'ont pas de marge brute : laissez la cellule vide, pas zéro.
Étapes
-
Exécutez-le pour les entreprises en question (ou les tickers dans
trader/watchlist.json) :python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA NVDA AMD --metrics trader/metrics.json--quarters 8montre deux ans,--jsontout le lisible par machine,--cikune société sans ticker. -
Ouvrez le dernier communiqué de presse sur les résultats (le lien EX-99) et le 10-Q lorsque les chiffres ont besoin de contexte, et lisez-les.
-
Rédigez le résumé : une ligne sur le trimestre (chiffre d'affaires, BPA, croissance), une sur les marges, une sur tout élément inhabituel (un élément ponctuel, un trimestre dérivé, des données en retard), et les liens. Des mots simples, des chiffres réels, pas d'adjectifs que les chiffres ne soutiennent pas.
-
Si le prochain rapport tombe pendant la transaction prévue (une détention de nuit, ou un rapport avant l'ouverture), dites-le avant que
/trader-exitne fixe le stop : un stop ne protège pas contre un gap, l'action peut ouvrir au-delà.
Exemple : le titre phare
facts.py TSLA (exécuté le 2026-10-20) : trimestre terminé le 2026-06-30 (T2 2026), chiffre d'affaires 28,24 milliards $, +25,5% par rapport à l'année précédente, résultat net 1,11 milliard $ (-4,9%), BPA dilué 0,32 $ (-3,0%) ; marge brute 16,8% (-4,3 points par rapport au trimestre précédent), marge opérationnelle 1,4% ; les quatre derniers trimestres 103,6 milliards $ de chiffre d'affaires et 1,08 $ de BPA. L'outil signale que le résultat net est supérieur au résultat opérationnel, ce qui signifie que des gains hors activité sont inclus. Dernier 10-Q déposé le 2026-07-23. Les gros titres de lundi disaient que Tesla publie cette semaine, donc le résumé se termine par : « Le prochain rapport est dans quelques jours. Une transaction journalière qui se clôture avant la cloche n'y est pas exposée ; tout ce qui est détenu pendant la nuit l'est. »
facts.py AAPL (2026-10-13) : chiffre d'affaires 109,42 milliards $, +16,4% par rapport à l'année précédente, BPA dilué 2,02 $ (+28,7%). Pour Coca-Cola, l'outil a noté que les données de la SEC s'arrêtaient au 2026-04-03 alors que le 10-Q pour le 2026-07-03 était déjà déposé, donc le résumé a lu ce 10-Q directement.
Ce qu'il ne fait jamais
- Ne dit jamais qu'une action est bon marché, chère, un achat ou une vente. Il rapporte ce que l'entreprise a déposé.
- N'invente jamais un chiffre que les dépôts n'ont pas, ni n'estime un trimestre qu'il ne peut pas dériver.
- N'appelle jamais la SEC sans le User-Agent, et reste bien en dessous de 10 requêtes par seconde.
Sécurité
Formation et outillage, pas un conseil financier. Cette compétence ne fait que lire les dépôts. Rien ne passe d'ordre sauf /trader-broker, après que /trader-risk a réussi et que l'utilisateur a tapé un « oui » explicite pour cet ordre.