README.pt.md

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

---

🆓 API Free Crypto News

⭐ Se você achar isso útil, dê uma estrela no repo! Ajuda outros a descobrir este projeto e motiva o desenvolvimento contínuo.

---

Obtenha notícias cripto em tempo real de 7 fontes principais com uma única chamada de API.

curl https://cryptocurrency.cv/api/news

---

	Free Crypto News	CryptoPanic	Outros
Preço	🆓 Grátis para sempre	$29-299/mês	Pago
Chave API	❌ Não necessária	Necessária	Necessária
Limite de taxa	Ilimitado*	100-1000/dia	Limitado
Fontes	12 Inglês + 12 Internacional	1	Varia
Internacional	🌏 KO, ZH, JA, ES + tradução	Não	Não
Auto-hospedagem	✅ Um clique	Não	Não
PWA	✅ Instalável	Não	Não
MCP	✅ Claude + ChatGPT	Não	Não

---

🌍 Fontes de Notícias Internacionais

Obtenha notícias cripto de 75 fontes internacionais em 18 idiomas — com tradução automática para inglês!

Fontes Suportadas

Região	Fontes
🇰🇷 Coreia	Block Media, TokenPost, CoinDesk Korea
🇨🇳 China	8BTC (巴比特), Jinse Finance (金色财经), Odaily (星球日报)
🇯🇵 Japão	CoinPost, CoinDesk Japan, Cointelegraph Japan
🇪🇸 América Latina	Cointelegraph Español, Diario Bitcoin, CriptoNoticias

Exemplos Rápidos

# Obter todas as notícias internacionais
curl "https://cryptocurrency.cv/api/news/international"

# Obter notícias coreanas com tradução para inglês
curl "https://cryptocurrency.cv/api/news/international?language=ko&translate=true"

# Obter notícias da região asiática
curl "https://cryptocurrency.cv/api/news/international?region=asia&limit=20"

Recursos

• ✅ Auto-tradução para inglês via Groq AI
• ✅ Cache de tradução de 7 dias para eficiência
• ✅ Texto original + inglês preservado
• ✅ Limite de taxa (1 req/seg) para respeitar as APIs
• ✅ Tratamento de fallback para fontes indisponíveis
• ✅ Deduplicação entre fontes

---

📱 Aplicativo Web Progressivo (PWA)

Free Crypto News é um PWA totalmente instalável que funciona offline!

Recursos

Recurso	Descrição
📲 Instalável	Adicionar à tela inicial em qualquer dispositivo
📴 Modo Offline	Ler notícias em cache sem internet
🔔 Notificações Push	Receber alertas de notícias de última hora
⚡ Ultra Rápido	Estratégias de cache agressivas
🔄 Sincronização em Segundo Plano	Atualizações automáticas ao voltar online

Instalar o App

Desktop (Chrome/Edge):

1. Visite cryptocurrency.cv
2. Clique no ícone de instalação (⊕) na barra de endereços
3. Clique em "Instalar"

iOS Safari:

1. Visite o site no Safari
2. Toque em Compartilhar (📤) → "Adicionar à Tela de Início"

Android Chrome:

1. Visite o site
2. Toque no banner de instalação ou Menu → "Instalar app"

---

Fontes

Agregamos de 7 meios de comunicação confiáveis:

• 🟠 CoinDesk — Notícias cripto gerais
• 🔵 The Block — Institucional e pesquisa
• 🟢 Decrypt — Web3 e cultura
• 🟡 CoinTelegraph — Notícias cripto globais
• 🟤 Bitcoin Magazine — Maximalista Bitcoin
• 🟣 Blockworks — DeFi e instituições
• 🔴 The Defiant — Nativo DeFi

---

Endpoints

Endpoint	Descrição
/api/news	Últimas de todas as fontes
/api/search?q=bitcoin	Pesquisar por palavras-chave
/api/defi	Notícias específicas de DeFi
/api/bitcoin	Notícias específicas de Bitcoin
/api/breaking	Apenas as últimas 2 horas
/api/trending	Tópicos em tendência com sentimento
/api/analyze	Notícias com classificação de tópicos
/api/stats	Análises e estatísticas
/api/sources	Listar todas as fontes
/api/health	Status de saúde da API e feeds

🤖 Endpoints Potencializados por IA (GRÁTIS via Groq)

Endpoint	Descrição
/api/summarize	Resumos de IA de artigos
/api/ask?q=...	Fazer perguntas sobre notícias cripto
/api/digest	Resumo diário gerado por IA
/api/sentiment	Análise profunda de sentimento por artigo
/api/entities	Extrair pessoas, empresas, tickers
/api/narratives	Identificar narrativas e temas do mercado
/api/signals	Sinais de trading baseados em notícias (educacional)

---

SDKs e Componentes

Pacote	Descrição
React	Componentes <CryptoNews /> prontos para uso
TypeScript	SDK TypeScript completo
Python	Cliente Python sem dependências
JavaScript	SDK navegador e Node.js
Go	Biblioteca cliente Go
PHP	SDK PHP

URL Base: https://cryptocurrency.cv

---

Formato de Resposta

{
  "articles": [
    {
      "title": "Bitcoin Atinge Novo ATH",
      "link": "https://coindesk.com/...",
      "description": "Bitcoin superou...",
      "pubDate": "2025-01-02T12:00:00Z",
      "source": "CoinDesk",
      "timeAgo": "há 2h"
    }
  ],
  "totalCount": 150,
  "fetchedAt": "2025-01-02T14:30:00Z"
}

---

Exemplos de Integração

Escolha sua plataforma. Copie o código. Faça o deploy.

---

🐍 Python

Zero dependências. Apenas copie o arquivo.

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

from crypto_news import CryptoNews

news = CryptoNews()

# Obter últimas notícias
for article in news.get_latest(5):
    print(f"📰 {article['title']}")
    print(f"   {article['source']} • {article['timeAgo']}")
    print(f"   {article['link']}\n")

---

🟨 JavaScript / TypeScript

Funciona em Node.js e navegadores.

SDK TypeScript (npm)

npm install @nirholas/crypto-news

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

const client = new CryptoNews();

// Respostas totalmente tipadas
const articles = await client.getLatest(10);
const health = await client.getHealth();

---

Auto-Hospedagem

Deploy em Um Clique

Manual

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

Abra http://localhost:3000/api/news

Variáveis de Ambiente

Todas as variáveis de ambiente são opcionais. O projeto funciona sem configuração.

Variável	Padrão	Descrição
GROQ_API_KEY	-	Habilita resumo IA, classificação e tradução em tempo real (40+ idiomas). GRÁTIS! Obtenha a sua em console.groq.com/keys

---

Stack Tecnológico

• Runtime: Next.js 14 Edge Functions
• Hospedagem: Tier gratuito Vercel
• Dados: Parsing RSS direto (sem banco de dados)
• Cache: Cache edge de 5 minutos

---

Contribuir

PRs são bem-vindos! Ideias:

• Mais fontes de notícias
• Análise de sentimento ✅ Feito
• Classificação de tópicos ✅ Feito
• Feed WebSocket em tempo real ✅ Feito
• SDKs Rust / Ruby
• App móvel (React Native)

---

📚 Documentação

Documento	Descrição
Guia do Usuário	Recursos para usuários finais, atalhos de teclado, PWA
Guia do Desenvolvedor	Arquitetura, componentes, estender o app
Contribuir	Como contribuir
Changelog	Histórico de versões
Segurança	Política de segurança

---

Licença

MIT © 2025 nich

---

Pare de pagar por APIs de notícias cripto.
_{Feito com 💜 para a comunidade}

⭐ Achou útil? Dê uma estrela! ⭐
_{Ajuda outros a descobrir este projeto e mantém o desenvolvimento ativo}