aggregating-crypto-news

Aggregating Crypto News

Overview

This skill aggregates cryptocurrency news from 50+ authoritative sources using RSS feeds. It provides real-time news scanning with filtering by coin, category, time window, and relevance scoring.

Key Capabilities:

• Multi-source aggregation from top crypto news sites
• Coin-specific filtering (BTC, ETH, SOL, etc.)
• Category filtering (DeFi, NFT, regulatory, exchange, etc.)
• Relevance scoring with market-moving keyword detection
• Multiple output formats (table, JSON, CSV)

Prerequisites

Before using this skill, ensure:

1. Python 3.8+ is installed
2. feedparser library is available: pip install feedparser
3. requests library is available: pip install requests
4. Internet connectivity for RSS feed access

Instructions

Step 1: Assess User Intent

Determine what the user is looking for:

• General news: No specific filters, use defaults
• Coin-specific: Extract coin symbol (BTC, ETH, etc.)
• Category-specific: Extract category (defi, nft, regulatory, etc.)
• Time-specific: Extract time window (1h, 4h, 24h, 7d)

Step 2: Execute News Aggregation

Run the news aggregator with appropriate filters:

# Default scan (top 20, past 24h, relevance sorted)
python {baseDir}/scripts/news_aggregator.py

# Coin-specific scan
python {baseDir}/scripts/news_aggregator.py --coin BTC --period 4h

# Category filter
python {baseDir}/scripts/news_aggregator.py --category defi --top 30

# Export to JSON
python {baseDir}/scripts/news_aggregator.py --format json --output news.json

# Multiple filters
python {baseDir}/scripts/news_aggregator.py --coin ETH --category defi --period 24h --top 15

Step 3: Present Results

Format and present the news to the user:

• Show source, title, age, and relevance score
• Highlight market-moving keywords if present
• Provide links for full articles
• Summarize meta information (sources checked, articles found)

Command-Line Options

Option	Description	Default
--coin	Filter by coin symbol (BTC, ETH, etc.)	None
--coins	Filter by multiple coins (comma-separated)	None
--category	Filter by category	None
--period	Time window (1h, 4h, 24h, 7d)	24h
--top	Number of results to return	20
--min-score	Minimum relevance score	0
--format	Output format (table, json, csv)	table
--output	Output file path	stdout
--sort-by	Sort by (relevance, recency)	relevance
--verbose	Enable verbose output	false

Categories Available

• market: General market news, price movements
• defi: DeFi protocols, yield farming, DEXes
• nft: NFT projects, marketplaces, collections
• regulatory: Government, SEC, legal developments
• layer1: L1 blockchain news (Ethereum, Solana, etc.)
• layer2: L2 scaling solutions (Arbitrum, Optimism, etc.)
• exchange: Exchange news, listings, delistings
• security: Hacks, exploits, vulnerabilities

Output

Table Format (Default)

==============================================================================
  CRYPTO NEWS AGGREGATOR                            Updated: 2026-01-14 15:30
==============================================================================

  TOP CRYPTO NEWS (24h)
------------------------------------------------------------------------------
  Rank  Source          Title                           Age     Score
------------------------------------------------------------------------------
    1   CoinDesk        Bitcoin Breaks $100K ATH        2h      95.0
    2   The Block       SEC Approves ETH ETF            4h      92.5
    3   Decrypt         Solana DeFi TVL Surges          6h      78.3
------------------------------------------------------------------------------

  Summary: 20 articles shown | Scanned: 50 sources | Matched: 187
==============================================================================

JSON Format

{
  "articles": [
    {
      "rank": 1,
      "title": "Bitcoin Breaks $100K ATH",
      "url": "https://coindesk.com/...",
      "source": "CoinDesk",
      "published": "2026-01-14T13:30:00Z",
      "age": "2h ago",
      "category": "market",
      "relevance_score": 95.0,
      "coins_mentioned": ["BTC"]
    }
  ],
  "meta": {
    "period": "24h",
    "sources_checked": 50,
    "total_articles": 187,
    "shown": 20
  }
}

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Error	Cause	Solution
Network timeout	RSS feed unreachable	Uses cached data; skips unavailable sources
Parse error	Malformed RSS	Skips entry; continues with valid articles
No results	Filters too strict	Suggest relaxing filters
Invalid coin	Unknown symbol	List similar valid symbols

Examples

See {baseDir}/references/examples.md for detailed examples.

Quick Examples

# Get latest crypto news (default)
python {baseDir}/scripts/news_aggregator.py

# Bitcoin news from past 4 hours
python {baseDir}/scripts/news_aggregator.py --coin BTC --period 4h

# DeFi category news
python {baseDir}/scripts/news_aggregator.py --category defi

# Export to JSON file
python {baseDir}/scripts/news_aggregator.py --format json --output crypto_news.json

# High-relevance news only
python {baseDir}/scripts/news_aggregator.py --min-score 70 --top 10

# Multiple coins
python {baseDir}/scripts/news_aggregator.py --coins BTC,ETH,SOL

Resources

• CoinDesk: https://www.coindesk.com/arc/outboundfeeds/rss/
• CoinTelegraph: https://cointelegraph.com/rss
• The Block: https://www.theblock.co/rss.xml
• Decrypt: https://decrypt.co/feed
• feedparser docs: https://feedparser.readthedocs.io/
• See {baseDir}/config/sources.yaml for full source registry