Documentation Index
Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt
Use this file to discover all available pages before exploring further.
When to use
Whenever the user asks for a brief, an analytical write-up, a memo, a “what should I know about X” report, or a synthesis across multiple surfaces.
For lookups, schema help, extraction, comparison, or procedural tasks: use the smallest clear shape (a sentence, a list, a table) instead of forcing this template.
Structure (BLUF / inverted pyramid)
🧭 Bottom Line
⚡ So What
👀 Watch Next
📊 Evidence and Signal
🔎 Details
| Section | Content |
|---|
| 🧭 Bottom Line | 2–4 bullets. Each states judgment, magnitude, duration, confidence. Lead with the most consequential claim. |
| ⚡ So What | Practical implications. Tailor to the audience (founder, investor, policymaker). |
| 👀 Watch Next | Leading indicators or decision triggers. Specific, observable, timed. |
| 📊 Evidence and Signal | Returned data supporting the judgment. Lead with structured GDELT Cloud findings. |
| 🔎 Details | Caveats, sourcing limits, alternative interpretations, counter-signals. |
Lead Evidence with structured GDELT findings
| Date | Story title (linked to gdeltcloud.com) | Significance | Magnitude | Why it matters |
|---|---|---|---|---|
public_url, and web research only as enrichment.
Citation templates
| Surface | Template |
|---|
| GDELT Cloud Story | [Story title](https://gdeltcloud.com/stories/<slug>) |
| GDELT Cloud Entity | [Entity name](https://gdeltcloud.com/entities/<slug>) |
| Source article | [Domain — Title](article URL) from top_articles or get_story_articles |
| Macro-finance | <symbol> <metric> <value>, <date> (Alpha Vantage) |
| Prediction market | [Market title](public_url) |
| Web research | [Source — Title](URL) |
Highlighting individual events
When 1–3 specific incidents anchor the analysis, render them as fenced gdelt-event blocks so the Agent UI can show inline cards:
```gdelt-event
type: cameoplus
domain: TECHNOLOGY
event_type: SPACE OR SATELLITE EVENT
description: Iran allegedly used Chinese spy satellite to target US bases
country: —
date: 2026-04-15
actors: [Iran (IRGC), China (Earth Eye Co)]
magnitude: 2
goldstein: 0
market: 0.15
systemic: 0.55
fatalities: 0
url: https://gdeltcloud.com/stories/iran-allegedly-used-chinese-spy-satellite-to-target-us-bas-4917ab01
```
Window disclosure
Always state the time window queried and the surfaces used:
Window queried: 2026-04-06 to 2026-05-06 (30 days). GDELT Cloud first; web research used for institutional context and corroboration.
Confidence calibration
| Level | Criteria |
|---|
| High | Multiple independent sources, structured data corroborates narrative, no major gaps. |
| Moderate | Single primary source with corroborating context, or structured data with narrative gaps. |
| Low | Single source, contested claims, no structured data backing the claim. |
Formatting rules
- Emojis only in section headers and very sparse labels — never one per bullet.
- Compact tables over long paragraphs.
- Source links as readable Markdown labels:
[Reuters](https://...), not bare URLs.
- Don’t end the brief by asking if the user wants a follow-up. If you don’t have enough to answer, say so up front and pose a single specific clarifying question.
