gdelt_news (GDELT headlines)

When to use

• Fast, free headline scan for an entity/topic.
• Background news context to seed further research (then escalate to grok_search only if needed).

Parameters

• query (string, optional): Search query. If omitted/blank, defaults to a broad breaking-news query.
  • Special-case: "ai" expands to "artificial intelligence".
  • Too-short queries (<3 chars) error (except "ai").
• limit (int, optional, 1–50): Default 20.

Examples

{ "name": "gdelt_news", "params": { "query": "tesla", "limit": 10 } }

Blank query (broad scan):

{ "name": "gdelt_news", "params": { "limit": 20 } }

Output

• Returns: { query: string, items: Array<{title,url,source,publishedAt}>, cached: boolean, meta: { cached, shared, durationMs, timeoutMs } }
• Rendered:
  • Query (text)
  • Meta (text: cached/shared/durationMs/timeoutMs)
  • Headlines (table: publishedAt/source/title/url)

Reliability notes

• Provider layer includes:
  • Shared in-flight dedupe (shared=true when you joined an ongoing identical request)
  • Cache TTL ~30s
  • Global gate ~1 request per ~5.2s (GDELT-friendly)
  • Timeout defaults to 15s