À propos du projet

Claude Ads est une compétence Claude Code qui apporte des opérations média payantes structurées et fondées sur des preuves aux agences, consultants et équipes de performance internes. Elle couvre douze plateformes publicitaires — Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads, X Ads, Apple Ads, Amazon Ads et Pinterest Ads — chacune avec une compétence dédiée, un worker d'audit, une référence de contrôle, une déclaration de capacités et une surface de routage testable. L'outil est en lecture seule par défaut. Les modifications de compte en direct restent désactivées jusqu'à ce que la plateforme et l'opération exactes passent les garde-fous d'approbation, d'idempotence, de vérification, d'audit et de rollback. Cette conception axée sur la sécurité permet d'utiliser l'outil pour analyser et planifier sans risque de mutations involontaires. Les capacités principales incluent : auditer des comptes média payants avec preuves datées et niveaux de confiance explicites ; planifier campagnes, canaux, budgets, mesure et expériences ; créer briefs et actifs de copie, image, vidéo et photos produit ; surveiller rythme, livraison, suivi, fatigue, politique et performance ; et produire des rapports JSON versionnés rendus en Markdown, HTML et PDF optionnel. L'architecture utilise un seul conducteur qui possède portée, politique, agrégation et artefacts finaux, dispatchant des workers de plateforme et transversaux qui analysent des tranches bornées et retournent des résultats conformes au schéma. L'échec d'un worker requis rend l'exécution partielle plutôt que de présenter silencieusement un audit incomplet comme complet. La notation sépare santé, couverture des preuves, exposition réglementaire et opportunités. Les contrôles utilisent états pass, fail, unknown ou not_applicable. Une couverture de 80 % ou plus est notée, 60 à 79 % est provisoire, et en dessous de 60 % est preuve insuffisante. Les fonctionnalités optionnelles, bêta, premium, indisponibles et inéligibles restent non notées. Un profil de plateforme désactivé ou non approuvé ne produit aucun score de santé. La sécurité du compte exige six conditions avant toute écriture : une capacité testée et activée pour l'opération exacte, des identifiants explicites de compte et d'objet, un diff avant-après lisible par humain avec rayon d'impact, approbation du propriétaire dans les plafonds définis par le compte, une clé d'idempotence avec destination d'audit et rollback, et vérification que l'état distant correspond toujours à la précondition de mutation. Plafonds manquants signifient aucune écriture. La suppression permanente n'est pas prise en charge en v2. Le répertoire du plan de contrôle enregistre limites produit, sources datées, revendications, capacités, règles de sécurité, règles de confidentialité, décisions écosystémiques et exigences de publication. Aucune source signifie aucune revendication de plateforme actuelle. Aucune implémentation, fixture et test signifie aucune revendication de capacité. Aucune approbation et rollback signifie aucune mutation de compte. Aucune vérification indépendante signifie aucune publication. L'installation prend en charge Claude Code comme runtime canonique, avec Codex, Gemini, Cursor, Windsurf, Goose et hôtes compatibles Agent Skills pouvant consommer les mêmes fichiers de compétence. Les dépendances gérées prennent en charge CPython 3.11 et 3.12 sur Linux, macOS et Windows. La capture navigateur nécessite un payload Playwright installé par l'opérateur, et le rendu PDF nécessite WeasyPrint et bibliothèques système Pango. Le projet est publié sous licence MIT, avec une version publique à Agricidaniel/claude-ads et un miroir communautaire à AI-Marketing-Hub/claude-ads pour accès anticipé et collaboration directe.