factiq-claude-code-plugin
defog-ai/factiq-claude-code-plugin
Análise de dados econômicos e financeiros com gráficos compartilháveis
Ver no GitHubClaude Code skill for FactIQ: answer economic/financial data questions via the FactIQ tools API and publish shareable charts
Instalação
npx convez-ai defog-ai/factiq-claude-code-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisa de dados macroeconômicos e séries históricas
- Análise de dados de mercado financeiro e earnings calls
- Geração de relatórios e visualizações compartilháveis
- Queries SQL estruturadas em datasets econômicos
Veredito

Skill robusto e bem documentado para quem trabalha com análise financeira no Claude Code. Requer API key da FactIQ, mas a integração é clara e a segurança é pensada (chaves armazenadas localmente com permissões restritas).
README
A tradução para o português deste README ainda está na fila.
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:
| Command | Purpose |
|---|---|
/factiq:set-key | Store your FactIQ API key (guides you through getting one) |
/factiq:status | Check auth, plan, and monthly usage |
/factiq:ask <question> | Run a full analysis and get a shareable chart |
git clone git@github.com:defog-ai/factiq-claude-code-plugin.git ~/.claude/skills/factiq
The skill auto-invokes the same way; store your key with
python3 ~/.claude/skills/factiq/scripts/factiq.py set-key.
Get your API key
- Sign in at factiq.com and open Settings → Security.
- In the API key section, click Generate API key (or Regenerate if one already exists — this revokes the old key).
- 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 commandsscripts/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.