Integração entre Claude AI e planilhas Excel usando a API da Anthropic.
- Analisar planilhas — envia dados de uma aba Excel ao Claude com um prompt personalizado
- Extração estruturada — obtém respostas em JSON conforme um esquema definido
- Processar linhas — envia cada linha individualmente ao Claude e salva as respostas na planilha
- Gerar relatórios — pede ao Claude que crie tabelas completas e as salva em Excel com formatação
pip install -r requirements.txtexport ANTHROPIC_API_KEY="sk-ant-..."from claude_excel_integration import ClaudeExcelIntegration
integration = ClaudeExcelIntegration()
# Analisar uma planilha existente
resposta = integration.analyze_sheet(
filepath="vendas.xlsx",
prompt="Quais são os 3 produtos com maior faturamento?",
system="Você é um analista de dados especialista em varejo.",
)
print(resposta)
# Processar cada linha e salvar resultado
resultados = integration.process_rows(
filepath="clientes.xlsx",
row_prompt_template="Classifique o cliente {Nome} com score {Score} como VIP, Regular ou Inativo.",
output_column="classificacao",
)
integration.save_results(resultados, "clientes_classificados.xlsx")
# Gerar relatório Excel com Claude
integration.generate_report(
prompt="Crie um relatório de resumo mensal de vendas com totais e médias.",
output_path="relatorio.xlsx",
context_file="vendas.xlsx",
)Execute example.py para ver os quatro demos em ação:
python example.py| Parâmetro | Padrão | Descrição |
|---|---|---|
api_key |
ANTHROPIC_API_KEY |
Chave da API Anthropic |
model |
claude-opus-4-6 |
Modelo Claude a usar |
| Método | Descrição |
|---|---|
read_sheet(filepath, sheet_name) |
Lê aba Excel → lista de dicts |
sheet_to_markdown(filepath, sheet_name) |
Converte aba em tabela Markdown |
analyze_sheet(filepath, prompt, ...) |
Analisa planilha com Claude |
analyze_sheet_structured(filepath, prompt, json_schema, ...) |
Retorna JSON estruturado |
process_rows(filepath, row_prompt_template, ...) |
Processa cada linha com Claude |
save_results(data, output_path, ...) |
Salva lista de dicts em Excel |
append_results_to_sheet(source, results, ...) |
Adiciona coluna de respostas no Excel original |
generate_report(prompt, output_path, ...) |
Gera relatório Excel via Claude |