Agent skill · Backend & API

gdelt

Global multilingual news event stream with tone scoring via GDELT 2.0 Doc API.

kansoku-tradegithub.com/kansoku-tradeGitHub ↗
claude-codeships scriptsNOASSERTION
Install
npx skills add kansoku-trade/kansoku --skill gdelt --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 4 KB
Bundled scripts: yes
Path: .claude/skills/gdelt/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 272
Language: TypeScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# gdelt > Response language: match user input. > ⚠️ **GDELT is a rolling recent-window API**, not a historical event archive. > Time windows are anchored to absolute timestamps (UTC) for reproducibility — > the same query asked tomorrow will return different results. > > ⚠️ **5-second throttle** between requests (enforced). Plan batches accordingly. ## When to use Trigger phrases: - 全球新闻 / 全球事件 / 多语种新闻 - 媒体 tone / sentiment trend / 国际关系 - geopolitical / event tone - GDELT Useful for "what is the world saying about X right now" — i.e. retrieving articles from non-English / non-financial sources that don't surface in Longbridge's curated newsfeed. ## Workflow 1. Build a query in GDELT DSL (the user's term, optionally with operators like `domain:bloomberg.com`, `sourcelang:eng`). 2. Pick a mode: - `artlist` — list of articles (default). - `timelinetone` — per-15-min tone time series (-10 = very negative, +10 = very positive). - `timelinevol` / `timelinevolinfo` — article volume over time. - `tonechart` — tone histogram. 3. Specify the window — prefer `--start`/`--end` (absolute), fall back to `--timespan`. The script converts relative timespans to absolute timestamps before the call a

What's inside
Steps it walks through
  1. When to use
  2. Workflow
  3. CLI examples
  4. Output shape (artlist)
  5. Output shape (timelinetone)
  6. Error handling
  7. Known limitations
  8. Related skills
Ships with 1 file
  • scripts/doc.py
Commands it runs
Articles about Nvidia in the last 24h
python3 .claude/skills/gdelt/scripts/doc.py "Nvidia"
python3 .claude/skills/gdelt/scripts/doc.py "TSMC OR \"Taiwan Semiconductor\"" --timespan 7d --lang eng,zho
Tone timeline for Federal Reserve over 30 days
python3 .claude/skills/gdelt/scripts/doc.py "Federal Reserve" --mode timelinetone --timespan 30d
Absolute window
python3 .claude/skills/gdelt/scripts/doc.py "AI chips" --start 20260501000000 --end 20260528000000
More from kansoku
All skills →
About this skill
What does the gdelt skill do?

Global multilingual news event stream with tone scoring via GDELT 2.0 Doc API.

How do I install it?

Run `npx skills add kansoku-trade/kansoku --skill gdelt --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From kansoku-trade/kansoku, a repository with 272 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going