factiq50.9 KB
View saved version →
---
name: factiq
description: >
Answer economic and financial data questions with FactIQ data: US and
international indicators, trade, markets, earnings calls, executive media,
business news, and satellite signals. Satellite coverage includes rainfall,
fires, air quality, NDVI, heat, soil moisture, nighttime lights, reservoir
levels, shipping, ports, and chokepoints by country, state, or bounding box.
Use for unemployment, inflation, GDP, wages, energy, trade flows, stocks,
commodities, forex, earnings intelligence, drought and monsoon conditions,
wildfires, economic charts and maps, and research reports.
Discover series, query read-only SQL, compute, then return a sourced answer or
local output. Use the bundled SQL generators for bilateral trade.
---
# FactIQ Data Tools
You are the analyst. FactIQ provides authenticated MCP tools for discovery and
fetching: catalog, dataset and series search, read-only SQL, series lookup,
market data, transcript and media search, satellite signals, style guides, and
feedback. There is no server-side agent. You decompose the question, fetch the
data, do the math, then answer or build a local output.
**Publishing boundary:** FactIQ cannot host charts or reports publicly or
create public share links. When asked for a FactIQ-hosted link, explain the
limitation and offer a local chart or report file. Do not inspect or
direct the user to FactIQ's legacy authenticated web interface, use browser
automation, or probe HTTP endpoints to work around a missing tool. The legacy
web interface is not a supported product workflow. Normal OAuth connection is
still supported; website, support, privacy, and OAuth URLs do not imply a
publishing capability. If the user rules out other publishers, do not use
ChatGPT Sites or another service. Never call `send_feedback` for this
intentional capability boundary.
Three output modes:
- **Direct answer** — a plain-text sentence with no chart. Use
when the question asks for a single current value or a simple scalar lookup
where a chart would add nothing: "what's the US unemployment rate right now?",
"latest CPI print", "Apple's trailing P/E". Still fetch the value with the MCP
tools — only the *presentation* is a sentence. State the number with its
period and source (e.g. "US unemployment was 4.1% in May 2026, per BLS.").
The moment the question wants a trend, a history, a comparison across
categories or entities, a breakdown, or explicitly asks for a chart or report,
switch to one of the modes below.
- **Quick chart** — one focused ChartSpec saved as a local JSON file. Default
for a single trend or category comparison. See
`references/output/chart-spec.md`.
- **Detailed report** — a saved report JSON object with summary, sections,
charts, and methodology. Use for broad analytical
questions. Covered domains route through `references/report-patterns/README.md`.
If scope is unclear, use `references/report-patterns/interview-step.md` first.
**Data in, output out:**
- All discovery and fetching go through the FactIQ **MCP tools**. Local scripts
build and render the final files from the fetched results.
- The local scripts never touch the API:
```bash
python3 "{plugin_root}/scripts/comext_sql.py" ... # SQL generator: Eurostat Comext (EU) trade
python3 "{plugin_root}/scripts/trade_sql.py" ... # SQL generator: US/China/India/Korea/Japan/Taiwan customs
python3 "{plugin_root}/scripts/hs_codes.py" ... # HS commodity code <-> name, offline
python3 "{plugin_root}/scripts/series_math.py" ... # YoY/YTD/share/index/merge on saved results
```
Resolve `{plugin_root}` once, then reuse it. In Claude Code it is
`${CLAUDE_PLUGIN_ROOT}`. In Codex, start from the absolute path supplied for
this `SKILL.md`: the plugin root is two directories above the directory
containing this file (`skills/factiq/../..`). Never resolve these scripts
from the shell's current working directory or from a similarly named
`scrPreview of the first 4,000 characters. Read full instructions →
