Search V³ News for tracked geopolitical events.
Use when the user asks what is happening on a topic, in a country,
or in a domain (e.g. security, energy, finance, technology). Returns
a ranked list of events with why-it-matters, risk/impact/signal
scores, and a v3.news link for each.
Args:
query: free-text topic (e.g. "Iran sanctions", "Taiwan"). Optional.
country: ISO-3166 alpha-2 code to filter by (e.g. "US", "CN"). Optional.
category: V³ category slug — one of geopolitics, security_risk,
energy_resources, finance, markets, macroeconomics,
public_finance, trade_supply, technology, science_biosecurity,
environment_climate, business. Optional.
limit: max results, 1-20 (default 10).
輸入參數limitquerycountrycategory
Get a single V³ event: headline, why-it-matters, scores, and how
much structured analysis V³ holds on it (perspectives, decisions,
outcomes).
Use after v3_search_events (or v3_breaking_now) when the user wants
detail on a specific event. This returns V³'s public summary; the
full country-by-country perspectives, timeline, decisions to watch,
and assessed outcomes are on v3.news at the returned url (a V³
account unlocks the multi-perspective analysis).
Args:
event_id: the V³ event id from a prior tool result.
輸入參數event_id必填
Search V³ News for tracked geopolitical events matching a query.
Returns a list of matching events, each with an id (for ``fetch``) and
a v3.news citation url. V³ covers 12 categories (geopolitics, security,
energy, finance, markets, macro, trade, technology, science, climate,
business, public finance) with multi-perspective, cited analysis.
Args:
query: free-text topic, country, or question (e.g. "Iran sanctions").
輸入參數query必填
Fetch the full text of a single V³ event by id (from ``search``).
Returns V³'s public report (headline, why-it-matters, the full
long-form report when V³ has authored one, risk/impact/signal scores,
coverage depth) plus the canonical v3.news url for citation. The
country-by-country perspectives, timeline, decisions and assessed
outcomes live at that url.
Args:
id: the V³ event id returned by ``search``.
輸入參數id必填
Get V³'s latest global intelligence brief — the chief-of-staff
top line on what matters in the world right now, with per-category
state and counts.
Use when the user asks for a world summary, "what's happening
today", or a geopolitical situation overview.
無需輸入參數。
Get events V³ is currently tracking in BREAKING tempo — fast-
moving stories under near-real-time monitoring right now.
Use when the user asks "what's breaking", "any breaking news", or
about a developing situation. Returns an empty list when nothing is
in breaking tempo (a quiet news moment), which is itself a signal.
無需輸入參數。
Get V³'s Global Pulse — the world's current risk/impact/signal
reading and how it has moved over a recent window.
Use when the user asks how tense/volatile the world is right now,
whether global risk is rising or falling, or wants a one-number
situational read rather than a specific event. Scores are 0-100
aggregates across everything V³ tracks (risk = downside pressure,
impact = consequence, signal = momentum, priority = attention
weight).
Args:
window_days: trailing window for the trend, 2-90 (default 14).
輸入參數window_days