convez.ai
ComandoFinanceiroIntermediário
jawdat6

InvoicePilot

jawdat6/invoicepilot

Baixe todas as faturas SaaS com um comando natural

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin para Claude Code que baixa faturas de múltiplos serviços SaaS (AWS, Stripe, Google Cloud, Zoho Books e outros) com um único comando em linguagem natural. Funciona localmente com credenciais existentes, sem servidores ou contas adicionais.

Instalação

$npx convez-ai jawdat6/invoicepilot

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consolidar faturas de múltiplos provedores em um só lugar
  • Automatizar download mensal de invoices para auditoria financeira
  • Integrar coleta de faturas em workflows de contabilidade

Veredito

Ferramenta prática e bem arquitetada para quem gerencia múltiplas subscrições SaaS. Suporte a 8 plataformas principais (AWS, Stripe, MongoDB, etc) e arquitetura extensível via connectors customizados. Setup local elimina riscos de segurança, mas requer configuração manual de credenciais.

README

A tradução para o português deste README ainda está na fila.

InvoicePilot

Download all your SaaS invoices with one command.

InvoicePilot is a Claude Code plugin that downloads invoices from every connected SaaS service using natural language. No servers, no accounts — just a local config file and your existing API credentials.

Supported Services

ServiceMethod
AWSCost Explorer API
TwilioUsage Records API
MongoDB AtlasAtlas API v2
Zoho BooksOAuth2 (auto token refresh)
GoDaddyOrders API
Google CloudCloud Billing API + ADC
StripeInvoices API
OpenPhoneBrowser automation (⚠ unstable)

Installation

Option A: Claude Plugin Marketplace

claude plugin install invoicepilot

Option B: Manual (git clone)

git clone https://github.com/invoicepilot/invoicepilot ~/.claude/plugins/invoicepilot

Setup (both options):

# Create config file
invoicepilot init

# Edit credentials for the services you use
nano ~/.invoicepilot/config.yml

# Install Python dependencies
cd ~/.claude/plugins/invoicepilot
pip install -r requirements.txt

# (OpenPhone only) Install Playwright browser
playwright install chromium

Usage

Open Claude Code and use natural language:

"download all invoices for last month"
"get invoices from April 2024 to now"
"check which services are connected"
"download only AWS and Stripe for Q1 2025"

Example Output

InvoicePilot — Downloading March 2025

  ✓ AWS              3 invoices   → ~/Downloads/Invoices/2025-03/AWS/
  ✓ Twilio           1 invoice    → ~/Downloads/Invoices/2025-03/Twilio/
  ✓ MongoDB          1 invoice    → ~/Downloads/Invoices/2025-03/MongoDB/
  ✓ Zoho             4 invoices   → ~/Downloads/Invoices/2025-03/Zoho/
  ✓ GoDaddy          2 invoices   → ~/Downloads/Invoices/2025-03/GoDaddy/
  ✗ Google Cloud     Auth expired → Run: gcloud auth application-default login
  ✓ Stripe           1 invoice    → ~/Downloads/Invoices/2025-03/Stripe/
  ✓ OpenPhone ⚠      1 invoice    → ~/Downloads/Invoices/2025-03/OpenPhone/

  13 invoices downloaded. 1 skipped (already exists). 1 service needs attention.
  Folder: ~/Downloads/Invoices/2025-03/

Config File

Config lives at ~/.invoicepilot/config.yml (permissions: 600). Run invoicepilot init to generate the template.

Never commit this file — it contains credentials.

Adding Connectors

Extend BaseConnector in tools/connectors/:

from .base import BaseConnector, ConnectorResult

class MyServiceConnector(BaseConnector):
    name = "MyService"
    stable = True

    def is_configured(self) -> bool:
        return self._is_set("api_key")

    def download(self, start, end, out_dir):
        # fetch + save invoices
        return ConnectorResult(connector=self.name, ...)

Then add your connector class to tools/connectors/__init__.py.

License

MIT

Ver o original no GitHub

Bom para

Relacionados