| # AI投資インサイト・アナライザー (AII_HFace) プロジェクト仕様書 | |
| ## 1. プロジェクト概要 | |
| 「AI投資インサイト・アナライザー」は、最新の経済・金融ニュースを自動収集し、Googleの「Gemini 2.5 Flash」を活用して多角的な投資分析を提供するWebアプリケーションです。 | |
| 以前のローカル実行型スクリプトをWebアプリ化し、Hugging Face Spacesで公開することで、環境構築不要で誰でも利用可能にすることを目的としています。 | |
| ## 2. 主な機能 | |
| ### 2.1 ニュース収集 (News Collector) | |
| - **ソース**: NHKビジネス、日経新聞(主要)、ITmedia(経済)、はてなブックマーク(経済)からRSSを取得。 | |
| - **注目度ソート**: はてなブックマークAPIを利用し、ブックマーク数（世間の注目度）が高い順に記事を並び替え。 | |
| - **重複排除**: タイトルによる重複チェックを行い、ユニークな記事のみを抽出。 | |
| ### 2.2 AI分析 (AI Analyst) | |
| - **エンジン**: Google Gemini 2.5 Flash (最新モデル) | |
| - **分析項目**: | |
| - **歴史的類似性**: 過去の似た事例とその後の市場の動きを提示。 | |
| - **弱気視点/リスク**: 好材料であってもあえて警戒すべき点、悪材料の深掘り。 | |
| - **影響セクター**: 恩恵または打撃を受ける具体的な業界や企業コード。 | |
| - **市場影響度スコア**: -10から+10までの21段階で定量評価。 | |
| ### 2.3 ユーザーインターフェース (Web UI) | |
| - **Gradio**: PythonベースのUIフレームワークを採用。 | |
| - **サイドバー設定**: ユーザーが自身のGemini APIキーを入力して実行するプライバシー配慮型設計。 | |
| - **リアルタイム解析ログ**: 解析の進捗をテキストボックスに順次表示。 | |
| ## 3. 技術スタック | |
| | カテゴリ | 技術・ライブラリ | | |
| | :--- | :--- | | |
| | 言語 | Python 3.10+ | | |
| | UIフレームワーク | Gradio | | |
| | AIモデル | Google Gemini 2.5 Flash (`google-genai` SDK) | | |
| | データ取得 | `feedparser`, `requests` | | |
| | ホスティング | Hugging Face Spaces | | |
| ## 4. システム構成図 | |
| ```mermaid | |
| graph TD | |
| User([ユーザー]) -- APIキー入力 --> UI[Gradio Web UI] | |
| UI -- 実行リクエスト --> NC[News Collector] | |
| NC -- RSS取得 --> News[(ニュースソース)] | |
| NC -- はてブ数取得 --> HB[Hatena Bookmark API] | |
| NC -- ソート済み記事 --> AA[AI Analyst] | |
| AA -- プロンプト送信 --> Gemini[Gemini 2.5 Flash API] | |
| Gemini -- 分析結果(JSON) --> AA | |
| AA -- レポート生成 --> UI | |
| UI -- 最終表示 --> User | |
| ``` | |
| ## 5. 公開・運用 | |
| - **公開プラットフォーム**: Hugging Face Spaces | |
| - **運用形態**: ユーザーによるオンデマンド実行。サーバー側での定時実行や通知機能は持たせず、軽量な運用を実現。 | |
| - **ソースコード**: 透過性を重視し、ユーザーがローカルでも実行できるよう、ソースコード一式を公開。 | |