convez.ai
SkillFinanceiroIntermediário
defog-ai

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 GitHub
InicialPluginScore · de 0 a 100

Claude 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-plugin

1 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

Estrelas
20
Forks
1
Acompanhando
0
Saúde
25%
Último commit
há 1 dia
Versão
—
Issues abertas
4
Contribuidores
2

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:

CommandPurpose
/factiq:set-keyStore your FactIQ API key (guides you through getting one)
/factiq:statusCheck 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

  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.

Ver o original no GitHub

Bom para

Relacionados