Skip to content

160-tool MCP server for real-time global intelligence from free public APIs: markets, liquidity, prediction markets, SEC filings, conflict, military, aircraft-cohort early warning, migration and border flows, cyber, climate, news and more. Dated observation history, 29 research prompts, cited briefs, geofences, SSE dashboard. MIT, no paid API keys.

2.5 KB
Raw Blame
"""GitHub trending repositories source for world-intel-mcp.

Uses the GitHub search API (no auth required, 10 req/min rate limit).
Approximates "trending" by searching recently created repos with high stars.
"""

import logging
from datetime import datetime, timezone, timedelta

from ..fetcher import Fetcher

logger = logging.getLogger("world-intel-mcp.sources.github_trending")

_GH_SEARCH_URL = "https://api.github.com/search/repositories"


def _utc_now_iso() -> str:
    return datetime.now(timezone.utc).isoformat()


async def fetch_trending_repos(
    fetcher: Fetcher,
    language: str | None = None,
    since_days: int = 7,
    limit: int = 25,
) -> dict:
    """Fetch trending GitHub repositories by recent star activity.

    Args:
        fetcher: Shared HTTP fetcher.
        language: Optional language filter (e.g., "python", "rust").
        since_days: Look back period in days (default 7).
        limit: Number of repos to return (max 50).

    Returns:
        Dict with repos[], count, source, timestamp.
    """
    limit = min(limit, 50)
    since_date = (datetime.now(timezone.utc) - timedelta(days=since_days)).strftime("%Y-%m-%d")

    query = f"created:>{since_date} stars:>10"
    if language:
        query += f" language:{language}"

    data = await fetcher.get_json(
        _GH_SEARCH_URL,
        source="github",
        cache_key=f"github:trending:{language or 'all'}:{since_days}",
        cache_ttl=600,
        params={
            "q": query,
            "sort": "stars",
            "order": "desc",
            "per_page": str(limit),
        },
        headers={"Accept": "application/vnd.github.v3+json"},
    )

    if data is None or not isinstance(data, dict):
        return {"repos": [], "count": 0, "source": "github", "timestamp": _utc_now_iso()}

    repos = []
    for item in data.get("items", [])[:limit]:
        repos.append({
            "name": item.get("full_name"),
            "description": (item.get("description") or "")[:200],
            "url": item.get("html_url"),
            "stars": item.get("stargazers_count", 0),
            "forks": item.get("forks_count", 0),
            "language": item.get("language"),
            "created_at": item.get("created_at"),
            "topics": item.get("topics", [])[:5],
        })

    return {
        "repos": repos,
        "count": len(repos),
        "total_matching": data.get("total_count", 0),
        "query": query,
        "source": "github",
        "timestamp": _utc_now_iso(),
    }