Trouver un logo de marque
Utilisez les œuvres existantes et conservez leur source. Cette compétence inclut une CLI Python 3.10+ autonome ; résolvez scripts/logos.py par rapport à ce répertoire de compétence. Elle fonctionne à la fois dans le dépôt et lorsque seul le dossier de cette compétence est installé. Aucune clé API ni paquet Python n'est requis.
Trouver un actif approprié
Exécutez python3 <skill-directory>/scripts/logos.py search "nom de la marque" --limit 1. Si notre catalogue contient cette marque, ajoutez --source ours ; si la variante exacte est déjà connue, récupérez-la directement.
La recherche par défaut couvre onze collections. Utilisez de petites limites et du texte simple pour une liste restreinte ; augmentez la limite pour inspecter plus de variantes. Ajoutez --json pour les statuts des sources et les métadonnées complètes. --refresh contourne le cache de 24 heures. Vérifiez les avertissements ou les erreurs JSON avant de conclure qu'une marque est absente ; une source indisponible n'a pas été vérifiée. Essayez les noms de produits, les sociétés mères et les alias si nécessaire. La référence des sources liste toutes les collections et leurs noms pour --source.
Privilégiez les œuvres officielles du kit de marque pour le produit demandé et le contexte visuel. Notre catalogue fournit une provenance datée et des indices de contexte ; les collections en amont peuvent avoir une meilleure couverture. Une favicon de site web est étiquetée site-icon, et ne constitue pas une preuve qu'un logo complet ou une version vectorielle existe. Inspectez l'œuvre réelle avant de l'utiliser. Choisissez les variantes fournies (clair/foncé/couleur/wordmark) ; ne redessinez pas ni ne recolorisez une marque déposée pour approximer une variante manquante.
Confirmez l'entreprise/produit réel derrière une correspondance : les noms peuvent entrer en collision. Par exemple, l'icône flux de Simple Icons correspond au projet CNCF Flux, pas aux modèles d'image FLUX de Black Forest Labs. Vérifiez ses métadonnées source avant de la choisir.
Si la fraîcheur est importante, vérifiez la page officielle actuelle de la marque et comparez-la avec la date enregistrée du résultat. Un téléchargement récent n'établit pas qu'un fournisseur n'a pas changé d'identité. Les résultats provenant de dépôts GitHub utilisent une URL d'actif figée par commit.
Récupérer et reporter
Pour notre catalogue, récupérez une variante exacte avec :
python3 <skill-directory>/scripts/logos.py fetch openrouter --variant glyph-ink --output <project>/public/logos/openrouter.svg
La CLI vérifie le SHA-256 enregistré et le format d'image, rejette le contenu SVG actif non pris en charge, et refuse d'écraser des fichiers sans --force. Dans un checkout complet, --offline recherche et récupère des fichiers locaux sans accès réseau. Une compétence installée séparément récupère notre catalogue courant et ses actifs depuis lxf82dev/open-brand-assets sur GitHub.
Pour un résultat en amont, récupérez son URL retournée avec l'outil de téléchargement disponible, conservez les mentions d'attribution/licence requises en amont, inspectez les octets, et enregistrez l'URL source, la variante, la date de récupération et l'empreinte du fichier à côté de la sortie. Lisez les détails de la source lors de la sélection d'une bibliothèque ou du traitement d'un adaptateur défaillant.
selfh.st nécessite une attribution de collection. La licence du site Web de Vector Logo Zone ne réattribue pas les logos des fournisseurs. Conservez ces notes d'attribution/droits retournées avec l'actif. Les symboles crypto peuvent être ambigus ; vérifiez ensemble le nom et le symbole de la devise.
Reportez la source choisie et toute condition d'utilisation pertinente avec le fichier livré. guidelines-available signifie que des directives existent, pas une approbation générale. permission-required et unverified sont des conditions non résolues ; ne décrivez pas ces actifs comme étant autorisés. Les licences de dépôt n'accordent pas de droits sur les marques déposées des fournisseurs. Vérifiez les conditions réelles pour le contexte visé, et distinguez la référence éditoriale du marketing ou du parrainage.
Combler un manque
Lorsque les collections ne contiennent pas une marque ou une variante officielle actuelle, inspectez d'abord la page officielle de marque/média du fournisseur, puis ses propres icônes de site web. Enregistrez la source exacte, la date et les modifications ; étiquetez une icône de site honnêtement. Si aucun actif approprié n'existe, signalez le manque au lieu de générer un remplacement.
Si l'utilisateur a demandé une contribution, suivez CONTRIBUTING.md dans un checkout de Open Brand Assets. Utilisez un dossier par marque, conservez les mentions en amont lorsque cela s'applique, reconstruisez le catalogue, et exécutez les vérifications. Trouver un logo seul n'autorise pas une écriture GitHub ou des modifications dans un dépôt non lié.