project_specification.md

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. システム構成図

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
• 運用形態: ユーザーによるオンデマンド実行。サーバー側での定時実行や通知機能は持たせず、軽量な運用を実現。
• ソースコード: 透過性を重視し、ユーザーがローカルでも実行できるよう、ソースコード一式を公開。