feat: support gemini api

Author: zerob13

Cargo.lock

@@ -13,6 +13,7 @@ clap = { version = "4.0", features = ["derive"] }
 async-trait = "0.1"
 chrono = { version = "0.4", features = ["serde"] }
 toml = "0.8"
+scraper = "0.20"
 
 [dev-dependencies]
 tokio-test = "0.4"

Cargo.toml

@@ -18,6 +18,7 @@ Access the latest AI model information in JSON format:
 - **All Providers Combined**: [all.json](dist/all.json) - Complete aggregated data from all providers
 - **PPInfra**: [ppinfra.json](dist/ppinfra.json) - PPInfra provider models
 - **OpenRouter**: [openrouter.json](dist/openrouter.json) - OpenRouter provider models
+- **Google Gemini**: [gemini.json](dist/gemini.json) - Google Gemini API models with web-scraped details
 
 ## 📦 Installation
 
@@ -135,17 +136,68 @@ rate_limit = 5
 
 [openai]
 api_url = "https://api.openai.com/v1/models" 
-api_key_env = "OPENAI_API_KEY"
+api_key_env = "OPENAI_API_KEY"  # OpenAI requires API key
 rate_limit = 20
 ```
 
-### Environment Variables
-If providers require API keys, set corresponding environment variables:
+### API Key Configuration
+
+The tool supports flexible API key configuration with multiple methods and clear priority ordering:
+
+#### Configuration Methods
+
+**Method 1: Environment Variables (Recommended)**
 ```bash
-export OPENAI_API_KEY="your-key-here"
-export OPENROUTER_API_KEY="your-key-here"
+# Only for providers that require API keys
+export GEMINI_API_KEY="your-key-here"
+# export OPENAI_API_KEY="your-key-here"  # When OpenAI provider is added
+```
+
+**Method 2: Configuration File**
+```toml
+# config/providers.toml
+[providers.gemini]
+api_url = "https://generativelanguage.googleapis.com/v1beta/openai/models"
+# Option A: Use default environment variable
+api_key_env = "GEMINI_API_KEY"
+# Option B: Use custom environment variable name
+# api_key_env = "MY_CUSTOM_GEMINI_KEY" 
+# Option C: Direct API key (not recommended for production)
+# api_key = "your-gemini-key-here"
 ```
 
+#### API Key Priority (High to Low)
+
+1. **Direct API key in config file** (`api_key` field)
+2. **Environment variable specified in config** (`api_key_env` field)
+3. **Default environment variable** (e.g., `GEMINI_API_KEY`)
+
+This allows you to:
+- Use environment variables for security (recommended)
+- Override per-environment using config files
+- Mix different approaches for different providers
+
+#### Provider-Specific Notes
+
+- **PPInfra**: ✅ No API key required - uses public API
+- **OpenRouter**: ✅ No API key required - uses public model listing API  
+- **Gemini**: ⚠️ Optional API key - uses hybrid web scraping + API approach
+
+### Gemini Provider Details
+
+The Gemini provider implements a unique **hybrid approach**:
+
+**How It Works:**
+1. **API Call**: Fetches model list from Gemini API (model names only)
+2. **Web Scraping**: Scrapes Google's documentation for detailed capabilities
+3. **Data Merging**: Combines API data with scraped metadata
+
+**Behavior by API Key Status:**
+- **With API Key**: Complete model list from API + enriched capabilities from scraping
+- **Without API Key**: Model list and capabilities from web scraping + fallback known models
+
+**Why Hybrid?** The official Gemini API only provides model names, so web scraping is always required to get comprehensive capability information (vision, function calling, reasoning, context lengths, etc.).
+
 ## 🤖 GitHub Actions Automation
 
 The project includes GitHub Actions workflow with multiple trigger methods:
@@ -225,8 +277,8 @@ For detailed development guide, see [Architecture Documentation](docs/architectu
 
 - ✅ **PPInfra** - 38 models with reasoning, function calling, and vision capability detection
 - ✅ **OpenRouter** - 600+ models with comprehensive capability detection and metadata
-- 🚧 **OpenAI** - Planned  
-- 🚧 **Google Gemini** - Planned
+- ✅ **Google Gemini** - Gemini models with hybrid API + web scraping approach for complete metadata
+- 🚧 **OpenAI** - Planned
 
 ## 🛠️ Development
 

README.md

@@ -0,0 +1,35 @@
+# PublicProviderConf Configuration File
+# This file allows you to customize provider settings and API keys
+
+[providers.ppinfra]
+api_url = "https://api.ppinfra.com/openai/v1/models"
+# PPInfra doesn't require an API key
+rate_limit = 10
+timeout = 30
+
+[providers.openrouter]
+api_url = "https://openrouter.ai/api/v1/models"
+# OpenRouter provides public model listing API - no API key required
+rate_limit = 5
+timeout = 30
+
+[providers.gemini]
+api_url = "https://generativelanguage.googleapis.com/v1beta/openai/models"
+# Option 1: Use environment variable (recommended for security)
+api_key_env = "GEMINI_API_KEY"
+# Option 2: Direct API key (not recommended for production)
+# api_key = "your-gemini-key-here"
+# Option 3: Use custom environment variable name
+# api_key_env = "MY_CUSTOM_GEMINI_KEY"
+rate_limit = 10
+timeout = 60  # Web scraping might take longer
+
+# API Key Configuration Notes:
+# - PPInfra: Uses public API, no key required
+# - OpenRouter: Uses public model listing API, no key required  
+# - Gemini: Optional API key for complete model list
+#
+# API Key Priority (when applicable):
+# 1. Direct API key in config file (api_key)
+# 2. Environment variable specified in config (api_key_env)  
+# 3. Default environment variable (e.g., GEMINI_API_KEY)