Creative Static Analyzer

Analyse une publicité static (ou un carrousel) via Gemini Vision et renvoie une décomposition zone par zone, prête à transposer sur une autre marque.

C'est le pendant de creative-video-analyzer pour les images fixes. Même principe : Apify télécharge le média, Gemini l'analyse, Claude reçoit du texte.

---

Pourquoi cet actor existe

Claude ne peut pas voir une image hébergée sur un domaine externe — ni via web_fetch, ni depuis son conteneur. Les URLs TrendTrack (medias.trendtrack.io) sont inaccessibles des deux côtés.

Cet actor contourne le problème : les serveurs Apify n'ont aucune de ces restrictions. Ils téléchargent l'image, l'envoient à Gemini, et renvoient une analyse textuelle que Claude peut exploiter.

---

Déploiement

1. Créer l'actor Sur console.apify.com → Actors → Development → Create new → Node.js empty project.

2. Remplacer les fichiers Copier le contenu de ce dossier dans l'éditeur web (ou pousser via apify push si tu utilises la CLI) :

.actor/actor.json
.actor/input_schema.json
.actor/dataset_schema.json
src/main.js
package.json
Dockerfile

3. Build Bouton Build dans la console. Compter 1-2 minutes.

4. Tester Onglet Input, coller :

{
  "imageUrl": "https://medias.trendtrack.io/facebook/image/962a0e2e5e6074f859f50a691d46a7b9b85f74b115b528d71066cde97f0ed9eb.jpg",
  "geminiApiKey": "<ta clé Google AI Studio>"
}

Puis Start. L'analyse arrive dans le dataset, champ analysis.

5. Publier (optionnel) Settings → Publication, pour pouvoir l'appeler depuis le MCP Apify comme <ton-username>/creative-static-analyzer.

---

Appel depuis Claude

call-actor("<username>/creative-static-analyzer", {
  imageUrl: "<URL de la static>",
  geminiApiKey: "<clé du Coffre-fort Notion>"
})

Pour un carrousel :

call-actor("<username>/creative-static-analyzer", {
  imageUrls: ["<slide 1>", "<slide 2>", "<slide 3>"],
  geminiApiKey: "<clé>"
})

---

Ce que renvoie l'analyse

Neuf sections, calquées sur l'Étape 2 de la skill Génération de Statics :

1. Structure d'ensemble — type de composition
2. Zones dans l'ordre de lecture — position, fonction, contenu, poids visuel
3. Texte verbatim — tout le texte visible, recopié mot pour mot
4. Traitement du produit — détouré, en situation, tenu en main…
5. Codes visuels — couleurs, contraste, typographie, éléments graphiques
6. Ce qui porte la performance — ce qui accroche et pourquoi
7. Mécanique probable — le format nommé en une ligne
8. Ce qui est transposable — et ce qui ne l'est pas
9. Points de vigilance — les actifs requis pour la reproduire honnêtement

Sur un carrousel, chaque slide est analysée séparément, plus une section Flux narratif sur la progression.

---

Coût

Une static en gemini-3.8-flash ≈ 0,002 $. Négligeable même sur un gros batch.

Passer sur gemini-3.1-pro-preview uniquement si le texte de l'image est dense ou mal rendu — c'est environ 10× plus cher pour un gain qui ne se justifie pas sur une static ordinaire.

---

Limites

• 10 slides maximum par carrousel
• 18 Mo par image (limite de l'envoi inline à Gemini)
• L'URL doit être publiquement accessible — pas de lien signé expiré, pas de contenu derrière authentification

---

Messages d'erreur

Erreur	Cause
Cle API Gemini invalide	Vérifier la valeur dans le Coffre-fort Notion, entrée « Google AI Studio (Gemini) »
Quota Gemini depasse	Attendre quelques minutes, ou vérifier le plan Google AI Studio
Telechargement impossible (403)	L'URL a expiré ou nécessite une authentification
L'URL ne renvoie pas une image	Le lien pointe vers une page HTML, pas vers le fichier image