🚀 Solana Narrative Detection Tool

Detects emerging narratives in the Solana ecosystem and generates concrete build ideas.

Built for the Superteam bounty - an AI-powered tool that monitors multiple data sources across the Solana ecosystem to identify emerging trends and accelerating narratives, then generates actionable product ideas for builders.

🎯 What It Does

• Monitors DeFi protocols, GitHub repos, social signals, and on-chain data
• Identifies emerging and accelerating narratives using AI analysis
• Generates 3-5 concrete build ideas for each detected narrative
• Outputs clean reports with confidence scores and signal explanations

📊 Data Sources

Source	What We Track	Signal Types
DeFiLlama	Protocol TVL, category growth	TVL changes, unusual activity
GitHub	Solana repo activity, stars, commits	Viral repos, dev activity
Social Media	RSS feeds, trending topics	News articles, trending topics
Dune Analytics	On-chain transactions, volumes	Transaction volume, token creation

🏗️ Signal Detection & Ranking

Signal Scoring

• High Strength: Significant changes (>50% TVL change, >20 recent commits, viral repos)
• Medium Strength: Moderate activity (10-50% changes, 5-20 commits)
• Low Strength: Minor activity (baseline activity levels)

Narrative Detection

1. Data Collection: Gather signals from all sources over specified time period
2. AI Clustering: Use LLMs to group related signals into coherent narratives
3. Confidence Scoring: Rate narratives based on signal strength, novelty, and coherence
4. Trend Analysis: Identify if narratives are accelerating, stable, or declining

Build Idea Generation

For each narrative, AI generates ideas considering:

• Technical feasibility on Solana
• Market demand indicators from signals
• Unique value propositions
• Implementation complexity

🚀 Quick Start

Prerequisites

• Python 3.8+
• pip package manager

Installation

# Clone the repository
git clone https://github.com/mint-claw/solana-narrative-detector.git
cd solana-narrative-detector

# Install dependencies
pip install -r requirements.txt

# Copy environment template (optional - tool works without API keys)
cp .env.example .env
# Edit .env with your API keys if available

Usage

# Run with default settings (7 days of data)
python main.py

# Specify output file and analysis period
python main.py --output my_report.json --days 14

# Verbose mode for debugging
python main.py --verbose

# Generate markdown report
python main.py --output report.json
python -c "
import json
from src.report_generator import ReportGenerator
rg = ReportGenerator()
with open('report.json') as f:
    data = json.load(f)
with open('NARRATIVE_REPORT.md', 'w') as f:
    f.write(rg.generate_markdown_report(data))
"

📋 Example Output

The tool outputs structured JSON with detected narratives and build ideas:

{
  "meta": {
    "generated_at": "2026-02-14T21:30:00Z",
    "narratives_identified": 5,
    "total_signals_collected": 147
  },
  "detected_narratives": [
    {
      "title": "Solana Mobile Gaming Surge",
      "description": "Multiple gaming protocols showing significant TVL growth...",
      "confidence": 87,
      "signal_strength": "high",
      "category": "Gaming",
      "build_ideas": [
        {
          "name": "Solana Game Discovery Platform",
          "description": "Steam-like launcher for Solana blockchain games",
          "difficulty": "Medium",
          "market_potential": "High"
        }
      ]
    }
  ]
}

🔧 Configuration

API Keys (Optional)

The tool works without API keys using fallback data, but providing keys improves data quality:

• OPENAI_API_KEY or ANTHROPIC_API_KEY - For AI narrative analysis
• GITHUB_TOKEN - For enhanced GitHub API limits
• DUNE_API_KEY - For real-time on-chain data

Customization

• Modify src/data_collectors.py to add new data sources
• Adjust signal scoring in collector classes
• Customize AI prompts in src/analyzer.py

📈 Signal Quality & Methodology

Data Quality Measures

• Rate limiting to respect API limits
• Error handling with graceful fallbacks
• Signal validation to filter noise
• Temporal analysis to detect acceleration

Novelty Detection

• Tracks signal patterns over time
• Identifies unusual activity spikes
• Flags new categories and topics
• Measures velocity of change

Explainability

• Every narrative linked to specific signals
• Confidence scores based on data quality
• Clear evidence trails for each finding
• Methodology documentation

🏆 Built for Superteam Bounty

This tool was designed specifically for the Superteam narrative detection bounty with focus on:

✅ Multi-source signal monitoring (DeFi, dev, social, on-chain)
✅ Emerging narrative identification with AI analysis
✅ Concrete build ideas (3-5 per narrative)
✅ Quality over quantity approach
✅ Clear explanations and confidence scoring
✅ Easy deployment and clear documentation

📄 License

MIT License - feel free to use, modify, and build upon this tool.

🤝 Contributing

This is a bounty submission, but contributions are welcome:

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Submit a pull request

📞 Contact

Built by Mint Claw for the Superteam ecosystem. Questions? Open an issue!

---

"The best way to predict the future is to build it." - This tool helps you see what's coming so you can build what's needed.