@cryptodevops/n8n-nodes-opensea

Ce package contient un nœud n8n personnalisé pour accéder aux données NFT via l'API OpenSea.

📦 Nœud inclus

OpenSea Node

• NFT : Métadonnées et informations des NFTs
• Collection : Données des collections NFT
• Account : NFTs possédés par un compte
• Events : Événements du marketplace

🚀 Fonctionnalités OpenSea

🖼️ NFT

• Get NFT : Métadonnées d'un NFT spécifique
• List NFTs by Collection : NFTs d'une collection
• List NFTs by Contract : NFTs d'un contrat
• Refresh NFT Metadata : Actualisation des métadonnées

📚 Collection

• Get Collection : Détails d'une collection
• List Collections : Collections disponibles

👤 Account

• List NFTs by Account : NFTs possédés par un compte

📈 Events

• List Events : Événements du marketplace

🔍 Filtres avancés

• Chain Filter : Support multi-chaînes
• Pagination : Limit et cursor
• Sorting : Tri par différents critères
• Event Types : Filtrage par type d'événement

🤖 Support IA

• Résumés automatiques : Génération de résumés intelligents
• Formatage des données : Données structurées pour l'IA
• Métriques calculées : Statistiques automatiques

Chaînes supportées

• Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base, Klaytn, Solana

🤖 Mode Agent IA

Le nœud OpenSea supporte le mode AI Agent avec des descriptions détaillées pour chaque opération, permettant une intégration facile avec des systèmes d'IA.

🔧 Filtres et options

• Filtrage par chaîne : Support multi-chaînes
• Pagination : Contrôle avec limit et cursor
• Tri : Par différents critères
• Filtrage par événements : Types d'événements spécifiques
• Limitation des résultats : Contrôlez le nombre de résultats retournés

📦 Installation

npm install @cryptodevops/n8n-nodes-opensea

🧪 Testing

Vous pouvez tester l'API OpenSea localement :

# Test du nœud OpenSea
node test-opensea.js

🔑 Configuration

Credentials (Optionnel)

L'API OpenSea v2 nécessite une clé API pour la plupart des endpoints :

1. Allez dans n8n → Credentials
2. Créez une nouvelle credential "OpenSea API"
3. Entrez votre clé API OpenSea

🎯 Exemples d'utilisation

Obtenir un NFT spécifique

{
  "resource": "nft",
  "operation": "getNft",
  "chain": "ethereum",
  "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "tokenId": "1"
}

Lister les NFTs d'une collection

{
  "resource": "nft",
  "operation": "listNftsByCollection",
  "collectionSlug": "boredapeyachtclub",
  "additionalFields": {
    "limit": 20
  }
}

Obtenir les détails d'une collection

{
  "resource": "collection",
  "operation": "getCollection",
  "collectionSlug": "cryptopunks"
}

📊 Format des données

NFT

{
  "identifier": "1",
  "collection": "boredapeyachtclub",
  "contract": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "token_standard": "erc721",
  "name": "Bored Ape #1",
  "description": "The Bored Ape Yacht Club...",
  "image_url": "https://...",
  "metadata_url": "https://...",
  "opensea_url": "https://opensea.io/assets/...",
  "_metadata": {
    "resource": "nft",
    "operation": "getNft",
    "fetched_at": "2024-01-15T10:30:00.000Z"
  }
}

🔗 Endpoints API utilisés

• NFT : https://api.opensea.io/api/v2/chain/{chain}/contract/{address}/nfts/{token_id}
• Collections : https://api.opensea.io/api/v2/collections
• Events : https://api.opensea.io/api/v2/events/chain/{chain}

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

1. Fork le projet
2. Créer une branche pour votre fonctionnalité
3. Commiter vos changements
4. Pousser vers la branche
5. Ouvrir une Pull Request

📄 Licence

MIT

🔗 Liens utiles

• Documentation OpenSea API
• Site web OpenSea
• Documentation n8n

🆘 Support

Pour toute question ou problème :

1. Vérifiez la documentation OpenSea API
2. Consultez les issues GitHub
3. Contactez-nous à [email protected]

Note : Ce nœud n8n est un projet communautaire et n'est pas officiellement affilié à OpenSea ou n8n.io.