Skip to content

README.fr.md

Latest commit

 

History

History
301 lines (216 loc) · 9.61 KB

README.fr.md

File metadata and controls

301 lines (216 loc) · 9.61 KB
Raw

🌐 Langues: English | Español | Français | Deutsch | Português | 日本語 | 简体中文 | 繁體中文 | 한국어 | العربية | Русский | Italiano | Nederlands | Polski | Türkçe | Tiếng Việt | ไทย | Bahasa Indonesia

🆓 API Free Crypto News

Étoiles GitHub Licence Statut CI

Démo de l'API Free Crypto News

⭐ Si vous trouvez cela utile, mettez une étoile au repo ! Cela aide les autres à découvrir ce projet et motive le développement continu.

Obtenez des actualités crypto en temps réel de 7 sources majeures avec un seul appel API.

curl https://news-crypto.vercel.app/api/news
Free Crypto News CryptoPanic Autres
Prix 🆓 Gratuit pour toujours 29-299$/mois Payant
Clé API ❌ Non requise Requise Requise
Limite de requêtes Illimité* 100-1000/jour Limité
Sources 12 Anglais + 12 International 1 Varie
International 🌏 KO, ZH, JA, ES + traduction Non Non
Auto-hébergement ✅ Un clic Non Non
PWA ✅ Installable Non Non
MCP ✅ Claude + ChatGPT Non Non

🌍 Sources d'Actualités Internationales

Obtenez des actualités crypto de 75 sources internationales en 18 langues — avec traduction automatique en anglais !

Sources Supportées

Région Sources
🇰🇷 Corée Block Media, TokenPost, CoinDesk Korea
🇨🇳 Chine 8BTC (巴比特), Jinse Finance (金色财经), Odaily (星球日报)
🇯🇵 Japon CoinPost, CoinDesk Japan, Cointelegraph Japan
🇪🇸 Amérique Latine Cointelegraph Español, Diario Bitcoin, CriptoNoticias

Exemples Rapides

# Obtenir toutes les actualités internationales
curl "https://news-crypto.vercel.app/api/news/international"

# Obtenir les actualités coréennes avec traduction anglaise
curl "https://news-crypto.vercel.app/api/news/international?language=ko&translate=true"

# Obtenir les actualités de la région asiatique
curl "https://news-crypto.vercel.app/api/news/international?region=asia&limit=20"

Fonctionnalités

  • ✅ Traduction automatique en anglais via Groq AI
  • ✅ Cache de traduction de 7 jours pour l'efficacité
  • ✅ Texte original + anglais préservé
  • ✅ Limitation de débit (1 req/sec) pour respecter les APIs
  • ✅ Gestion de secours pour les sources indisponibles
  • ✅ Déduplication entre les sources

📱 Application Web Progressive (PWA)

Free Crypto News est une PWA entièrement installable qui fonctionne hors ligne !

Fonctionnalités

Fonctionnalité Description
📲 Installable Ajouter à l'écran d'accueil sur n'importe quel appareil
📴 Mode Hors Ligne Lire les actualités en cache sans internet
🔔 Notifications Push Recevoir des alertes d'actualités de dernière minute
⚡ Ultra Rapide Stratégies de mise en cache agressives
🔄 Synchronisation en Arrière-plan Mises à jour automatiques au retour en ligne

Installer l'Application

Bureau (Chrome/Edge):

  1. Visitez news-crypto.vercel.app
  2. Cliquez sur l'icône d'installation (⊕) dans la barre d'adresse
  3. Cliquez sur "Installer"

iOS Safari:

  1. Visitez le site dans Safari
  2. Appuyez sur Partager (📤) → "Sur l'écran d'accueil"

Android Chrome:

  1. Visitez le site
  2. Appuyez sur la bannière d'installation ou Menu → "Installer l'application"

Sources

Nous agrégeons de 7 médias de confiance :

  • 🟠 CoinDesk — Actualités crypto générales
  • 🔵 The Block — Institutionnel & recherche
  • 🟢 Decrypt — Web3 & culture
  • 🟡 CoinTelegraph — Actualités crypto mondiales
  • 🟤 Bitcoin Magazine — Maximaliste Bitcoin
  • 🟣 Blockworks — DeFi & institutions
  • 🔴 The Defiant — Natif DeFi

Endpoints

Endpoint Description
/api/news Dernières de toutes les sources
/api/search?q=bitcoin Rechercher par mots-clés
/api/defi Actualités spécifiques DeFi
/api/bitcoin Actualités spécifiques Bitcoin
/api/breaking Dernières 2 heures seulement
/api/trending Sujets tendance avec sentiment
/api/analyze Actualités avec classification de sujets
/api/stats Analytiques & statistiques
/api/sources Lister toutes les sources
/api/health État de santé de l'API & flux

🤖 Endpoints Alimentés par IA (GRATUIT via Groq)

Endpoint Description
/api/summarize Résumés IA des articles
/api/ask?q=... Poser des questions sur les actualités crypto
/api/digest Résumé quotidien généré par IA
/api/sentiment Analyse de sentiment approfondie par article
/api/entities Extraire personnes, entreprises, tickers
/api/narratives Identifier les narratifs et thèmes du marché
/api/signals Signaux de trading basés sur les actualités (éducatif)

SDKs & Composants

Package Description
React Composants <CryptoNews /> prêts à l'emploi
TypeScript SDK TypeScript complet
Python Client Python sans dépendances
JavaScript SDK navigateur & Node.js
Go Bibliothèque cliente Go
PHP SDK PHP

URL de Base: https://news-crypto.vercel.app

Format de Réponse

{
  "articles": [
    {
      "title": "Bitcoin Atteint un Nouveau ATH",
      "link": "https://coindesk.com/...",
      "description": "Bitcoin a dépassé...",
      "pubDate": "2025-01-02T12:00:00Z",
      "source": "CoinDesk",
      "timeAgo": "il y a 2h"
    }
  ],
  "totalCount": 150,
  "fetchedAt": "2025-01-02T14:30:00Z"
}

Exemples d'Intégration

Choisissez votre plateforme. Copiez le code. Déployez.

🐍 Python

Zéro dépendance. Copiez simplement le fichier.

curl -O https://raw.githubusercontent.com/nirholas/free-crypto-news/main/sdk/python/crypto_news.py
from crypto_news import CryptoNews

news = CryptoNews()

# Obtenir les dernières actualités
for article in news.get_latest(5):
    print(f"📰 {article['title']}")
    print(f"   {article['source']} • {article['timeAgo']}")
    print(f"   {article['link']}\n")

🟨 JavaScript / TypeScript

Fonctionne dans Node.js et les navigateurs.

SDK TypeScript (npm)

npm install @nirholas/crypto-news
import { CryptoNews } from '@nirholas/crypto-news';

const client = new CryptoNews();

// Réponses entièrement typées
const articles = await client.getLatest(10);
const health = await client.getHealth();

Auto-Hébergement

Déploiement en Un Clic

Déployer avec Vercel

Manuel

git clone https://github.com/nirholas/free-crypto-news.git
cd free-crypto-news
pnpm install
pnpm dev

Ouvrez http://localhost:3000/api/news

Variables d'Environnement

Toutes les variables d'environnement sont optionnelles. Le projet fonctionne sans configuration.

Variable Par Défaut Description
GROQ_API_KEY - Active la traduction automatique i18n (18 langues). GRATUIT ! Obtenez la vôtre sur console.groq.com/keys
FEATURE_TRANSLATION false Définir sur true pour activer la traduction en temps réel

Stack Technique

  • Runtime: Next.js 14 Edge Functions
  • Hébergement: Niveau gratuit Vercel
  • Données: Parsing RSS direct (pas de base de données)
  • Cache: Cache edge de 5 minutes

Contribuer

Les PRs sont les bienvenues ! Idées :

  • Plus de sources d'actualités
  • Analyse de sentiment ✅ Fait
  • Classification de sujets ✅ Fait
  • Flux WebSocket en temps réel ✅ Fait
  • SDKs Rust / Ruby
  • Application mobile (React Native)

📚 Documentation

Document Description
Guide Utilisateur Fonctionnalités utilisateur, raccourcis clavier, PWA
Guide Développeur Architecture, composants, extension de l'app
Contribuer Comment contribuer
Changelog Historique des versions
Sécurité Politique de sécurité

Licence

All rights reserved. See LICENSE.