雪球ポートフォリオ解析ツール（xueqiu_cube_analyst）
概要
雪球（Xueqiu）上の「组合」（ポートフォリオ）データをスクレイピング／取得して、各種パフォーマンス指標を自動計算・集計するPython製ツールです。日次の騰落比率から月次・年次のランキング作成、最大ドローダウンやボラティリティなどのリスク指標算出、そしてExcel形式でのまとめレポート出力をサポート。対話的な分析とバッチ処理の両モードを備え、パフォーマンスの良し悪しで自動的に組み合わせをフィルタリングする機能もあります。導入は依存パッケージのインストールとconfig.pyへのcookie設定が必要です。
リポジトリの統計情報
- スター数: 5
- フォーク数: 2
- ウォッチャー数: 5
- コミット数: 6
- ファイル数: 8
- メインの言語: Python
主な特徴
- 雪球のポートフォリオ履歴データを自動取得して時系列データを構築
- 日次リターン、月次集計、年次ランキングなどの自動算出
- 最大ドローダウン・ボラティリティなどのリスク指標を計算
- Excel形式での集計レポート生成と、パフォーマンスに応じた自動フィルタリング
技術的なポイント
本プロジェクトはシンプルな構成で、主にrequests系によるHTTPアクセス（cookieを用いたログイン済みセッション）と、pandas/Numpyを用いた時系列解析が中核と推定されます。config.pyにcookieを設定する方式は手軽ですが、長期運用ではcookieの有効期限や安全な管理（環境変数やキーチェーン利用）に注意が必要です。データ取得は雪球のWeb APIやページをスクレイピングして履歴価格・保有比率を取得し、日次の騰落率から累積リターン、移動平均、リスク指標（最大ドローダウン、年化ボラティリティなど）を算出します。月次・年次のランキングは、複数ポートフォリオの同期間比較と順位付けを自動化しており、Excel出力にはopenpyxlやxlsxwriterといったライブラリを用いる想定です。バッチ処理対応により複数組合せを一括解析でき、フィルタリング機能は閾値（例：一定期間内の最大ドローダウンや負の累積リターン）に基づいて低パフォーマンスの組合せを除外します。拡張ポイントとしては、API呼び出しのレート制御・再試行処理、非同期取得によるスループット改善、認証をcookieからOAuthや公式APIキーへ移行すること、テスト・CI導入やデータキャッシュの実装などが考えられます。
プロジェクトの構成
主要なファイルとディレクトリ：
- .gitignore: file
- LICENSE: file
- README.md: file
- analyst.py: file
- config.py: file
…他 3 ファイル
（注）config.pyに雪球サイトのログイン後cookieを直接書き込む方式のため、公開リポジトリでの取り扱いには注意が必要です。安全に運用するなら環境変数やローカルの秘密管理を推奨します。
まとめ
雪球のポートフォリオ分析を手早く自動化できる実用的なPythonツールです。
リポジトリ情報：
- 名前: xueqiu_cube_analyst
- 説明: This is a tool for analyzing Snowball portfolio data. It can retrieve portfolio historical data and perform various indicator analyses, supporting automatic analysis of annual and monthly rankings as well as summary report generation.
- スター数: 5
- 言語: Python
- URL: https://github.com/thinhunan/xueqiu_cube_analyst
- オーナー: thinhunan
- アバター: https://avatars.githubusercontent.com/u/672208?v=4
READMEの抜粋：
雪球组合数据分析工具
这是一个用于分析雪球组合数据的工具，可以获取组合历史数据并进行各种指标分析，支持年榜、月榜自动分析和汇总报表生成。
- 使用前请先在config.py中设置你的雪球网站登录后的cookie值(方法请自行google)
- 有什么想法请提交Issues，我来帮你实现
功能特性
- 自动获取雪球组合历史数据
- 计算每日涨跌比例
- 生成月度分析报表
- 计算回撤、波动率等风险指标
- 支持交互式和批量分析模式
- 年收益榜单自动分析
- 月收益榜单自动分析
- 智能组合过滤（自动跳过表现不佳的组合）
- 汇总报表生成（Excel格式，包含多维度因子分析）
安装依赖
pip install -r requirements.txt建议使用清华镜像源：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsingh...