factiq

FactIQ Claude Code Plugin

A Claude Code plugin that lets Claude answer economic and financial data questions using FactIQ's data tools over HTTP — catalog search, read-only SQL, series lookup, market data, earnings-call search, and shareable chart publishing. Claude orchestrates the whole analysis itself; no codebase or database access is required, only a FactIQ account.

Install

Inside Claude Code:

/plugin marketplace add defog-ai/factiq-claude-code-plugin
/plugin install factiq@factiq

This adds the skill (Claude invokes it automatically for economic/financial data questions) plus three slash commands:

git clone [email protected]:defog-ai/factiq-claude-code-plugin.git ~/.claude/skills/factiq

Get your API key

1. Sign in at factiq.com and open Settings → Security.
2. In the API key section, click Generate API key (or Regenerate if one already exists — this revokes the old key).
3. Copy the fiq_... key immediately — it is shown only once and cannot be retrieved later (the server stores only a hash).

Then run /factiq:set-key in Claude Code and follow the instructions. The key is verified against the API and cached in ~/.factiq/config.json (chmod 600) — never stored in this folder. Alternatively, set the FACTIQ_API_KEY env var, which overrides the config.

Contents

• SKILL.md — the skill definition Claude loads (setup, workflow, limits)
• commands/ — the /factiq:* slash commands
• scripts/factiq.py — self-contained stdlib-only CLI for the FactIQ /tools/* API (Python 3.10+, no dependencies)
• references/ — SQL idioms, ChartSpec format, and dataset schema overview
• .claude-plugin/ — plugin + marketplace manifests

Configuration

The CLI targets https://api.worlddb.ai (API) and https://www.factiq.com (share links) by default. Override with FACTIQ_API_URL / FACTIQ_WEB_URL env vars or --base-url / --web-url flags — e.g. http://localhost:8000 and http://localhost:3000 for local development against the worlddb repos.

set-key remembers the URL it verified the key against in the config file. If that remembered URL later stops working (say, a local dev server that is no longer running), the next set-key run falls back to verifying against the default API and saves that instead — explicit --base-url / FACTIQ_API_URL overrides are always honored as given, with no fallback.

Security

No secrets belong in this repo. Auth uses per-user API keys (set-key prompts via getpass; FACTIQ_API_KEY env var also works); the key lives only in ~/.factiq/config.json. The backend stores keys hashed, and enforces a 1 request/second rate limit and a monthly tool-call quota per plan.