tool-gdelt-news（工具 gdelt 新闻）

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