mvanhorn/printing-press-library

Add GDELT global news intelligence CLI

Open

#1,184 opened on Jun 15, 2026

View on GitHub
 (1 comment) (0 reactions) (1 assignee)Go (371 forks)github user discovery
enhancementhelp wanted

Repository metrics

Stars
 (1,443 stars)
PR merge metrics
 (PR metrics pending)

Description

Goal

Add a Printing Press CLI for GDELT, focused on global news/event monitoring and entity/topic timelines.

Free source

  • GDELT 2.1 APIs.

Agent jobs

  • Track global coverage volume for a company, person, country, or topic.
  • Build timelines and sentiment/attention curves.
  • Find countries, outlets, and languages driving a story.
  • Provide news-intelligence context without relying on generic search snippets.

Proposed command shape

  • gdelt-pp-cli mentions "OpenAI" --days 7 --agent
  • gdelt-pp-cli timeline "AI regulation" --days 30 --agent
  • gdelt-pp-cli countries "semiconductors" --agent
  • gdelt-pp-cli sources "nvidia" --days 14 --agent
  • gdelt-pp-cli entities "topic" --agent

Non-goals

No paid news APIs, article scraping beyond linked public metadata, or claims that GDELT sentiment is ground truth.\n\n## Implementation path\n\nThis is a new CLI candidate, so do not hand-build it directly in this published library repo. Run it through the canonical Printing Press generation flow in cli-printing-press, keep manuscripts/proofs, then publish into this repo with the publish flow.\n\n## Acceptance criteria\n\n- Research notes explain the source/API/feed contract, rate limits, auth needs, and freshness behavior.\n- CLI exposes a small agent-native command set, not a raw endpoint dump.\n- --json / --agent output is stable and compact.\n- If the source benefits from history, add local SQLite sync plus since/diff commands.\n- Skill includes high-signal recipes and clear non-goals.\n- Dogfood proves at least three realistic agent workflows.

Contributor guide